IntelliDoor

Revision as of 18:00, 14 April 2012 by imported>NelsonJenkins
IntelliDoor System
VendorImage5 - IntelliDoor Builder Kit.jpg

IntelliDoor Builder Kit, the full-permissions pack of all IntelliDoor products.
Creator Nelson Jenkins
Launch year 2009 (Garage)
2010 (Bollard / GSS)
2012 (Everything Else)
Company Gentek Technologies
Availability Marketplace & In-World
User Manual

The IntelliDoor system is a set of doors and other equipment primarily aimed at prefab builders. It uses notecard-based configuration and mesh construction where possible. While the consumer editions are no transfer, the Builder Kit includes all IntelliDoor products with transfer permissions, limited using Gentek's TOTS licensing system.


IntelliDoor Garage

Garage doors in Second Life used to either be one of two types:

  • Physical: the door would set itself physical and move upwards through anything in its way. This required extra space above the door.
  • Compression: the door would resize and move itself so it appears to be moving up. This didn't require extra space, but compressed the texture vertically and didn't look realistic.

The IntelliDoor Garage, originally just the IntelliDoor, is a unique garage door released in early 2009 that uses an advanced scripting method that solves both problems - it doesn't require extra space and it doesn't compress the texture.

Its design has not changed much from the original design, except for a texture refresh. It is just a simple box prim. However, its scripts were reduced dramatically - the original had 5 separate scripts to coordinate movement. With the advent of newer LSL functions, they could be consolidated into one.

Fun fact: the original IntelliDoor was created on New Years Eve in 2008, as Nelson had hoped to release it for the New Years Sale starting the next day. Unfortunately, it was stalled due to general laziness, and wasn't released until several months later.

Version 2 brought integration with the rest of the IntelliDoor series, which had just been released.

Setup

  1. Rez the door and resize it to the frame. Try not to change the thickness of the door.
  2. Rez a Button if you want one and position it. It can be retextured and resized if necessary, but we recommend leaving it as it is. You don't need a Button; clicking the door itself will operate it as well.
  3. If you want autoclose, we recommend rezzing the Sensor, then rotating it to the door. Resize it horizontally so that it spans with width of the entire frame, then resize it vertically so it goes up the door approximately halfway. (Note that clicking the Sensor is the same as clicking the door.) Again, you do not need a Sensor, but it makes the door much safer and avoids crushing cars.
  4. Open the _config notecard in the door, sensor, and button. For more information on the _config values, read the sections labeled "CONFIG VALUES". For now, change the door ID and make sure it is the same in all notecards.
  5. Test the door by clicking the up button (or if you don't have a controller, just the door itself). If you have autoclose enabled, stand under the door and see if it closes (it shouldn't for at least 60 seconds).

Autoclose

The IntelliDoor has an autoclose feature set up in the _config notecard of each door. To enable it, set the AUTOCLOSE value greater than 0 (we recommend at least 10). If you are using a Sensor, make sure it has the same door ID in its _config notecard.
When your door reaches the completely open position, it will wait the number of seconds in AUTOCLOSE, then automatically close. However, if there is something blocking the door, it will wait until the door becomes unobstructed (or 60 seconds after the last object entered the doorway) then close. If something enters the doorway while it is closing, it will re-open and wait again.

Door Config Values

  • ID: This is the door's identifier. Each door should have a separate ID. The ID can be any alphanumeric string (A-Z, 0-9, space). All IntelliDoor components are owner-only so don't worry about conflicting IDs from other people.
  • SPEED: This is the speed value. The door speed can be 1-9, 9 being the fastest. The default is 5. If you are experiencing slow operation due to lag (especially in homesteads), it might help to increase the speed.
  • TEXTURE: This is the door's texture. The IntelliDoor Garage comes with 6 built-in textures, which you can use by their keywords - "Residential", "Metal", "Rust1", "Rust2", "Windowed1", and "Windowed2". You can also use your texture two ways - either by copying the asset UUID in your inventory (right click -> Copy Asset UUID) and pasting it in this field, or by putting the texture itself in the door's inventory and the texture's name in this field.
  • ACCESS: This is the base access setting. If the door is locked (which it is by default), this group of people can always access it anyway by clicking on it. Can be "Everyone", "Group", or "Owner". (If you put "Group" here, the door's group will be able to click the door to use it, but they won't be able to use any buttons or controllers unless you also set them to "Group".)
  • UNLOCKABLE: This should be left as "Yes" unless, for some reason, you don't want this door to be unlocked at all (then change it to "No"). Doors can only be unlocked using an IntelliDoor Controller Add-On, sold separately. Unlocking a door allows anyone to use it by clicking on it - for example, if you wanted a keypad-operated door, anyone could enter the correct password then open the door manually (although it is also possible for the keypad to automatically open the door as well - see its user manual for more information).
  • AUTOCLOSE: If you don't want autoclose, leave this as 0. Otherwise, it is the number of seconds the door waits until closing automatically. For more info, read "AUTOCLOSE" above.
  • WHITELIST: The list of people that will always be able to click the door to operate it. This does not affect buttons and controllers. Separate with commas.
  • BLACKLIST: The list of people that will never be able to click the door to operate it. This does not affect buttons and controllers. Separate with commas.
  • GSS: If you are using a Global Security Server, enter its name in this field. The IntelliDoor GSS provides a "master" whitelist and blacklist for doors that subscribe to it (for example, if you have a group of doors that you want a list of people to control). NOTE ON GSS: Doors will only download data from the GSS when reset. You must reset all doors after changing the GSS's configuration.

NOTE ON NAMES: The IntelliDoor system v2.1 and above uses usernames (e.g. "nelson.jenkins" or "newusername") - NOT old-style names ("Nelson Jenkins" or "newusername Resident") and NOT display names ("Nelson the Magnificent" or "New User"). Separate values with commas (nelson.jenkins, newusername, etc.). Entries here are not case-sensitive.

Button Config Values

  • ID: Put the door IDs you want to control here. If you are only controlling one door, just put that door's ID. If you have more than one door you want to control at the same time, separate their IDs with commas.
  • ACCESS: This is the base access setting for this button only. This is the same as the door's access settings, except it affects the button only. (If you put "Group" here, the button's group will be able to use the button to use the door, but not the door directly by clicking it.)
  • WHITELIST: This is the same as the door's whitelist, but again, only affects the button.
  • BLACKLIST: This is the same as the door's blacklist, but again, only affects the button.
  • GSS: This is the same as the door's GSS name, but only affects the button.

Sensor Config Values

  • SHOW: Set this to "No" once you are done positioning the sensor. When set to "Yes", the sensor will be made visible and will show instructions on how to set it up.
  • ID: Put the door's ID here. Use only one sensor per door, and one door per sensor.

Updates & Release Notes

You can update your IntelliDoor Garage by rezzing the update box.

  • v2.1.2
    • Fixed separate textures sometimes overwriting each other
  • v2.1.1
    • Fixed integration with Keypad
  • v2.1
    • Allow separate textures on each side.
    • Changed old-style names to usernames.
    • Slight tweaks.
  • v2.0
    • Replaced and rewrote everything. It's better now. Trust me.
  • v1.3.4
    • Fixed API script.
  • v1.3.3
    • Added API script.
  • v1.3.2
    • Fixed "grey-out" bug.
    • Removed Legacy door.
    • Added touch menu.
    • Added retexturing system.
    • Added data validation for door settings.
    • Removed self-deleter.
  • v1.3.1
    • Attempted to fix "grey-out" bug.
  • v1.3
    • New, smoother movement driver.
    • Speed setting added.
    • Minor UI changes.
    • Updater moved to door (non-Legacy).
  • v1.2
    • Better sound driver.
  • v1.1
    • Added autoclose.
  • v1.0
    • Primary public release.

IntelliDoor GSS

The Global Security Server (GSS) is a tool used to coordinate security settings among many IntelliDoor products. While group control is easiest for limited access, in some cases it is not possible (autoreturn where the land group is not the group you want to allow, for instance). In this case, if you have many IntelliDoors, the GSS provides a single point where you can list people who should have access.


IntelliDoor Bollard

The IntelliDoor Bollard, originally the RamBlocker, is an electromechanical retractable bollard used for vehicle access control, similar to a gate but allows pedestrians through.


IntelliDoor Home & Commercial

As the first-ever mesh rotating doors, the IntelliDoor Home and IntelliDoor Commercial allow for incredible detail in only a single prim each. Previously, the only options for one-prim doors were the Tredpro Sculpted Doors or the A.E. Worx doors. Tredpro's doors were prone to resetting improperly and did not have any access control or customization. The A.E. Worx doors were not scripted at all.

The IntelliDoor Home & Commercial both use notecard configuration and Gentek's theme codes to allow for vast customization. They differ in that they use different models and some separate customization options, but are scripted mostly the same.

Setup

  1. Rez the door and position it into the frame. If need be, resize it.
  2. Open the _config notecard in the door. For more information on the _config values, read the sections labeled "CONFIG VALUES". For now, change the door ID.
  3. Test the door by clicking it. If you want the door to open the other way, go back into the _config notecard and change the Reversed setting.

WARNING: Do not link the door to anything. This will break it. (Two reasons: first, it will break the rotation and some other things, and second, it's mesh, so if you link it to a non-mesh linkset, it will cause the prims to go through the roof. This is a limitation of SL and there's simply no workaround, so it's better to leave it unlinked.)

Config Values

  • DoorID: This is the door's identifier. Each door (or set of synced doors) should have a separate ID. The ID can be any alphanumeric string (A-Z, 0-9, space). All IntelliDoor components are owner-only so don't worry about conflicting IDs from other people.
  • Access: This is the base access setting. If the door is locked, this group of people can always access it anyway by clicking on it. Can be "Everyone", "Group", or "Owner". (If you put "Group" here, the door's group will be able to click the door to use it, but they won't be able to use any controllers unless you also set them to "Group".) Lock must be "Yes" for this to do anything.
  • Reversed: Changes the direction of the door's swing.
  • Synced: This controls how far the door will send commands for synced doors.
    • If you only have a single door, leave this as Off.
    • If you have double doors, set this to Near. Make sure the Reversed setting is different in each door so they swing the same direction (assuming they are rotated opposite each other).
    • If you want two or more doors using the same DoorID to open and close at the same time that are over 10m away from each other, set this to Far (up to 96m) or Region (region-wide).
    • It's especially important to set this as restrictive as possible if you are including this in a prefab building that will be rezzed multiple times in the same area. This is because doors with the same DoorID within range will open and close simultaneously. For example, if the front doors to a series of prefabs are set to a sync range that allows them to communicate, they will all open at the same time, even though they are in separate copies of the building. It's also a good idea to give unique DoorID values in each prefab you sell to avoid these conflicts.
  • Lock: This should be left as "Yes" unless, for some reason, you don't want this door to be unlocked at all and would rather allow anyone to open it (then change it to "No"). Doors can only be unlocked using an IntelliDoor Controller Add-On, sold separately. Unlocking a door allows anyone to use it by clicking on it - for example, if you wanted a keypad-operated door, anyone could enter the correct password then open the door manually (although it is also possible for the keypad to automatically open the door as well - see its user manual for more information).
  • Autoclose: If you don't want autoclose, leave this as 0. Otherwise, it is the number of seconds the door waits until closing automatically.
  • Whitelist: The list of people that will always be able to click the door to operate it. This does not affect buttons and controllers. Separate with commas. NOTE ON NAMES: The IntelliDoor system v2.1 and above uses usernames (e.g. "nelson.jenkins" or "newusername") - NOT old-style names ("Nelson Jenkins" or "newusername Resident") and NOT display names ("Nelson the Magnificent" or "New User"). Separate values with commas (nelson.jenkins, newusername, etc.). Entries here are not case-sensitive.
  • Blacklist: The list of people that will never be able to click the door to operate it, unless it is unlocked. This does not affect controllers. Separate with commas.
  • GSS: If you are using a Global Security Server, enter its name in this field. The IntelliDoor GSS provides a "master" whitelist and blacklist for doors that subscribe to it (for example, if you have a group of doors that you want a list of people to control). NOTE ON GSS: Doors will only download data from the GSS when reset. You must reset all doors after changing the GSS's configuration.
  • Texture: These are texture codes. See IntelliDoor Texture Codes.
  • Sounds: These are UUIDs played when the door opens and closes. Note that the door close sound is played when the door finishes rotating. Two sets of sounds are provided in the notecard.
  • Doorknob: The type of doorknob used on the door. For the Home, this can be Knob or Handle. For the Commercial, this can be Pull, Handle, or Pushbar (and you can set it different on each side).

Resetting Doors

You can reset a door by editing it and going to Tools -> Reset Scripts in Selection. MAKE SURE the door is fully closed before resetting it.

Updates & Release Notes

You can update your IntelliDoor by rezzing the Update Box.

  • v2.1.1 (Commercial Only)
    • Added Handle from Home, renamed Commercial Handle to Pull.
  • v2.1
    • Primary public release.


IntelliDoor Keypad

Other than the security options in the door, the IntelliDoor has the Keypad to allow for access by anyone with a custom-set password. It can be from 1-5 characters, and the Keypad has various customization options beyond just the password. It is also mesh, sporting high detail for only a prim.

Builder Kit Instructions

ATTENTION USERS OF THE BUILDER KIT VERSIONS: THIS IS IMPORTANT, PLEASE READ
Your use of transfer-enabled products is bound by our Full Permissions Agreement. If you haven't read it, it's important you do so.
Most importantly, we keep track of who has purchased the Builder Kit. If someone has a transferable IntelliDoor but has not bought the Builder Kit, that door will not function, and their use of it will be recorded. If you are found to be giving out transferable IntelliDoors, you will be backtraced by the cyber police, and consequences will never be the same.
Therefore, make sure you set the door object to NO TRANSFER and the script inside it to NO TRANSFER before distributing it. Otherwise, you are risking both your license to use our products and your reputation with your customers, who will be left with prefabs that have their doors break when rezzed.