Difference between revisions of "IntelliDoor Bollard"

imported>NelsonJenkins
imported>NelsonJenkins
 
Line 2: Line 2:
  
 
==Setup==
 
==Setup==
# Rez the bollard and position it. If you are setting up a series of bollards, only rez one and set it up first. While the bollard is modify, do not unlink, resize, or edit the parts or it may not work. As of v3.1, you can link bollards to an object, as well as link multiple bollards together.
+
# Rez the bollard and position it. If you are setting up a series of bollards, only rez one and set it up first. While the bollard is modify, do not unlink, resize, or edit the parts or it may not work.
 
# Rez a Button if you want one and position it. It can be resized if necessary, but we recommend leaving it as it is. You don't need a Button; clicking the bollard itself will operate it as well (but only one at a time).
 
# Rez a Button if you want one and position it. It can be resized if necessary, but we recommend leaving it as it is. You don't need a Button; clicking the bollard itself will operate it as well (but only one at a time).
 
# Open the _config notecard in the bollard and button. For more information on the _config values, read the sections labeled "CONFIG VALUES". For now, change the bollard ID and make sure it is the same in all notecards.
 
# Open the _config notecard in the bollard and button. For more information on the _config values, read the sections labeled "CONFIG VALUES". For now, change the bollard ID and make sure it is the same in all notecards.
Line 58: Line 58:
 
* v3.1
 
* v3.1
 
** New button model
 
** New button model
** Bollard can now be linked to objects
 
 
** Nightlight won't turn on when bollard is lowered
 
** Nightlight won't turn on when bollard is lowered
 
* v3.0
 
* v3.0

Latest revision as of 14:44, 23 March 2016

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

Setup

  1. Rez the bollard and position it. If you are setting up a series of bollards, only rez one and set it up first. While the bollard is modify, do not unlink, resize, or edit the parts or it may not work.
  2. Rez a Button if you want one and position it. It can be resized if necessary, but we recommend leaving it as it is. You don't need a Button; clicking the bollard itself will operate it as well (but only one at a time).
  3. Open the _config notecard in the bollard and button. For more information on the _config values, read the sections labeled "CONFIG VALUES". For now, change the bollard ID and make sure it is the same in all notecards.
  4. If you are setting up a series of bollards, select the one you have configured, hold Shift, and drag the editing arrow in the direction you want. This will make a copy of the bollard. Repeat until you have enough. The _config notecards will all have the same values as the original one.
  5. Test the bollard by clicking the green "RAISE" button (or if you don't have a button, just the bollard). If you have autoraise enabled, stand directly on top of the bollard and see if it raises (it shouldn't).

Autoraise

The IntelliDoor Bollard has an autoraise feature set up in the _config notecard of each bollard. To enable it, set the AUTORAISE value greater than 0 (we recommend at least 10). A sensor is no longer required; the bollard will automatically perform a raycast to detect if anything is blocking its path.
When your bollard lowers, it will wait the number of seconds in AUTORASE, then automatically raise. However, if there is something blocking the bollard, it will wait until the path becomes unobstructed, then raise.

Bollard Config Values

  • ID: This is the bollard's identifier. Each bollard, or series of bollards operating simultaneously, should have a separate ID. The ID can be any alphanumeric string (A-Z, 0-9).
  • ACCESS: This is the base access setting. If the bollard is locked (which it is by default), these people can always access it anyway by clicking on it. Can be "Everyone", "Group", or "Owner". (If you put "Group" here, the bollard's group will be able to click the bollard to use it, but they won't be able to use any buttons or controllers unless you also set them to "Group".)
  • AUTORAISE: If you don't want autoraise, leave this as 0. Otherwise, it is the number of seconds the bollard waits until raising automatically. For more info, read "AUTORAISE" above.
  • WARNLIGHT: The color for the flashing LEDs when the bollard is raising. Select from the options in the notecard.
  • NIGHTLIGHT: An automatic area light during nighttime - set to "Yes" to enable, or leave as "No" to disable.
  • COLOR: The color for the bollard. Select from the options in the notecard.
  • BASE: The type of base - light or dark.
  • WHITELIST: The list of people that will always be able to click the bollard or sensor to operate it. This does not affect buttons and controllers. Separate with commas. NOTE: Whitelist names are usernames (nelson.jenkins, newbie), not legacy names (Nelson Jenkins, Newbie Resident). If you have more than 10 names, please read "Extended Whitelist" below.
  • 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 IntelliDoor components that subscribe to it (for example, if you have a group of bollards that you want a list of people to control).
  • AKS: This is for a future product. Ignore this field.
  • REMOTE: If you have an IntelliDoor Remote, you can put a password in this field. This is the remote password that you'll put in the remote to control this bollard. IMPORTANT: The IntelliDoor Remote is not owner-only. Anyone can access your bollard if they have this password - similarly, if you have the same password as another IntelliDoor component, even if it is owned by someone else, it will be controlled at the same time. We recommend simply generating a random password without special characters.

Extended Whitelist

Because of LSL limitations, the whitelist line can only be read for 255 characters. However, the IntelliDoor system supports multiple whitelist lines. To be safe, separate your whitelist into 10-name increments, like so:
WHITELIST=User01, User02, User03, User04, User05, User06, User07, User08, User09, User10
WHITELIST=User11, User12, User13, User14

You can have as many whitelist lines as you need.

Button Config Values

  • ID: Put the bollard IDs you want to control here. If you are only controlling one bollard or one group of bollards with the same ID, just put that bollard's ID. If you have more than one bollard/group 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 bollard, but not the bollard directly by clicking it.)
  • WHITELIST: This is the same as the bollard's whitelist, but again, only affects the button.
  • GSS: This is the same as the bollard's GSS name, but only affects the button.

Resetting Bollards

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

Builder Kit Instructions

Follow this guide before using your Builder Kit components, or they will break.

Make sure you review the Full Permissions Agreement to understand how you may distribute IntelliDoor products. Remember, objects in violation of this agreement will be remotely deleted. Therefore, make sure you follow the above instructions exactly.

API

As of v3.0, the IntelliDoor has an API for controlling individual doors and components. All API communication is done on channel -494827459.

For the following, [BBID] specifies the Buildbox ID. By default, this should be NONE. However, if your doors were rezzed as part of a building through a Buildbox, it will have been set. You can get the Buildbox ID by selecting a door and checking its description - it should read BBID followed by the ID, which is usually formatted as a 36-character UUID. You can also set up your API-enabled item in the building such that it accepts and stores the Buildbox ID when it is rezzed. Note that Buildbox IDs do not change once the object is rezzed.

The IntelliDoor Bollard accepts the following API commands:

  • [BBID][DoorID]&&open - Lowers (opens) the bollard.
  • [BBID][DoorID]&&close - Raises (closes) the bollard.

The IntelliDoor Bollard does not accept the &&lock and &&unlock commands.

Updates & Release Notes

You can update your IntelliDoor Bollard by rezzing the Update Box.

  • v3.1
    • New button model
    • Nightlight won't turn on when bollard is lowered
  • v3.0
    • Implemented Buildbox integration
    • Bollards now automatically reset when GSS is reset
    • Usernames in whitelist are no longer case-sensitive
    • Blacklist removed
    • Communications now streamlined onto single channel for less lag
    • API added
    • Bollard model entirely remade in mesh
    • Bollard now has alarm and flashing lights to warn surrounding pedestrians/vehicles
    • Bollard color and base texture can now be changed
    • Bollard movement redesigned and rescripted
    • Bollard has optional nightlight mode
    • Bollard Sensor removed and replaced with an automatic raycast
  • v2.1.2
    • Rewrote Keypad integration, which broke if bollard was configured in a certain way
  • v2.1
    • Changed access lists from old-style names to account names.
    • Lowered script count from 2 to 1.
    • Slight tweaks.
  • v2.0
    • Replaced and rewrote everything. Integrated into IntelliDoor series.
  • v1.1
    • Fixed group-only bug.
  • v1.0
    • Primary public release.