4_IOTPRO-DigitalAnalogueSerial

Recommended

Field Name

ID - HEX

Size in Bytes

Description

Data Type

Uplink/

Downlink/

Both

telemetry_param_state_channel_1

0x080A

1

State value

Boolean

Uplink

telemetry_param_state_channel_2

0x0819

1

State value

Boolean

Uplink

telemetry_param_state_channel_3

0x081A

1

State value

Boolean

Uplink

telemetry_param_state_channel_4

0x081B

1

State value

Boolean

Uplink

telemetry_param_state_channel_5

0x081C

1

State value

Boolean

Uplink

telemetry_param_state_channel_6

0x081D

1

State value

Boolean

Uplink

telemetry_param_analogue_dc_channel_1

0x0FD2

2

Voltage Reading in mV

Unsigned Integer, Unit: mV

Uplink

telemetry_param_analogue_dc_channel_2

0x0FD3

2

Voltage Reading in mV

Unsigned Integer, Unit: mV

Uplink

telemetry_param_4_20ma_channel_1

0x0FCE

2

Current Reading in mA

Unsigned Integer (/1000), Unit: mA

Uplink

telemetry_param_4_20ma_channel_1

0x0FCF

2

Current Reading in mA

Unsigned Integer (/1000), Unit: mA

Uplink

telemetry_param_4_20ma_alert_range_channel_1

0x080B

1

Out of range or limits exceeded

Unsigned Integer (0: No Alarm, 1: System out of range, 2: User thresholds out of range)

Uplink

telemetry_param_4_20ma_alert_range_channel_2

0x080C

1

Out of range or limits exceeded

Unsigned Integer (0: No Alarm, 1: System out of range, 2: User thresholds out of range)

Uplink

Optional

Field Name

ID - HEX

Size in Bytes

Description

Data Type

Uplink/

Downlink/

Both

device_set_current_4_20ma_alert_channel_1

0x55F1

11

Current 4-20mA alert ranges for Channel 1

Byte 1: Scan interval in minutes, Byte 2: Range 1 Enable, Bytes 3-4: Range 1 Min (uA), Bytes 5-6: Range 1 Max (uA), Byte 7: Range 2 Enable, Bytes 8-9: Range 2 Min (uA), Bytes 10-11: Range 2 Max (uA)

Both

device_set_current_4_20ma_alert_channel_2

0x55F2

11

Current 4-20mA alert ranges for Channel 2

Byte 1: Scan interval in minutes, Byte 2: Range 1 Enable, Bytes 3-4: Range 1 Min (uA), Bytes 5-6: Range 1 Max (uA), Byte 7: Range 2 Enable, Bytes 8-9: Range 2 Min (uA), Bytes 10-11: Range 2 Max (uA)

Both

device_set_analogue_dc_offset_channel_1

0x0FF6

2

Offset in mV for Analogue DC Channel 1

Signed Integer, Unit: mV

Both

device_set_analogue_dc_offset_channel_2

0x0FF7

2

Offset in mV for Analogue DC Channel 2

Signed Integer, Unit: mV

Both

device_set_4_20ma_offset_channel_1

0x0FF8

2

Offset in mA for 4-20mA Channel 1

Signed Integer (/1000), Unit: mA

Both

device_set_4_20ma_offset_channel_2

0x0FF9

2

Offset in mA for 4-20mA Channel 2

Signed Integer (/1000), Unit: mA

Both

device_set_timezone

0x1029

2

Command to set the timezone in minutes from UTC

Signed Integer, Unit: minutes

Both

device_set_dst_rules

0x4E21

10

Command to set the DST rules for the scheduler. DST offset will be applied to the timestamp between UTC time DST start and UTC time DST stop

Byte 1-4: UTC time DST start,Byte 5-8: UTC time DST stop, Byte 9-10: DST Offset in minutes

Both

telemetry_param_output_state_channel_1

0x0808

1

State of DOUT1

Boolean (0: Off, 1: On)

Uplink

telemetry_param_output_state_channel_2

0x0809

1

State of DOUT2

Boolean (0: Off, 1: On)

Uplink

device_set_scheduler_state

0x0839

1

Command to enable/disable the scheduler

Boolean (0: Off, 1: On)

Both

device_param_scheduler_event_queue

0x7150

VAR_2B

Complete scheduler event queue

Byte 1: Number of Scheduler Events (uint8), Repeated sequence for N times: Byte 2-x: Scheduler Event
The entire length shouldn't exceed 488 bytes

Both

device_set_scheduler_event_config

0x714F

VAR_2B

Command to add, modify, enable/disable or delete event/s in the scheduler

Repeated sequence for N times: Byte 1: Number of Action Record pairs, Repeated sequence for N times: Byte 2: Action (1 - Add, 2-Enable, 3-Disable,  4 - Delete), Byte 3-x: Scheduler Event only when Action is Add, otherwise Byte 3 will be the Event ID only, 1 byte, the the next action in sequence
The entire length shouldn't exceed 488 bytes

Both

device_set_longitude_astro

0x1F63

4

Longitude used for Astro times calculation

Signed (/10000000), Unit Decimal Degree

Both

device_set_latitude_astro

0x1F64

4

Latitude used for Astro times calculation

Signed (/10000000), Unit Decimal Degree

Both

device_set_output_override_channel_1

0x1026

2

Enable or disable override of the output channel 1. When enabled, Byte 1 describes the state of the override

Byte 1: State (0 = override 0, 1 = override 1), Byte 2: override Active

Both

device_set_output_override_channel_2

0x1027

2

Enable or disable override of the output channel 2. When enabled, Byte 1 describes the state of the override

Byte 1: State (0 = override 0, 1 = override 1), Byte 2: override Active

Both

device_set_output_idle_state_channel_1

0x083A

1

Command to the output chanel 1 idle state. This state will be executed whenever there are no scheduler events

Boolean

Both

device_set_output_idle_state_channel_2

0x083B

1

Command to the output chanel 2 idle state. This state will be executed whenever there are no scheduler events

Boolean

Both

Scheduler Event

Every Scheduler Event is exactly 24 bytes. The flags bitmask will set the mode of the Scheduler. No flags is the default time window mode; an output will go to its active state between the start_time and stop_time.

Offset

Size

Field

Wire type

Units / interpretation

0

1

event_id

uint8

Identifier, 1–255; 0 invalid

1

1

enabled

uint8

Send 0 = disabled, 1 = enabled

2

1

flags

uint8 bitmask [7654 3210]

See flag bits table

3–4

2

month

uint16 bitmask

Bit 1 = January … bit 12 = December;

5–8

4

dom

uint32 bitmask

Bit 1 = day 1 … bit 31 = day 31;

9

1

dow

uint8 bitmask

Bit 0 = Sunday … bit = Saturday;

10–11

2

interval_m

uint16

Periodic interval in minutes; 0 = no interval repetition

12–13

2

duration_s

uint16

Duration in seconds, 0–65535; must be nonzero for periodic mode

14–15

2

stop_time_m

uint16

Clock stop in minutes from midnight

16–17

2

start_time_m

uint16

Clock start in minutes from midnight

18-19

2

sunrise_offset

int16

Sunset offset in minutes

20-21

2

sunset_offset

int16

Sunrise offset in minutes

22

1

output_channel

uint8

Channels 1 or 2 corresponding to OUT1 and OUT2 on PCB

23

1

function

uint8

1 = ON, 2 = OFF

Flag bit

Hex

Meaning

0

0x01

Holiday priority: matching holiday events override ordinary matching events on the same output

1

0x02

Repeat yearly; without this flag, the event is removed when the scheduler advances to a new year

2

0x04

Sunrise mode; Given longitude and latitude the device can calculate the exact sunrise time. Output will go to the default state at the sunrise time + sunrise_offset with this flag enabled. If the start time is non zero and start time is before sunrise time + sunrise_offset, output will go to active state from start time till sunrise time + sunrise_offset

3

0x08

Sunset mode; Output will go to the active state at the sunset time + sunset_offset with this flag enabled. If the stop time is non zero and stop_time_m is after sunset time + sunset_offset, output will go to active state from sunset time + sunset_offset to stop_time_m

4

0x10

Periodic mode; When enabled and interval_m and duration_s are non-zero, output will go to active state every <interval_m> for <duration_s>

5–7

—

Must be zero

Example Packet

Packet (HEX)

0x36B20140E17D77FD5D0FAA00041F42685D16260FD230140FCE10F1080B01080A01081900081A01081B00081C01081D000FA240AF

ID1

0x36B2

IMEI

Value1

0x0140E17D77FD5D

352812193545565

ID2

0x0FAA

Application ID

Value2

0x0004

Digital Analogue Serial

ID3

0x1F42

Event 1: UNIX Time

Value3

0x685D1626

1750930982

ID4

0x0FD2

Event 1: Analogue DC Channel 1

Value4

0x3014

12.308V

ID5

0x0FCE

Event 1: 4-20mA Channel 1

Value5

0x10F1

4.337mA

ID6

0x080B

Event 1: 4-20mA Alert Channel 1

Value6

0x01

System out of range

ID7

0x080A

Event 1: Dry Contact Channel 1

Value7

0x01

Closed

ID8

0x0819

Event 1: Dry Contact Channel 2

Value8

0x00

Open

ID9

0x081A

Event 1: Dry Contact Channel 3

Value9

0x01

Closed

ID10

0x081B

Event 1: Dry Contact Channel 4

Value10

0x00

Open

ID11

0x081C

Event 1: Dry Contact Channel 5

Value11

0x01

Closed

ID12

0x081D

Event 1: Dry Contact Channel 6

Value12

0x00

Open

ID13

0x0FA2

Event 1: Power Supply Voltage

Value13

0x40AF

16.559V