This is an old revision of the document!
Table of Contents
ACDSN-iC-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
Delete
Label | Arguments | Options | Comments |
---|---|---|---|
format | a | ||
delete file | g | <filename> | |
delete thermochron | k | <sid> | |
restart | s |
New
Label | Arguments | Options | Comments |
---|---|---|---|
new address | a | <address> | cannot be broadcasted |
new bad access timeout | b | <timeout> | |
new valid access timeout | c | <timeout> | |
new discontinuation | d | <discontinuation> | set the timeout value after which the slave consider itself to be abandoned by the server (in sec) |
new file | g | <filename>\t<>\t<CRC> | |
new buzzer | j | <mode> | buzzer activated or not |
new thermochron | k | <sid>\t<id_profile>\t<suid> | |
new lock | l | <device>\t<mode> | lock a probe |
new mode | m | 0\t<mode> | slave enable/disable |
new firmware | n | ||
new profile | p | <id_profile>\t<limitH>\t<limitL>\t<delay>\t<rate> | change profile |
new status | s | <comptability> | count number of lines in ACCESS file, update log_position and set comptability |
new timestamp | t | <timestamp>\t<TZ> | only if RTC defined (used to synchronize clock)(date +%s) |
new overdrive speed | v | <device>\t<mode> | put 1-wire devices in overdrive speed |
new baudrate | z | <baudrate> |
Query
Label | Arguments | Options | Comments |
---|---|---|---|
query general status | a | ||
query bad access timeout | b | ||
query valid access timeout | c | ||
query discontinuation status | d | no query from server timeout | |
query entry | e | Receive: <address>\t<id_profile>\t<suid>\t<timestamp>\t<TZ>\t<od_speed> | |
query file | g | <filename>\t<limit> | |
query extension | i | <extension> | give a list of files with the extension desired (TXT,1, …) |
query buzzer status | j | ||
query lock | l | <1|2> | |
query mode | m | 0 (zero) | slave active or not |
query firmware version | n | ||
query status | s | how many missions recorded since last query | |
query timestamp | t | <device> | only if RTC is defined |
query overdrive speed | v | <1|2> | |
query wire | w |
Options
Options | Comments |
---|---|
<address> | 0 to 65535 |
<comptability> | 0 to 65534 How many access we would like receive |
<delay> | 0 to 65535 How many minutes the device waits before starting logging process |
<discontinuation> | 0 to 4294967295 (if 0 we don't care about discontinuation) |
<filename> | File on uSD: CONFIG.TXT, KEYS.TXT … |
<id_profile> | identification of profile on 8 char ['0-9'-'A-Z'-'a-z'] like 0B0a0001 |
<limit> | Max line to display |
<limitH> | -40. to +85. Higher alarm limit (°C) |
<limitL> | -40. to +85. Lower alarm limit (°C) |
<mode> | 0 [disable] or 1 [enable] |
<rate> | 0 to 255 how many minutes the temperature conversions are apart from each other during a mission |
<sid> | SID of the iButton (in iControl case family 21) |
<suid> | identification of iButton on 8 char ['0-9'-'A-Z'-'a-z'] like 0A0b0009 |
<timeout> | 0 to 255 |
<timestamp> | 0 to 9'999'999'999 [seconds since 1.1.1970] |
<TZ> | -1200 to +1400 |
Configuration Files (Micro-SD)
These files can be found on the Micro-SD of a NiX.
CONFIG.TXT
This file contains the minimal configuration with which the NiX cans run autonomously.
- CONFIG.TXT
ADDRESS 1 BAD_ACCESS_TIMEOUT 5 BAUDRATE 9600 BUZZER 0 DISCONTINUATION 180 ENABLE 1 LOCK_0 0 LOCK_1 0 OD_SPEED_0 0 OD_SPEED_1 0 TIMEZONE +0100 VALID_ACCESS_TIMEOUT 5
SID_I.TXT
This file contains the link between the iButton's SID, the profile's identification and iButton's identification.
Field Name | Description | Example |
---|---|---|
sid | Sid of the iButton | 21EAF5320000000F |
id_profile | The identification of the profile mission | 0B0a0001 |
suid | The identification of the thermochron iButton | 0A0b0009 |
- SID_I.TXT
21EAF53200000001 00000001 0000000Z 21EAF53200000002 00000002 m9999998 21EAF5320000000E 0000000a 9999999D 21EAF1320000000F 0000000H 00000001 21EAF2320000000F 00000010 9999999F 21EAF3320000000F 000000b0 00000002 21EAF4320000000F 000000P0 99999901 21EAFF320000000F k0000000 9999990b
Profiles Files
These files contain the parameters to launch a mission.
- 000A0001.TXT
ALARM_HIGH_TEMPERATURE 85 ALARM_LOW_TEMPERATURE -13.5 DELAY 5 SAMPLE_RATE 2
- 00000001.TXT
ALARM_HIGH_TEMPERATURE 12.5 ALARM_LOW_TEMPERATURE -3.5 DELAY 65535 SAMPLE_RATE 16
ACCESS.#
File where only good discharging missions are recorded. # is the extension of day of year.
Field Name | Description | Example |
---|---|---|
slave address | Address of the slave | 1 to 65536 |
id_profile | The identification of the profile mission | 0B0a0001 |
suid | The identification of the thermochron iButton | 0A0b0009 |
timestamp | The timestamp of the NiX1 | 1400620011 |
timezone | Code of the timezone | +0100 |
overdrive speed | Communication speed | 0 or 1 |
- ACCESS.#
1 00000001 0000000Z 1407310961 +0100 0 1 0000000H m9999998 1407311983 +0100 0 1 000000P0 A0A0A0A0 1407320009 +0100 0 1 k0000000 01010101 1407391025 +0100 0
ACTIVITY.#
File where all iButton interruptions are recorded. # 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 | Address of the slave | 1 to 65536 |
After:
Field Name | Description | Example |
---|---|---|
slave address | Address of the slave | 1 to 65536 |
iDevice | On which probe is the device | 1 or 2 |
timestamp | The timestamp when a iButton made an interruption | 1400610063 |
sid | SID of the iButton | 21EAF5320000000E |
suid | The identification of the thermochron iButton | 0A0b0009 |
code error | The identification of the error (0 if OK) | 49 |
timezone | Code of the timezone | +0100 |
overdrive speed | Communication speed | 0 or 1 |
- ACTIVITY.#
0 Slave ID: 1 1 1 1407310961 21EAF53200000002 m9999998 0 +0100 1 1 1 1407310983 21EAF4320000000F 99999901 0 +0100 1 1 1 1407310999 0000000000000000 00000000 49 +0100 0 1 1 1407311001 231C6E85010000CF 00000000 49 +0100 0 1 1 1407311004 235C123901000077 00000000 49 +0100 0 1 1 1407311009 21EAF5320000000E 9999999D 0 +0100 1 1 1 1407311025 212A16330000008B 01010101 0 +0100 1 1 1 1407311396 21EAF5320000000F A0A0A0A0 0 +0100 0
Temperatures Files
These files contain all informations about the Thermochron and the temperatures read. The suid is the name of the file and the extension is the day of the year (ex: 01010101.237). 25 august is the 237 day of year.
Field Name | Description | Example |
---|---|---|
sid | SID of the iButton | 21EAF5320000000E |
suid | The identification of the thermochron iButton | 0A0b0009 |
id_profile | The identification of the profile mission | 0B0a0001 |
NiX1_timestamp | The timestamp of NiX1 when a iButton made an interruption (GMT) | 2014-08-03T19:02:12 |
thermochron_timestamp | The timestamp of Thermochron iButton when the interruption (GMT) | 2014-08-09T09:00:19 |
delay | Delay in minutes after then the mission begins (0≤65535) | 63290 |
alarm_high_temp | Maximum temperature limit (°C) [-40.0≤+85.0] | 12.5 |
alarm_low_temp | Minimum temperature limit (°C) [-40.0≤+85.0] | -6.0 |
sample_rate | Frequency of samples in minutes [1≤255] | 65 |
mission_sample_counter | How many samples since the mission's begin | 4166 |
device_sample_counter | How many samples since the first use of the iButton | 135257 |
first_conversion_date | Date and time of the first mission's sample (GMT) | 2014-07-29T15:09 |
alarm_low_status | Status of low alarms (12x) | |
alarm_high_status | Status of high alarms (12x) | |
temperatures | Temperatures measured during mission (in Hexadecimal format) | 88 |
- A0A0A0A0.325
SID: 21EAF532000000E ID: A0A0A0A0 PROFILE: 00000001 NiX1 Timestamp (GMT): 2014-08-04T10:02:12 Thermochron Timestamp (GMT): 2014-08-04T10:02:11 Delay (min): 25 Alarm High Temperature (°C): 28.5 Alarm Low Temperature (°C): 0.5 Sample Rate (min): 2 Mission Samples Counter: 4166 Device Samples Counter: 135257 First Convertion Date-Time (GMT): 2014-07-29T15:09 Low Alarm 1: since sample 0 during 0 samples Low Alarm 2: since sample 0 during 0 samples Low Alarm 3: since sample 0 during 0 samples Low Alarm 4: since sample 0 during 0 samples Low Alarm 5: since sample 0 during 0 samples Low Alarm 6: since sample 0 during 0 samples Low Alarm 7: since sample 0 during 0 samples Low Alarm 8: since sample 0 during 0 samples Low Alarm 9: since sample 0 during 0 samples Low Alarm 10: since sample 0 during 0 samples Low Alarm 11: since sample 0 during 0 samples Low Alarm 12: since sample 0 during 0 samples High Alarm 1: since sample 11 during 1 samples High Alarm 2: since sample 13 during 2 samples High Alarm 3: since sample 26 during 4 samples High Alarm 4: since sample 38 during 1 samples High Alarm 5: since sample 678 during 11 samples High Alarm 6: since sample 4122 during 1 samples High Alarm 7: since sample 4158 during 2 samples High Alarm 8: since sample 0 during 0 samples High Alarm 9: since sample 0 during 0 samples High Alarm 10: since sample 0 during 0 samples High Alarm 11: since sample 0 during 0 samples High Alarm 12: since sample 0 during 0 samples 888787868586868786878988898987868888878787878686868A8D8B89888787 8786878786898887878686858585858484848484848484848484848483838383 8383838383838383838383838383838383838383838383838383838383838383 8383838383838383838282828282828282828282828282828282828282828282 8282828282828282828282828282828282828282828282828282828282828281 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818180808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 807F80807F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F8280838483828282 8384838383828383828282818181818181818181828282828282828282828282 8282828181818181828282818181818181818080808080808080808080808080 8080808181818080808181818181828282828282828282828282828282848385 8483838282828282828282828281828282828282828282828181818181818181 8181818180808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 80808080808B91969596939494908B8987868585848484838384868685848483 8383838383838383838383838383838383838383838383838383838383838383 8383838383838383838383828382828282828282828282828282828282828282 8282828282828282828282828282828282828282828282828282828282828383 8383838383838383838383828282828282828282828282828282828282828282 8282828282828282828282828282828282828181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080807F80807F7F7F807F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F7F 8080808080808080808080808181818181818181818181818181818181818182 8282828282828282828282828282828282828282828282828282828282828282 8282828282828282828282828282828282828282828282828282828282828282 8282828282828282828282828282828282828282828282828282828282828282 8282828282828282828383838383838383838383838383838383838384848484 8484848484848484848484848484848484848484848484848484848484848484 8484848484848484858585858584848484848484848484848484848484848484 8484848484848484848484848484848484848484848484848484848484848484 8484848383838383838383838383838383838383838383838383838383838383 8383838383838383838383838383838383838383838282828282828282828282 8282828282828282828282828282828282828282828282828282828282828282 8282828282828282828282828282828282828282828282828282828282828282 8282828282828282818282818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818081818180808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080808080808080 8080808080808080808080808080808080808080808080808080818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181 8181818181818181818181818181818181818181818181818181818181818181