Dragino SDI-12-NB NB-IoT Sensor Node

Selelekela

What is NB-IoT Analog Sensor

The Dragino SDI-12-NB is a NB-IoT Analog Sensor for Internet of Things solution. SDI-12-NB has 5v and 12v output, 4~20mA, 0~30v input interface to power and get value from Analog Sensor. SDI-12-NB will convert the Analog Value to NB-IoT wireless data and send to IoT platform via NB-IoT network.

• SDI-12-NB supports different uplink methods including MQTT, MQTTs, UDP & TCP for different application requirement, and support uplinks to various IoT Servers.
• SDI-12-NB supports BLE configure and OTA update which make user easy to use.
• SDI-12-NB is powered by 8500mAh Li-SOCI2 battery, it is designed for long-term use up to several years.
• SDI-12-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.

PS-NB-NA in a NB-loT Network

Likaroloana

• NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85
• Tšebeliso e tlase haholo ea matla
• Kenyeletso ea 1 x 0~20mA , 1 x 0~30v kenyeletso
• 5v le 12v tlhahiso ho matlafatsa sensor ea kantle
• Atisa Sampling le sehokelo se le seng
• Support Bluetooth remote configure and update firmware
• Kopanya nako le nako
• Downlink ho fetola tlhophiso
• 8500mAh Betri bakeng sa tšebeliso ea nako e telele
• IP66 Sebaka se sa keneleng metsi
• Uplink ka MQTT, MQTTs, TCP, kapa UDP
• Nano SIM card slot for NB-IoT SIM

Tlhaloso

Litšobotsi tse tloaelehileng tsa DC:

• Phepelo Voltage: 2.5v ~ 3.6v
• Mocheso oa ho sebetsa: -40 ~ 85°C

Current Input (DC) Measuring :

• Boholo: 0 ~ 20mA
• Ho nepahala: 0.02mA
• Qeto: 0.001mA

Moqtage Tekanyo ea Lintho:

• Sebaka: 0 ~ 30v
• Ho nepahala: 0.02v
• Qeto: 0.001v

Tlhaloso ea NB-IoT:

NB-IoT Module: BC660K-GL

Lihlopha tsa Tšehetso:

• B1 @H-FDD: 2100MHz
• B2 @H-FDD: 1900MHz
• B3 @H-FDD: 1800MHz
• B4 @H-FDD: 2100MHz
• B5 @H-FDD: 860MHz
• B8 @H-FDD: 900MHz
• B12 @H-FDD: 720MHz
• B13 @H-FDD: 740MHz
• B17 @H-FDD: 730MHz
• B20 @H-FDD: 790MHz
• B28 @H-FDD: 750MHz
• B66 @H-FDD: 2000MHz
• B85 @H-FDD: 700MHz

Betri:
Li/SOCI2 betri e sa lefeheng
• Capacity: 8500mAh
• Self Discharge: <1% / Year @ 25°C
• Max continuously current: 130mA
• Max boost current: 2A, 1 second
Tšebeliso ea Matla

• STOP Mode: 10uA @ 3.3v
• Max transmit power: 350mA@3.3v

Lisebelisoa

• Mehaho e Bohlale le Boiketsetso ba Lehae
• Tsamaiso ea Thepa le Phepelo
• Smart Metering
• Temo e Bohlale
• Smart Cities
• Smart Feme

Mokhoa oa ho robala le mokhoa oa ho sebetsa

Deep Sleep Mode: Sensor doesn’t have any NB-IoT activate. This mode is used for storage and shipping to save battery life.

Working Mode: In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT network and send out sensor data to server. Between each sampling / tx / rx nako le nako, sensor e tla ba ka mokhoa oa IDLE), ka mokhoa oa IDLE, sensor e na le matla a tšoanang le a Deep Sleep mode.

Konopo & LEDs

Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.

Khokahano ea BLE

SDI-12-NB support BLE remote configure and firmware update.

BLE e ka sebelisoa ho hlophisa paramente ea sensor kapa ho bona tlhahiso ea console ho tsoa ho sensor. BLE e tla sebetsa feela maemong a latelang:

• Tobetsa konopo ho romella sehokelo
• Tobetsa konopo ho sesebelisoa se sebetsang.
• Sesebediswa Matla a butswe kapa seta botjha.

Haeba ho se na khokahano ea ts'ebetso ho BLE ka metsotsoana e 60, sensor e tla koala module ea BLE ho kenya mokhoa o tlase oa matla.

Litlhaloso tsa Pin , Switch & SIM Direction

SDI-12-NB use the mother board which as below.

Jumper JP2

Matla ho Sesebelisoa ha u beha jumper ena.

BOOT MODE / SW1

1. ISP: upgrade mode, device won’t have any signal in this mode. but ready for upgrade firmware. LED won’t work. Firmware won’t run.
2. Flash: mokhoa oa ho sebetsa, sesebelisoa se qala ho sebetsa 'me se romela tlhahiso ea console bakeng sa ho lokisa bothata bo bong

Seta Botjha Konopo

Tobetsa ho qala sesebelisoa bocha.

Tataiso ea SIM Card

Sheba sehokelo sena. Mokhoa oa ho kenya SIM Card.

Use SDI-12-NB to communicate with IoT Server

Send data to IoT server via NB-IoT network

The SDI-12-NB is equipped with a NB-IoT module, the pre-loaded firmware in SDI-12-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by SDI-12-NB. Below shows the network structure:

PS-NB-NA in a NB-loT Network

There are two version: -GE and -1D version of SDI-12-NB.

GE Version: This version doesn’t include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set SDI-12-NB send data to IoT server.

• Install NB-IoT SIM card and configure APN. See instruction of Attach Network.
• Set up sensor to point to IoT Server. See instruction of Configure to Connect Different Servers.

Below shows result of different server as a glance

1D Version: This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate SDI-12-NB and user will be able to see data in DataCake. See here for DataCake Config Instruction

Payload Types

To meet different server requirements, SDI-12-NB supports different payload type.

E kenyeletsa:

• General JSON format payload. (Type=5)
• HEX format Payload. (Type=0)
• ThingSpeak Format. (Type=1)
• ThingsBoard Format. (Type=3)

User can specify the payload type when choose the connection protocol. Example

• AT+PRO=2,0 // Use UDP Connection & hex Payload
• AT+PRO=2,5 // Use UDP Connection & Json Payload
• AT+PRO=3,0 // Use MQTT Connection & hex Payload
• AT+PRO=3,1 // Use MQTT Connection & ThingSpeak
• AT+PRO=3,3 // Use MQTT Connection & ThingsBoard
• AT+PRO=3,5 // Use MQTT Connection & Json Payload
• AT+PRO=4,0 // Use TCP Connection & hex Payload
• AT+PRO=4,5 // Use TCP Connection & Json Payload

General Json Format(Type=5)

This is the General Json Format. As below: {“IMEI”:”866207053462705″,”Model”:”PSNB”,” idc_intput”:0.000,”vdc_intput”:0.000,”battery”:3.513,”signal”:23,”1″:{0.000,5.056,2023/09/13 02:14:41},”2″:{0.000,3.574,2023/09/13 02:08:20},”3″:{0.000,3.579,2023/09/13 02:04:41},”4″: {0.000,3.584,2023/09/13 02:00:24},”5″:{0.000,3.590,2023/09/13 01:53:37},”6″:{0.000,3.590,2023/09/13 01:50:37},”7″:{0.000,3.589,2023/09/13 01:47:37},”8″:{0.000,3.589,2023/09/13 01:44:37}}

Notice, from above payload:

• Idc_input , Vdc_input , Battery & Signal are the value at uplink time.
• Json entry 1 ~ 8 are the last 1 ~ 8 sampling data as specify by AT+NOUD=8 Command. Each entry includes (from left to right): Idc_input , Vdc_input, Sampnako e telele.

HEX format Payload(Type=0)

This is the HEX Format. As below:

f866207053462705 0165 0dde 13 0000 00 00 00 00 0fae 0000 64e2d74f 10b2 0000 64e2d69b 0fae 0000 64e2d5e7 10b2 0000 64e2d47f 0fae 0000 64e2d3cb 0fae 0000 64e2d263 0fae 0000 64e2d1af 011a 01e8 64d494ed 0118 01e8 64d4943d

Mofuta:

These bytes include the hardware and software version.

• Higher byte: Specify Sensor Model: 0x01 for SDI-12-NB
• Lower byte: Specify the software version: 0x65=101, which means firmware version 1.0.1

BAT (Battery Info):

Sheba matla a betritage for SDI-12-NB.

• Ex1: 0x0dde = 3550mV
• Ex2: 0x0B49 = 2889mV

Matla a Letšoao:

NB-IoT Network Signal Strength.

Ex1: 0x13 = 19

• 0 -113dBm kapa ka tlase ho moo
• 1 -111dBm
• 2…30 -109dBm… -53dBm
• 31 -51dBm kapa ho feta
• 99 Ha e tsejoe kapa e sa bonahale

Mohlala oa Probe:

SDI-12-NB might connect to different kind of probes, 4~20mA represent the full scale of the measuring range. So a 12mA output means different meaning for different probe.

Bakeng sa mohlalaample.

User can set different probe model for above probes. So IoT server is able to se identical how it should parse the 4~20mA or 0~30v sensor value and get the correct value.

IN1 & IN2:

• IN1 and IN2 are used as Digital input pins.

ExampLe:

• 01 (H): IN1 or IN2 pin is high level.
• 00 (L): IN1 or IN2 pin is low level.
• GPIO_EXTI Level:
• GPIO_EXTI is used as Interrupt Pin.

ExampLe:

• 01 (H): GPIO_EXTI pin is high level.
• 00 (L): GPIO_EXTI pin is low level.

GPIO_EXTI Flag:

This data field shows if this packet is generated by Interrupt Pin or not.
Note: The Interrupt Pin is a separate pin in the screw terminal.

ExampLe:

• 0x00: Pakete e tloaelehileng ea uplink.
• 0x01: Khaotsa Phakete ea Uplink.

0 ~ 20mA:

ExampLe:

27AE(H) = 10158 (D)/1000 = 10.158mA.

Connect to a 2 wire 4~20mA sensor.

0~30V:

Lekanya bophahamo ba modumotage value. The range is 0 to 30V.

ExampLe:

138E(H) = 5006(D)/1000= 5.006V

NakoStamp:

• Unit TimeStamp Example: 64e2d74f(H) = 1692587855(D)
• Put the decimal value into this link(https://www.epochconverter.com))to get the time.

ThingsBoard Payload(Type=3)

Type3 payload special design for ThingsBoard, it will also configure another default server to ThingsBoard.

{“IMEI”: “866207053462705”,”Model”: “PS-NB”,”idc_intput”: 0.0,”vdc_intput”: 3.577,”battery”: 3.55,”signal”: 22}

ThingSpeak Payload(Type=1)

This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~4 are: Idc_input , Vdc_input , Battery & Signal. This payload type only valid for ThingsSpeak Platform

Joalo ka tlase:

field1=idc_intput value&field2=vdc_intput value&field3=battery value&field4=signal value

Test Uplink and Change Update Interval

By default, Sensor will send uplinks every 2 hours & AT+NOUD=8 User can use below commands to change the uplink interval

AT+TDC = 600 // Beha nako ea ntlafatso ho isa ho 600s
User can also push the button for more than 1 seconds to activate an uplink.

Mefuta e mengata ea Samplings and One uplink

Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer Clock Logging Feature.

To save battery life, SDI-12-NB will sample Idc_input & Vdc_input data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:

• AT+TR=900 // The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
• AT+NOUD=8 // The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.

Setšoantšo se ka tlase se hlalosa kamano pakeng tsa TR, NOUD, le TDC ka ho hlaka:

Trggier an uplink by external interrupt

SDI-12-NB has an external trigger interrupt function. Users can use the GPIO_EXTI pin to trigger the upload of data packets.

AT taelo:

• AT+INTMOD // Set the trigger interrupt mode
• AT+INTMOD=0 // Disable Interrupt,as a digital input pin
• AT+INTMOD=1 // Trigger by rising and falling edge
• AT+INTMOD=2 // Trigger by falling edge
• AT+INTMOD=3 // Trigger by rising edge

Beha Nako ea Output ea Matla

Control the output duration 3V3 , 5V or 12V. Before each sampling, device will

• first enable the power output to external sensor,
• keep it on as per duration, read sensor value and construct uplink payload
• ho qetela, koala tlhahiso ea matla.

Set the Probe Model

Users need to configure this parameter according to the type of external probe. In this way, the server can decode according to this value, and convert the current value output by the sensor into water depth or pressure value.

AT Command: AT +PROBE

• AT+PROBE=aabb
• When aa=00, it is the water depth mode, and the current is converted into the water depth value; bb is the probe at a depth of several meters.
• When aa=01, it is the pressure mode, which converts the current into a pressure value; bb represents which type of pressure sensor it is.

Clock logging (Since firmware version v1.0.5)

Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature. We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.

AT Command: AT +CLOCKLOG=a,b,c,d

• a: 0: Disable Clock logging. 1: Enable Clock Logging
• b: Specify First sampling start second: range (0 ~ 3599, 65535) // Note: If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.
• c: Specify the sampling interval: range (0 ~ 255 minutes)
• d: How many entries should be uplink on every TDC (max 32)

Note: To disable clock recording, set the following parameters: AT+CLOCKLOG=1,65535,0,0

Example: AT +CLOCKLOG=1,0,15,8

Device will log data to memory start from the 0″ second (11:00 00″ of first hour and then sampling and log every 15 minutes. Every TDC uplink, the uplink payload will consist: Battery info + last 8 memory record with timestamp + the latest sample at uplink time) . See below for the example.

ExampLe:

AT+CLOCKLOG=1,65535,1,3

After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 3 memory records (payload + timestamp).

Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.

Example Query saved historical records

AT Command: AT +CDP

This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes.

Uplink log query

• AT Command: AT +GETLOG
  This command can be used to query upstream logs of data packets.

Scheduled domain name resolution

This command is used to set up scheduled domain name resolution

AT Taelo:

• AT+DNSTIMER=XX // Unit: hour

After setting this command, domain name resolution will be performed regularly.

Configure SDI-12-NB

Lokisa Mekhoa

SDI-12-NB supports below configure method:

• AT Taelo ka Bluetooth Connection (E khothalelitsoe): BLE Configure Taelo.
• AT Taelo ka UART Connection : Sheba Khokahano ea UART.

AT Commands Set

• AT+ ? : Thusa ka
• AT+ : Matha
• AT+ = : Beha boleng
• AT+ =? : Fumana boleng

Litaelo tse Akaretsang

• AT: Ela hloko
• AT? : Thuso e Khutšoane
• ATZ: Khutlisa MCU
• AT+TDC : Nako ea Phetiso ea Lintlha tsa Kopo
• AT+CFG: Hatisa litlhophiso tsohle
• AT+MODEL :Get module information
• AT+SLEEP :Get or set the sleep status
• AT+DEUI : Get or set the Device ID
• AT + INTMOD : Beha mokhoa oa ho khelosa trigger
• AT+APN : Fumana kapa u sete APN
• AT+3V3T : Set extend the time of 3V3 power
• AT+5VT: Beha nako ea ho eketsa nako ea matla a 5V
• AT+12VT: Beha nako ea ho eketsa nako ea matla a 12V
• AT+PROBE : Get or Set the probe model
• AT + PRO: Khetha tumellano
• AT+RXDL: Eketsa nako ea ho romella le ho amohela
• AT+TR : Get or set data record time
• AT+CDP : Bala kapa Hlakola data e bolokiloeng
• AT + NOUD : Fumana kapa Beha palo ea data e tla kenngoa
• AT+DNSCFG: Fumana kapa Seta Seva ea DNS
• AT+CSQTIME : Get or Set the time to join the network
• AT+DNSTIMER : Get or Set the NDS timer
• AT+TLSMOD : Get or Set the TLS mode
• AT+GETSENSORVALUE: Returns the current sensor measurement
• AT+SERVADDR : Aterese ea seva

Tsamaiso ea MQTT

• AT+CLIENT : Fumana kapa Seta moreki oa MQTT
• AT+UNAME : Fumana kapa Seta Lebitso la Mosebelisi la MQTT
• AT+PWD: Fumana kapa Seta phasewete ea MQTT
• AT+PUBTOPIC : Fumana kapa Seta sehlooho sa phatlalatso sa MQTT
• AT+SUBTOPIC: Fumana kapa Seta sehlooho sa peeletso sa MQTT

Boitsebiso

• AT+FDR: Hlahisa data ea fektheri bocha
• AT+PWORD: Lekunutu la phihlello ea serial
• AT+LDATA : Get the last upload data
• AT+CDP : Bala kapa Hlakola data e bolokiloeng

Tšebeliso ea Betri le Matla

SDI-12-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. Battery Info & Power Consumption Analyze .

Ntlafatso ea firmware

User can change device firmware to::

• Ntlafatsa ka likarolo tse ncha.
• Lokisa liphoso.

Firmware and changelog can be downloaded from : the Firmware download link

Mekhoa ea ho ntlafatsa firmware:

• (Recommended way) OTA firmware update via BLE: Instruction.
• Update through UART TTL interface : Instruction.

LBH

How can I access t BC660K-GL AT Commands?

User can access to BC660K-GL directly and send AT Commands. See BC660K-GL AT Command set

How to configure the device through the MQTT subscription function?（Since version v1.0.3）

Subscription content: {AT COMMAND}

ExampLe:

Setting AT+5VT=500 through Node-RED requires MQTT to send the content {AT+5VT=500}.

Tlhaiso-leseling

Part Number: SDI-12-NB-XX-YY XX:

• GE: General version ( Exclude SIM card)
• 1D: with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server

YY: The grand connector hole size

• M12: lesoba la M12
• M16: lesoba la M16
• M20: lesoba la M20

Packing Info

Sephutheloana se kenyeletsa:

• SDI-12-NB NB-IoT Analog Sensor x 1
• Lenakana la kantle x 1

Boima le boholo:

• Boholo ba sesebelisoa: cm
• Boima ba sesebelisoa: g
• Boholo ba sephutheloana / likhomphutha: cm
• Boima ba 'mele / likhomphutha: g

Tšehetso

• Ts'ehetso e fanoa ka Mantaha ho isa Labohlano, ho tloha ka 09:00 ho isa 18:00 GMT+8. Ka lebaka la libaka tse fapaneng tsa nako re ke ke ra fana ka ts'ehetso e teng. Leha ho le joalo, lipotso tsa hau li tla arajoa kapele kamoo ho ka khonehang kemisong e boletsoeng pele.
• Fana ka lintlha tse ngata kamoo ho ka khonehang mabapi le potso ea hau (mefuta ea lihlahisoa, hlalosa bothata ba hau ka nepo le mehato ea ho bo etsa joalo-joalo) 'me u romelle lengolo ho Support@dragino.cc.

Phatlalatso ea FCC

Tlhokomeliso ea FCC:

Liphetoho life kapa life tse sa amoheloeng ka kotloloho ke mokha o ikarabellang bakeng sa tumellano li ka hlakola matla a mosebelisi a ho sebelisa sesebelisoa.
Sesebelisoa sena se lumellana le karolo ea 15 ea Melao ea FCC. Ts'ebetso e ipapisitse le maemo a mabeli a latelang:

1. Sesebelisoa sena se ka 'na sa se ke sa baka tšitiso e kotsi, le
2. sesebelisoa sena se tlameha ho amohela tšitiso efe kapa efe e amohetsoeng, ho kenyeletsoa tšitiso e ka bakang ts'ebetso e sa batleheng.

Transmitter ena ha ea lokela ho ba sebakeng se le seng kapa ho sebetsa mmoho le antenna kapa transmitter efe kapa efe.

NOTE: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the Instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:

• Sheba hape kapa o suthise lenakana le amohelang sebakeng se seng.
• Eketsa karohano pakeng tsa thepa le moamoheli.
• Hokela lisebelisoa sebakeng sa seketsoana se fapaneng le seo moamoheli a hokahaneng le sona.
• Ikopanye le morekisi kapa setsebi sa radio/TV se nang le boiphihlelo bakeng sa thuso.

Polelo ea Ts'oaetso ea Mahlaseli a FCC:

This equipment complies with FCC radiation exposure limits set forth for uncontrolled environments.This equipment should be installed and operated with minimum distance 20cm between the radiator& your body.

Litokomane / Lisebelisoa

Dragino SDI-12-NB NB-IoT Sensor Node [pdf] Bukana ea Mosebelisi SDI-12-NB NB-IoT Sensor Node, SDI-12-NB, NB-IoT Sensor Node, Sensor Node, Node

Litšupiso

• Bukana ea Mosebelisi