This is an old revision of the document!
Table of Contents
ACDSN-C-FX
The following line shows how to address and communicate with a NiX1 slave over a RS485 line.
1Qw3 ^^^^ |||| |||- option ||-- argument |--- command ---- address
Commands
Arguments
New
Label | Arguments | Options | Comments |
---|---|---|---|
new address | a | <address> | change address |
new buzzer mode | b | <mode> | buzzer activated or not |
new contact mode | c | <contact>\t<mode> | set contact NO/NC mode |
new discontinuation | d | <discontinuation> | set the timeout value after which the slave consider itself to be abandoned by the server |
new limit | l | <ow>\t<limitH>\t<limitL> | set alarm boundaries |
new mode | m | <device>\t<mode> | slave/device enable/disable |
new recess | r | <recess> | scan-rate interval |
new timestamp | t | <timestamp> | only if RTC defined (used to synchronize clock) |
new wire | w | - | scan the lines and return the number of OW device found |
Query
Label | Arguments | Options | Comments |
---|---|---|---|
query buzzer status | b | ||
query contact status | c | ||
query discontinuation status | d | no query from server timeout | |
query family | f | 3 and above | get the 1-wire family of device n |
query mode | m | 0 (zero) | slave active or not |
1 or 2 | contacts active or not | ||
3 and above | ow devices active or not | ||
query recess | r | scan-rate intervall | |
query status | s | 0 (zero) | global status |
1 or 2 | contacts status | ||
3 and above | OW devices status | ||
query timestamp | t | only if RTC is defined | |
query value | v | ||
query wire | w | 0 (zero) | tel the number of OW devices connected |
3 and above | return the OW SID |
Configuration Files
The configuration files are flat text file where each fields are separated by a tabulation.
keys.txt
Contains the list of the key used to hash the credentials on the iButton key. You can generate a new key every day and add it to this file, the most recent key comming first.
Field Name | Description | Example |
---|---|---|
timestamp | The timestamp of the time when the key has been generated | 1350028169 |
key | The value of the secret key | [Z}4V;qr$(/Kc_aiF7#K8tATNC |
- demo_keys.txt
1350028169 [Z}4V;qr$(/Kc_aiF7#K8tATNC 1349094539 IdRPKslg\?/ 1349085044 9YxUJ`wa#\U;M18=L,>_bo8wIbn"IoY 1349085044 cl8b]It3f,F-b 1349085044 ad15lMR{*]P_<koY&=@;cNgr
units.txt
Provides a link beetween the unit id and a human readable label.
Field Name | Description | Example |
---|---|---|
id | The unique identifier of the unit, as used in slaves.conf | 2 |
label | A human description of the unit | Main Office |
- demo_units.txt
1 Reception 2 Main Office 3 CEO's Office
users.txt
Contains the list of all users, the timestamp of the last key read from the user and a value which can be incremented when an iButton key is lost or if the data on the iButton key has been copied by some nasty people.
Field Name | Description | Example |
---|---|---|
id | The unique identifier the the user, as used in cron.txt | Arthur Dent |
timestamp | The timestamp of the last key read for the user | 1350028169 |
increment | A value which can be incremented when an iButton key is lost | 3 |
- demo_users.txt
Arthur Dent 1350028169 3 Ford Prefect 1349085044 2 Zaphod Beeblebrox 1349085044 5
cron.txt
Contains the rights to access on some unit for a user during a specified time interval (specified as a cron).
Field Name | Description | Example |
---|---|---|
unit_id | The number identifying the target unit of this rule | 1 |
user_id | The identifier of the user on which this rule applies | Arthur Dent |
cron | The cron value of the accessible periods for this rule | 0 8-17 * * * |
- demo_cron.txt
1 Arthur Dent 0 8-17 * * * 2 Arthur Dent 0 8-17 * * * 1 Ford Prefect * * * * *