AgroSense LoRaWAN® Sensor Instruction Manual

Product link: AgroSense LoRaWAN® Sensor

1. Feature

• Compatible with Worldwide LoRaWAN® Networks: Support the universal frequency plan from 863MHz ~928MHz;

• Long Range: At least 2km in urban scenes and 5 km in line of sight scenes.

• Battery& Working time: Sensor hardware& firmware detailed designed for power control, with 2 pcs common AAA battery, working time at least 2 years.

• Simple to Use: Provides LoRaWAN® DEV EUI/ APP EUI/ APP Key, enabling users to finish configuration in a few steps.

• Cost-effective: With Makerfabs’ strong ability on production, we make this product cost-effective to users, for mass implement in field applications such as farm/greenhouse, etc.

• Downlink: Support downlink to modify the time interval (5min-1440min).

• LoRaWAN version: LoRaWAN Specification 1.0.3.

2. Product model:

• AgroSense_Barometric Pressure Sensor LoRaWAN®

• AgroSense_Light Intensity Sensor LoRaWAN®

• AgroSense_Air Temperature and Humidity Sensor_AHT20 LoRaWAN®

• AgroSense_Temperature and Humidity Sensor_SHT31 LoRaWAN®

• AgroSense_RTD PT1000 Temperature Sensor LoRaWAN®

• AgroSense Soil Moisture Sensor LoRaWAN®

• AgroSense-carbon dioxide（CO2) sensor LoRaWAN®

• AgroSense_Positioning Water Leak Sensor LoRaWAN®

• AgroSense_None-Position Rope Type Water Leak Sensor LoRaWAN®

3. Usage

Step1：Battery Installation Open the product case， and insert two AAA batteries into the battery compartment. Press button Useror RST, if the LED does not light up, please check if the battery is dead and needs to be replaced or if the battery is installed backward. If LED flashes then the device is successfully powered up.

Step2：Server Configuration

Ensure your gateway works fine, and connect AgroSense LoRaWAN® Sensor to the IoT Server.

Step3: wall-mounted use

Tighten the screws on the four corners of the case after putting the cover on, Wall mounting the product for use.

4. TTN and ThingSpeak

4.1 TTN configuration

• Open The Things Network and register an account.

• Select the correct region.

• Create new application.

• Enter your Application ID, and click "Create application"

• Click "+ Register end device"

• Choose "Enter end device specifics manually"

• Select the three options as shown in the image below.(Take 868 for example)
• Enter you joinEUI, DevEUI, Appkey data.

Notice: On the AgroSense LoRaWAN® Sensor label, you can get DVE EUI, APP EUI, APP KEY data. Enter them in "Provisioning information" correctly.

AgroSense LoRaWAN® Sensor label	<-->	Provisioning information
APP EUI	<-->	JoinEUI
DEV EUI	<-->	DevEUI
APP KEY	<-->	AppKey

• Press AgroSense LoRaWAN® Sensor's Botton User and wait a few seconds after led flashes, if you find that led flashes a second time, it proves that the network connects successfully.

4.2 Payload formatters

Navigate to Payload formatters, select Formatter type to Custom Javasript formatter, Then select the type of product and copy the following code:

Agrosense-Decoder

4.3 Parsing data

After the TTN acquires the data, please parse the data according to the data format to obtain the sensor data.

4.3.1 AgroSense_Barometric Pressure Sensor

Example: 0x00, 0x02, 0x1C, 0x00, 0x9A, 0x7E, 0xAA, 0x00, 0x00

Data parsing：

• Battery voltage is 2.8 V.

• Atmospheric pressure is 101249.70 Pa

4.3.2 AgroSense_Light Intensity Sensor

Example: 0x00, 0x03, 0x1D, 0x00, 0x00, 0x22, 0xD4, 0x00, 0x00

Data parsing：

• Battery voltage is 2.9V.

• Light Intensity is 89.16 lx

4.3.3 AgroSense_Air Temperature and Humidity Sensor

Example: 0x00, 0x04, 0x1D, 0x01, 0x89, 0x00, 0xF8, 0x00, 0x00

Data parsing：

• Battery voltage is 2.9V.

• Humility is 39.3%

• Temperature is 24.8 ℃.

4.3.4 AgroSense Temperature and Humidity Sensor_SHT31

Example: 0x00, 0x04, 0x1D, 0x01, 0x89, 0x00, 0xF8, 0x00, 0x00

Data parsing：

• Battery voltage is 2.9V.

• Humility is 39.3%

• Temperature is 24.8 ℃.

4.3.5 AgroSense_RTD PT1000 Temperature Sensor

Example: 0x00, 0x03, 0x1D, 0x00, 0xB8, 0x00, 0x00, 0x00, 0x00

Data parsing：

• Battery voltage is 2.9V.

• Industrial Temperature is 18.4 ℃

4.3.6 AgroSense Soil Moisture Sensor

Example: 0x00, 0x08, 0x05, 0xC7, 0x1E

Data parsing：

• Soil ADC value is 1479.

• Battery voltage is 3.0V.

4.3.7 AgroSense-carbon dioxide（CO2) sensor

Example: 0x00, 0x01, 0x28, 0x02, 0x06

Data parsing：

• Battery voltage is 4.0V.

• CO2 is 518 ppm

4.3.8 AgroSense_Positioning Water Leak Sensor

Example: 0x00, 0x03, 0x1D, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x03

Data parsing：

• Battery voltage is 2.9 V.
• water leakage symbol is 0.(Normal state)
• Number of leaks is 2.
• Length of last leak is 3s.

4.3.9 AgroSense_None-Position Rope Type Water Leak Sensor

Example: 0x00, 0x03, 0x1D, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x03

Data parsing：

• Battery voltage is 2.9 V.
• water leakage symbol is 0.(Normal state)
• Number of leaks is 2.
• Length of last leak is 3s.

4.4 Data Parsing to ThingSpeak

1.1 Create a Channel: - Log in to ThingSpeak.
- Click on “My Channels”.
- Click on “+ New Channel”.
- Fill in the Channel name and field names (e.g., Field1: Temperature, Field2: Humidity).
- Click on “Save Channel”.

1.2 Obtain the Write API Key：

• Open the newly created Channel.
• Click on the “API Keys” tab.
• Copy the “Write API Key”.

2.1 Configure Payload Formatter：

• In the device details page, click on the “Payload Formatters” tab.
• Click on the “Uplink” tab.
• Select “Custom JavaScript Formatters”.
• Write JavaScript code to parse the binary data sent from the device.
• Finally click "Save changes".

2.2 Configure Webhooks：

• In the application page, click on the “Integrations” tab.
• Select “Webhooks”.

• Click on “+ Add webhook”.

• Choose the “ThingSpeak” template.

• Fill in the following information and click on “Create ThingSpeak webhook”.

Webhook ID	<-->	Any unique ID
Channel ID	<-->	Your ThingSpeak Channel ID
API Key	<-->	Your ThingSpeak Write API Key

• Press AgroSense LoRaWAN® Sensor's Botton User , you will successfully see the data in Thingspeak.

5. Datacake

1、Login datacake or Create Account.

2、Click “Add Device”.

3、Select LoRaWAN and click “Next”.

4、Select a Product based on your needs, take "Create new empty product" as an example.

5、Select “Datacake LNS”.

6、Enter DEVEUI、APPEUI、APPKEY、FREQUENCY and DEVICE CLASS.

7、Choose the type according to your needs, and click “Add 1 device”.

8、Click to go to the device you just added.

9、Click “Configuration”, enter Decoder and click “Save”.

10、Follow the steps to add a field.

11、Press RST button, wait until the sensor connects to the gateway successfully, you will see the data the sensor is currently reading.

12、To get a better look at the data, we can add widget. Click “Dashboard-->switch-->+ Add Widget”.

13、Select “Value” and set Title, Field and presentation form as well as the interval color.

14、Select Chart and set Title, Field, Kind, Line Thickness and click “save”.

15、Select Device Fields, check “Fields” and click “Save”.

16、Click the switch to save, and you can see the data visually.

6. Downlink

AgroSense devices support adjusting the time interval using downlink. Here's a guide to using downlink at TTN and Datacake.

6.1 TTN

• Click “Payload formatters-->Downlink” and follow the steps.

Formatter code you can find in Github.

• Click “Save changes”.

• Click “Messaging-->Schedule downlink”.

Note: you must use this format:

{
  "minutes": 5
}

• The modified interval will be updated after the next data upload.

6.2 Datacake

• Click “Configuration-->Fields-->+Add Field”.

• Click ”Downlink-->Add Downlink”.

Enter name、description、fields used and payload encoder respectively.

Name: Set User-Defined Sending Time Interval.

Description: Set the user-defined report transmission interval and store it in the configuration variable.(5Min-1440Min).

Payload Encoder: copy in Github.

• Click “Dashboard-->switch-->+ Add Widget”.

• Select “Downlink” and setting as follow image.

• Click the switch to save, and you can click to change your time Interval.

7. Resource

Github

AgroSense LoRaWAN Sensor Catalogue