SAC01L - LoRaWAN Crowd Recognition Sensor User Manual
Table of Contents:
- 1. Introduction
- SAC01L_LoRaWAN_Temperature&Humidity_Sensor_User_Manual
- 2. Configure SAC01L to connect to LoRaWAN network
- 3. Configure SAC01L via AT command or LoRaWAN downlink
- 4. FAQ
- 5. Order Info
- 6. Packing Info
- 7. Support
- 8. FCC Warning
- 9. Appendix I:According to the use
1. Introduction
1.1 What is SAC01L Temperature & Humidity Sensor
The Dragino SAC01L pedestrian recognition sensor is a long-range LoRaWAN sensor. It includes a built-in AI camera sensor and has a USB Type-C
SAC01L senses the movement of people and makes identification judgments. and send these values via long-range wireless LoRaWAN protocol. It targets professional wireless sensor network applications such as smart metering, smart cities, building automation, and so on.
SAC01L uses an external power supply and can work for a long time.
SAC01L is fully compatible with LoRaWAN v1.0.3 protocol, it can work with standard LoRaWAN gateway.
SAC01L supports Datalog feature to make sure users won't miss sensor data. It records sensor value for every uplink. These values can be retrieved by LoRaWAN server via downlink command.
1.2 Features
- LoRaWAN v1.0.3 Class A protocol.
- Low power consumption
- AI Image Sensor.
- Send image to IoT server
- Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915
- Support Interrupt uplink
- Support Bluetooth v5.1 and LoRaWAN remote configure
- Support wireless OTA update firmware
- AT Commands to change parameters
- Uplink on periodically
- Downlink to change configure
- IP Rating: IP52
1.3 Specification
Common DC Characteristics:
- DC power supply 5v
- Operating Temperature: -40 ~ 85°C
Camera:
- Mono: black & white
- Angle: 110°
- Image size:64kb
- Image resolution:640x480
- Power Consumption: 206.1mW
- Supply Voltage: DC5V
- Idel Mode: 6uA
- Take Photo: 41.22 mA and 3171 ms
- Cable Length:150cm
- Dimension:46.2x29x13.8 mm
- Waterproof level:IP52
LoRa Spec:
- Frequency Range, Band 1 (HF): 862 ~ 1020 Mhz
- Max +22 dBm constant RF output vs.
- RX sensitivity: down to -139 dBm.
- Excellent blocking immunity
1.5 Storage & Operation Temperature
-10 ~ 50 °C or -40 ~ 60 °C
1.6 Applications
- Smart Buildings & Home Automation
- Logistics and Supply Chain Management
- Smart Metering
- Smart Agriculture
- Smart Cities
- Smart Factory
2. Configure SAC01L to connect to LoRaWAN network
2.1 How it works
The SAC01L is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the SAC01L. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
The LED light is at the upper left for a positive viewing angle.When the character crosses the horizontal line in the middle, the count increases by one.
For details, please see the case.
2.2 Example to join LoRaWAN network
This section shows an example for how to join the TheThingsNetwork LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are of similar procedure.
Assume the DLOS8 is already set to connect to TTN V3 network . We need to add the SAC01L device in TTN V3 portal.
Step 1: Create a device in TTN V3 with the OTAA keys from SAC01L.
Each SAC01L is shipped with a sticker with the default DEV EUI as below:
Enter these keys in the LoRaWAN Server portal. Below is TTN V3 screen shot:
Add APP EUI in the application.
choose to create the device manually.
Add APP KEY and DEV EUI
Default mode OTAA
Step 2: Use ACT button to activate SAC01L and it will auto join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and user can see in the panel.
2.4 Uplink Payload
Uplink payloads include two types: Valid Sensor Value and other status / control command.
- Valid Sensor Value: Use FPORT=2
- Other control command: Use FPORT other than 2.
2.4.1 Uplink FPORT=5, Device Status
Uplink the device configures with FPORT=5. Once SAC01L Joined the network, it will uplink this message to the server. After first uplink, SAC01L will uplink Device Status every 12 hours.
Size(bytes) | 1 | 2 | 1 | 1 | 2 |
---|---|---|---|---|---|
Value | Sensor Model | Firmware Version | Frequency Band | Sub-band | BAT |
Example Payload (FPort=5): 38 0A 00 01 FF 0C D2
Sensor Model: For SAC01L, this value is 0x38.
Firmware Version: 0x0A00, Means: v1.0.0 version.
Frequency Band:
*0x01: EU868
*0x02: US915
*0x03: IN865
*0x04: AU915
*0x05: KZ865
*0x06: RU864
*0x07: AS923
*0x08: AS923-1
*0x09: AS923-2
*0x0a: AS923-3
Sub-Band: value 0x00 ~ 0x08(only for CN470, AU915,US915. Others are0x00)
BAT: shows the battery voltage for SAC01L.
Ex1: 0x0CD2 = 3282mV
Use can also get the Device Status uplink through the downlink command:
Downlink: 0x2601
2.4.2 Uplink FPORT=2, Real time sensor value
SAC01L will send this uplink after Device Status uplink once join LoRaWAN network successfully. And it will periodically send this uplink. Default interval is 20 minutes and can be changed.
Uplink uses FPORT=2 and every 20 minutes send one uplink by default.
Size(bytes) | 2 | 1 | 4 | 4 | 4 |
---|---|---|---|---|---|
Value | BAT | MOD | sysTimeCurrent | OUT | INT |
Example Payload (FPort=2): 0C D2 01 00 00 00 04 00 00 00 02
BAT:
- Example1: 0x0CD2/100=3.282
- Example2: 0xCD8/100=3.288
MOD:
- MOD: 0x01=1
sysTimeCurrent:
SAC01L use Unix TimeStamp format based on:
Users can get this time from the link: https://www.epochconverter.com/ :
Below is the converter example.
Ex:66B5C1B0=2024-08-09 07:13:52
So, we can use AT+TIMESTAMP=1723187632 or downlink 66B5C1B0 to set the current time 2024 – August -- 9 Friday 07:13:52
OUT
- Example1: 0x00000004=4
INT
- Example1: 0x00000002=2
INT and OUT can be customized according to the situation, just swap the positions of INT and OUT in the decoder.
2.4.5 Decoder in TTN V3
In LoRaWAN protocol, the uplink payload is HEX format, user need to add a payload formatter/decoder in LoRaWAN Server to get human friendly string.
In TTN , add formatter as below:
Please check the decoder from this link: https://github.com/dragino/dragino-end-node-decoder/tree/main/SAC01L
2.6 Datalog Feature
When user want to retrieve sensor value, he can send a poll command from the IoT platform to ask sensor to send value in the required time slot.
2.6.1 Unix TimeStamp
Unix TimeStamp shows the sampling time of uplink payload. format base on
User can get this time from link: https://www.epochconverter.com/ :
For example: if the Unix Timestamp we got is hex 0x60137afd, we can convert it to Decimal: 1611889405. and then convert to the time: 2021 – Jan -- 29 Friday 03:03:25 (GMT)
2.6.2 Poll sensor value
User can poll sensor value based on timestamps from the server. Below is the downlink command.
Timestamp start and Timestamp end use Unix TimeStamp format as mentioned above. Devices will reply with all data log during this time period, use the uplink interval.
For example, downlink command
Is to check 2020/12/1 07:40:00 to 2020/12/1 08:40:00's data
Uplink Internal =5s,means SAC01Lwill send one packet every 5s. range 5~255s.
2.8 LED Indicator
The SAC01L has a triple color LED which for easy showing different stage.
In a normal working state:
- When the node is restarted, BLUE are sequentially lit.
- During OTAA Join:
- For each Join Request uplink: the GREEN LED will blink once.
- Once Join Successful: the GREEN LED will be solid on for 5 seconds.
- After joined, for each uplink, the BLUE LED or GREEN LED will blink once.
- BLUE LED when external sensor is connected
- GREEN LED when external sensor is not connected
2.9 Button
Press the button SAC01L will reset and join network again.
3. Configure SAC01L via AT command or LoRaWAN downlink
Use can configure SAC01L via AT Command or LoRaWAN Downlink.
- AT Command Connection: See FAQ.
- LoRaWAN Downlink instruction for different platforms: IoT LoRaWAN Server
There are two kinds of commands to configure SAC01L, they are:
- General Commands:
These commands are to configure:
- General system settings like: uplink interval.
- LoRaWAN protocol & radio-related commands.
They are the same for all Dragino Devices which supports DLWS-005 LoRaWAN Stack(Note**). These commands can be found on the wiki: End Device Downlink Command
- Commands special design for SAC01L
These commands are only valid for SAC01L, as below:
3.1 Downlink Command Set
Command Example | Function | Response | Downlink |
---|---|---|---|
AT+TDC=? | View current TDC time | 1200000 | Default 1200000(ms) |
AT+TDC=300000 | Set TDC time | OK | 0X0100012C: |
ATZ | Reset node | 0x04FF | |
AT+FDR | Restore factory settings | 0X04FE | |
AT+CFM=? | View the current confirmation mode status | 0 | Default 0 |
AT+CFM=1 | Turn on confirmation mode | OK | 0x0500: close |
AT+CHE=? | View the current sub-band select 0-7, the default is 0 | 0 | Default 0 |
AT+CHE=2 | Set subband to 2 | Attention:Take effect after ATZ | 0X0702: |
AT+WMOD=? | View the current alarm mode status | 0 | Default 0 |
AT+WMOD=1 | Turn on alarm mode | Attention:Take effect after ATZ | 0xA501: open |
AT+CITEMP=? | View the current temperature detection time interval | 1 | Default 1(min) |
AT+CITEMP=2 | Set the temperature detection time interval to 2min | OK | 0XA70002 |
AT+NJM=? | Check the current network connection method | 1 | Default 1 |
AT+NJM=0 | Change the network connection method to ABP | Attention:Take effect after ATZ | 0X2000: ABP |
AT+RPL=? | View current RPL settings | 0 | Default 0 |
AT+RPL=1 | set RPL=1 | OK | 0x2101: |
AT+ADR=? | View current ADR status | 1 | Default 0 |
AT+ADR=0 | Set the ADR state to off | OK | 0x2200: close |
AT+DR=? | View the current DR settings | OK | |
AT+DR=1 | set DR to 1 | OK | 0X22000100: |
AT+TXP=? | View the current TXP | OK | |
AT+TXP=0 | set TXP to 0 | OK | 0X22000100: |
Upload node configuration or DS18B20 ID | 0X2301:Upload node configuration | ||
AT+DWELL=? | Check the high-rate upload settings | 1 | Default 1 |
AT+DWELL=1 | Set high rate upload | Attention:Take effect after ATZ | 0x2501: close |
AT+RJTDC=? | View current RJTDC set time | 20 | Default 20(min) |
AT+RJTDC=10 | Set RJTDC time interval | OK | 0X26000A: |
Retrieve stored data for a specified period of time | 0X3161DE7C7061DE8A800A: | ||
AT+DDETECT=? | View the current DDETECT setting status and time | 0,1440 | Default 0,1440(min) |
AT+DDETECT=1,1440,2880 | Set DDETECT setting status and time | OK | 0X320005A0: close |
Downlink Modification Alarm Mode | 0XAA010002000F00032: |
3.2 Set Password
Feature: Set device password, max 9 digits.
AT Command: AT+PWORD
Command Example | Function | Response |
AT+PWORD=? | Show password | 123456 |
AT+PWORD=999999 | Set password | OK |
Downlink Command:
No downlink command for this feature.
4. FAQ
4.2 AT Command and Downlink
Sending ATZ will reboot the node
Sending AT+FDR will restore the node to factory settings
Get the node's AT command setting by sending AT+CFG
Example:
AT+VER=EU868 v1.0
AT+NJM=1
AT+DEUI=25 32 12 45 65 26 12 35
AT+APPEUI=25 32 12 45 65 26 32 16
AT+APPKEY=25 32 12 45 65 26 32 16 89 48 85 65 45 87 89 55
AT+DADDR=00 00 00 00
AT+APPSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
AT+NWKSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
AT+NWKID=00 00 00 13
AT+ADR=1
AT+DR=5
AT+TXP=0
AT+CHS=0
AT+CLASS=A
AT+CFM=0
AT+JN1DL=5000
AT+JN2DL=6000
AT+RX1DL=5000
AT+RX2DL=6000
AT+RX1WTO=24
AT+RX2WTO=6
AT+RX2FQ=869525000
AT+RX2DR=0
AT+RPL=0
AT+FCU=6
AT+FCD=0
AT+CFS=0
AT+NJS=1
AT+DCS=0
AT+PNM=1
AT+PWORD=123456
AT+EXT=1
AT+TDC=120000
AT+TIMESTAMP=1640851037 2021 12 30 7 57 17
AT+RJTDC=20
AT+DDETECT=0,1440
AT+WMOD=0
AT+CITEMP=1
AT+ARTEMP=-40,125
4.3 How to upgrade the firmware?
SAC01L requires a program converter to upload images to SAC01L, which is used to upload image to SAC01L for:
- Support new features
- For bug fix
- Change LoRaWAN bands.
User can check this link for the detail of operation of firmware upgrade: Firmware Upgrade Instruction
4.4 How to change the LoRa Frequency Bands/Region?
User can follow the introduction for how to upgrade image. When download the images, choose the required image file for download.
5. Order Info
5.1 Main Device
Part Number: SCA01L-XX
XX : The default frequency band
- AS923: LoRaWAN AS923 band
- AU915: LoRaWAN AU915 band
- EU433: LoRaWAN EU433 band
- EU868: LoRaWAN EU868 band
- KR920: LoRaWAN KR920 band
- US915: LoRaWAN US915 band
- IN865: LoRaWAN IN865 band
- CN470: LoRaWAN CN470 band
6. Packing Info
Package Includes:
- SAC01L x 1
7. Support
- Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
- Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to support@dragino.com.
8. FCC Warning
This device complies with part 15 of the FCC Rules.Operation is subject to the following two conditions:
(1) This device may not cause harmful interference;
(2) this device must accept any interference received,including interference that may cause undesired operation.
9. Appendix I:According to the use
Installed in the middle of the aisle threshold, it can detect the entire aisle to avoid omissions.
When pedestrians pass by, the image can be viewed through the host computer.