Salto EventStream
The Salto EventStream interface encrypts each event in a device. This is then provided as a data point. Devices can also be created manually.
Configuration on Salto Side
Antcas supports only the following event configuration:
- TCP/IP
- JSON format
- Defining a DoorExtID is mandatory
- EventDateTimeUTC is mandatory to recognize a telegram as valid
- Character encoding must be set to UTF-8
The outgoing port can be chosen according to the criteria of the valid ports. The default port is 3200. An interface is capable of handling multiple clients.
Unique IDs
Unique IDs are used for communication. These are passed by Salto as DoorExtID each time. If this has not been defined, the received data will not be forwarded to the PLC.
All new IDs automatically create a door in the installation.
Evaluation
To create a trigger, it can be created at the object event_id. Since the object changes with each reception, the evaluation can be implemented using the Function Block TRIG. If EventID was not defined, it is automatically generated.
Info: The interface synchronizes automatically with the slowest cycle of the associated PLC. The telegrams are buffered by the system so that no telegram is lost.
| Variable | JSON Data Point | Data Type |
|---|---|---|
| EventID | string | |
| OperationID | int | |
| OperationDescription | string | |
| UserCardID | string | |
| UserCardSerialNumber | string | |
| IsExit | bool | |
| UserType | int | |
| UserName | string | |
| UserGPF1 | string | |
| UserGPF2 | string | |
| UserGPF3 | string | |
| UserGPF4 | string | |
| UserGPF5 | string | |
| DoorName | string | |
| DoorGPF1 | string | |
| DoorGPF2 | string | |
| EventDateTimeUTC | datetime |
Values of usertype
| Value | Description |
|---|---|
| 0 | User card |
| 1 | Door |
| 2 | Software event |
Values of op_id
| Value | Description (English) |
|---|---|
| 8 | New renovation code for key (online). |
| 16 | Door opened: inside handle. |
| 17 | Door opened: key. |
| 18 | Door opened: key and keyboard. |
| 19 | Door opened: multiple guest key. |
| 20 | Door opened: unique opening. |
| 21 | Door opened: switch. |
| 22 | Door opened: mechanical key. |
| 25 | Door opened: PPD. |
| 26 | Door opened: keyboard. |
| 27 | Door opened: spare card (hotel). |
| 28 | Door opened: online command. |
| 29 | Door most probably opened: key and PIN. |
| 32 | End of office mode (keypad). |
| 33 | Door closed: key. |
| 34 | Door closed: key and keyboard. |
| 35 | Door closed: keyboard. |
| 36 | Door closed: switch. |
| 37 | Key inserted (energy saving device). |
| 38 | Key removed (energy saving device). |
| 39 | Room prepared (energy saving device). |
| 40 | Start of privacy. |
| 41 | End of privacy. |
| 42 | “Duress” alarm. |
| 47 | Communication with the reader lost |
| 48 | Communication with the reader reestablished |
| 49 | Start of office mode. |
| 50 | End of office mode. |
| 51 | Hotel guest cancelled. |
| 54 | Door programmed with spare key. |
| 55 | New hotel guest key. |
| 56 | Start of forced opening (online). |
| 57 | End of forced opening (online). |
| 58 | Start of forced closing (online). |
| 59 | End of forced closing (online). |
| 60 | Alarm: intrusion (online). |
| 61 | Alarm: tamper (online) |
| 62 | Door left opened (DLO). |
| 63 | End of DLO (door left opened). |
| 64 | End of intrusion. |
| 65 | Start of office mode (online). |
| 66 | End of office mode (online). |
| 67 | End of tamper. |
| 68 | Automatic change. |
| 69 | Key updated in "out of site" mode (online). |
| 70 | Expiration automatically extended (offline). |
| 72 | Online peripheral updated. |
| 76 | Key updated (online). |
| 78 | Key deleted (online). |
| 79 | Door has lost communication with the Salto software. |
| 80 | Door has reestablished communication with the Salto software. |
| 81 | Opening not allowed: key not activated. |
| 82 | Opening not allowed: key expired. |
| 83 | Opening not allowed: key out of date. |
| 84 | Opening not allowed: key not allowed in this door. |
| 85 | Opening not allowed: out of time. |
| 87 | Opening not allowed: key does not override privacy. |
| 88 | Opening not allowed: old hotel guest key. |
| 89 | Opening not allowed: hotel guest key cancelled. |
| 90 | Opening not allowed: antipassback. |
| 92 | Opening not allowed: no associated authorization. |
| 93 | Opening not allowed: invalid PIN. |
| 95 | Opening not allowed: door in emergency state. |
| 96 | Opening not allowed: key cancelled. |
| 97 | Opening not allowed: unique opening key already used. |
| 98 | Opening not allowed: key with old renovation number. |
| 99 | Warning: key has not been completely updated (online). |
| 100 | Opening not allowed: run out of battery. |
| 101 | Opening not allowed: unable to audit on the key. |
| 102 | Opening not allowed: locker occupancy timeout. |
| 103 | Opening not allowed: denied by host. |
| 104 | Blacklisted key deleted. |
| 107 | Opening not allowed: key with data manipulated. |
| 111 | Closing not allowed: door in emergency state. |
| 112 | New renovation code. |
| 113 | PPD connection. |
| 114 | Time modified (daylight saving time). |
| 115 | Low battery level. |
| 116 | Incorrect clock value. |
| 117 | RF Lock date and time updated. |
| 118 | RF Lock updated. |
| 119 | Unable to perform open/close operation due to a hardware failure. |
| 120 | Lock restarted. |
| 1000 | The Salto software has reestablished communication with the door. |
| 1001 | The Salto software has lost communication with the door. |
| 2000 | Guest new key |
| 2001 | Guest copy key |