User Tools

Site Tools


acdsn:acdsn-v-fx

ACDSN-V-FX

The following line shows how to address and communicate with a NiX1 slave over a RS485 line.

 2700000000000000Qw3
 ^               ^^^
 |               |||
 |               ||- option
 |               |-- argument
 |               --- command
 ---- address

Addresses

Label Address Comment
scratch 270000000000005C This is the scratch address used to configure new slave
broadcast 27FFFFFFFFFFFF4E This is the broadcast address

Commands

Label Command
delete D
new N
query Q

Arguments

Delete

Label Arguments Options Comments
format a
delete file g <filename>
restart s
delete unit u if option set to 0, delete file
delete tmp files y delete file for Newfile fct

New

Label Arguments Options Comments
new Check c
new Entry e <nb request>
new file g <filename>\t<CRC>
new Vault Status h <unit>\t<status> ouverture(1) / fermeture(0)
copy file i <filename>/t<copyFilename>
new mode m <mode>
new firmware version n <filename>\t<retry times>
new general status s <value> set value in NiX general status
new timestamp t <timestamp>\t<TZ> only if RTC defined (used to synchronize clock)(date +%s)
new unit u <unit>\t<CH>\t<staytime>
new file packet y <nbrPacket>/t<blockLength>/t<CRC>/t<block>
new baudrate z <baudrate>

Query

Label Arguments Options Comments
query entry e receive status lock (client ouverture)
query file g <filename>\t<limit>
query vault status h <unit> Receive: <VaultStatus>
query extension i <extension> give a list of files with the extension desired (TXT,1, …)
query mode m
query firmware version n
query Checksum p <filename>
query Remaining time r <unit>
query general status s
query timestamp t only if RTC is defined
query unit u <unit>Receive : <unit>\t<CH>\t<staytime>
query init state x   Receive: <initState><ChecksumInit>

Options

Options Comments
<block> block content (each char is formatted in 2 ascii in hexa value) ⇒ 'a' = 0x61 ⇒ sent : “61”
<blockLength> length of the actual block in bytes
<filename> filename (format : 88888888.333)
<copyFilename> filename destination
<limit> number of lines to fetch (0 to fetch the whole file)
<CH>  channel of the lock hardware (1 to 48)
<unit> N° de coffre de la banque 1-65536
<filesize> size of the file
<CRC> CRC of the file
<retry times> number of retry times
<timestamp> 0 to 9'999'999'999 [seconds since 1.1.1970]
<nbrPacket> packet total number for a file
<TZ> -1200 to +1400
<staytime> delay for the time to stay open
<VaultStatus> voir table de vérité
<stateInit> envoi de tous les coffres avec un status différent de 0 (masque codé en ASCII HEXA)
<checksumInit> checksum de l'envoi du state
<mode> mode du timeout (1: normal, 2: le timeout se reset à chaque fermeture client)

Table de vérité Vault Status

Client Banque Ouverture
0 0 0 0 fermé
1 0 0 1 porte ouverte, verrous fermés
2 0 1 0 déverrouillage banque
3 0 1 1 porte mal fermée
4 1 0 0 fermé
5 1 0 1 porte ouverte, verrouillage banque
6 1 1 0 verrous déverrouillés
7 1 1 1 porte ouverte

Return Code (HEX)

Code Transmission Functions
00 OK
04 EOT
06 ACK
15 NAK
16 SYN
21 ERROR_ADDRESS
41 ERROR_ARG
42 ERROR_BUS
43 ERROR_CMD ERROR_CREDENTIAL
44 ERROR_DATA (iC)
46 ERROR_FLASH
47 ERROR_CRC
48   ERROR_HASH
49 ERROR_IB
4B ERROR_KEY
4C ERROR_LOG
4D ERROR_MALLOC 
4E ERROR_NOT_FOUND
4F ERROR_OFFSET
50 ERROR_PARAM
51 ERROR_QUANTITY
52 ERROR_RXDATA
53 ERROR_STATE
54 ERROR_TYPE
55 ERROR_USER
56 ERROR_VAULT
57 ERROR_WRITE
58 ERROR_X
60 ERROR_SYNTAX
61 ERROR_DAY_OF_YEAR
63 ERROR_CLIENT
64 ERROR_DIAG
65 ERROR_EMPTY_MISSION (iC)
6C ERROR_LOCK
69 ERROR_I2CREAD
77 ERROR_I2CWRITE
70 ERROR_PULSE
72 ERROR_RESOLUTION (sC)
73 ERROR_SCHEDULE
76 ERROR_UNIT
74 ERROR_TIMESTAMP
7B ERROR_SDCARDNOTFOUND
FF ERROR_INT

Configuration Files (Server)

The configuration files are flat text file where each fields are separated by a tabulation.

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

Configuration Files (Micro-SD)

These files can be found on the Micro-SD of a NiX.

units.txt

This file contains the lock number from the CH number. And the delay to stay open the vault.

Field Name Description Example
unit The vault number 324
CH Channel number (1 to 48) 34
 staytime  The delay to stay open the vault (minutes) 10
units.txt
324     34     10
425     35      9

ACCESS.#

This file contains important logs. # is the day of year (eg: 1 February == 32). It corresponds to the output of the following command:

date +%j
Field Name Description Example
slave address SID of NiX 271A2100000000F3
CH The CH number 324
lock lock identification 15
timestamp The timestamp of the NiX 1400620011
timezone Code of the timezone +0100
vaultStatus table de vérité correspondant au status 4
error code Error code in hex format 39
ACCESS.#
271A2100000000F3	324	15		1436413339	+0100	0	55
271A2100000000F3	356	15		1436413340	+0100	4	55
271A2100000000F3	73	9		1436413341	+0100	0	55
271A2100000000F3	556	15		1436413345	+0100	6	55

ACTIVITY.#

This file contains not important logs. (# is the extension of day of year)

First line:

Field Name Description Example
timestamp The timestamp of the time when the NiX start 1400578529
slave address SID of NiX 271A2100000000F3
general status Last general status of NiX before the start (in hex format) 00
other info Information about the error 86

After:

Field Name Description Example
slave address SID of NiX 271A2100000000F3
unit The vault number 324
CH Channel number (1 to 48) 34
timestamp The timestamp of the NiX 1400620011
timezone Code of the timezone +0100
vaultStatus table de vérité correspondant au status 4
error code Error code in hex format 39
ACTIVITY.#
1436413328	Slave ID: 271A2100000000F3	General status: 00
271A2100000000F3	324	15		1436413339	+0100	0	55
271A2100000000F3	356	15		1436413340	+0100	1	49
271A2100000000F3	73	9		1436413341	+0100	4	55
271A2100000000F3	556	15		1436413345	+0100	6	40
1436413328	Slave ID: 271A2100000000F3	General status: 70 | 86

CONFIG.TXT

This file contains the minimal configuration with which the NiX cans run autonomously.

CONFIG.TXT
BAUDRATE	9600
TIMEZONE	+0100

Signals

List of used signals:

Name Hex Bash Dec
EOT 0x04 \x04 4
ACK  0x06 \x06 6
NAK 0x15 \0x15 21
SYN 0x16 \0x16 22

Use cases + example:

  1. Query sended to the NiX1:
    SYN + Query + EOT:
    \x1627D518320000007EQn\x4
  2. Answer from the NiX1 to a Query:
    Return code + EOT:
    \x0\x4
  3. Answer from the NiX1 to a sucessful New or Delete:
    ACK + EOT:
    \x6\x4
  4. Answer from the NiX1 to a failed New or Delete:
    NAK + Return code + EOT:
    \x15\x76\x4
  5. Answer from the NiX1 to a bad/misunderstood message (Query, New or Delete):
    NAK + Return code + EOT:
    \x15\x43\x4
  6. Broadcast: NiX1 is quiet:
    No Answer!
  7. Bad NiX1 address: no one answers:
    No Answer!
acdsn/acdsn-v-fx.txt · Last modified: 2023/09/08 12:42 by maferreira