这是本文档旧的修订版!


LORAWAN系统使用教程

该教程主要是指导客户怎么使用LORAWAN系统,该系统至少包含以下部分:

1.一个网关(RHF2S008P4G)

2.至少一个节点模块SX127x-052

3.NetServer 云

4.客户私有云

5.手机APP或者前端

该教程NetServer云使用LORIOT(https://www.loriot.io/login.html),该NetServer云支持全球部署,10个终端设备免费试用

使用前准备:

1.在LORIOT云( [[http://cn1.loriot.io |LORIOT云注册地址]] )后台注册一个账号。

2.LoRaWAN节点模块连接到串口,连线方式如下:


 LoRaWAN节点模块   串口模块

    VCC------------3.3V
    GND------------GND
  USART_RX-------USART_TX
  USART_TX-------USART_RX
  {{:lora:spec:loriot注册.png?300|}}

3.安装网关,网关具体连线方式请参考文档。{{ :lora:docs:aithinker_lorawan_iot_gateway_rhf2s008p4g_installation_guide_0.5.pdf |网关安装说明}}

下面具体列出操作步骤,实现子节点模块向LORIOT云上传数据。

网关RHF2S008配置

1.ssh登陆网关RHF2S008P4G

默认登录用户信息如下:

用户名: rxhf

密 码: risinghf

将RHF2S008P4G设备连接至DHCP路由器, 登录路由器或者采取IP扫描的方式发现RHF2S008P4G设备IP. RHF2S008P4G设备的主机名称为”rhf2s008”.

获取IP后, 用户可以通过SSH登录设备进行查看配置或者设置参数. Windows常用工具有PuTTY, TeraTerm. Linux用户可以直接使用SSH工具登录. SSH端口号为默认值22.

例如, 可以采用如下方式分别于Windows/Linux平台登录IP为192.168.1.221的RHF2S008P4G设备 Windows:

Linux

ssh rxhf@192.168.1.221

2.登陆LORIOT后台,[[https://www.loriot.io/login.html|LORIOT登陆地址]],把网关设备注册到平台上。

1)获取MAC地址,格式为xx:xx:xx:xx:xx:xx。MAC地址一般会贴在主机侧面。

2)访问http://cn1.loriot.io 注册账户,已注册账户的的用户请直接登录

3)进入Dashboard → Gateways → Add Gateway,选择RHF2S008平台

4).Radio front-end项选择, 匹配所选网关型号注册设备. 可选项有:

 a)868/915 MHz (SX1257)

 b)434/470/780 MHz (SX1255)

 c)注意: RHF2S008P4G-780MHz网关需选择” 868/915 MHz (SX1257)”

5)继续下拉,填入Mac地址,并根据提示信息填入网关位置信息

6)点击“Register RisingHF RHF2S008 Gateway”完成注册

7)点击“Go to the gateway detail page”或从左侧控制台上面点击“gateway xx:xx:xx:xx:xx:xx”进入配置页面

8)根据用户所选的网关频道选定频率方案,一般为CN434或者CN470(根据实际网关型号而定),或者其他所支持到的频率。

9)到此网关注册完成

10)连接网线,并将RHF2S008上电。如果已经上电,请在注册完成后重启设备

11)开始测试

3.启动Loriot服务

默认选择连接至cn1服务器, 选择Loriot服务器区域, 例如使用如下指令选择至ap1服务器

sudo su

cd /opt/loriot/bin

ln -sf ap1 lrt

替换ap1为af1 ap1 au1 cn1 eu1 sa1 us1可以分别选择不同的服务器区域.

设置开机启动:

sudo systemctl enable loriot-gw

启动:

sudo systemctl start loriot-gw

停止:

sudo systemctl stop loriot-gw

关闭开机启动:

sudo systemctl disable loriot-gw

注意: 设置当设置开机启动后, 用户如需切换至其他服务器, 请务必执行停止及关闭开机启动指令, 防止loriot-gw干扰其他服务.

4.配置网关频率

Loriot网关配置项均于云端配置, 打开Loriot控制台找到相应网关页, 可于Frequency plan处选择相应的频段. 具体频率定义请参阅Loriot频率定义表在线文档.

https://cn1.loriot.io/home/documentation.html#docu/frequency-plan

因为网关赠送的天线出厂时会根据客户需求匹配,请联系我司进行确认网关使用频率

5.使用gateway GPS模块

RHF2S008P4G内嵌GPS模块, 支持GPS功能, LoRaWAN Class B标配硬件.

如下指令可以用来简单测试GPS模块的功能.

sudo gpsctl on

stty -F /dev/serial1 9600 -raw -echo

cat < /dev/serial1

可以得到类似下面的信息

$GPRMC,095521.00,V,,,,,,,100417,,,N*74

$GPVTG,,,,,,,,,N*30

$GPGGA,095521.00,,,,,0,00,99.99,,,,,,*6C

$GPGSA,A,1,,,,,,,,,,,,,99.99,99.99,99.99*30

$GPGSV,4,1,13,01,70,146,,03,09,158,,07,75,257,,08,36,031,*77

$GPGSV,4,2,13,09,15,217,,11,80,034,,16,06,101,,17,14,253,*7D

$GPGSV,4,3,13,22,17,134,,23,05,183,,27,06,051,,28,20,314,*7B

$GPGSV,4,4,13,30,41,313,*4C

$GPGLL,,,,,095521.00,V,N*40

   


RHF76x-052节点模块配置

RHF76x-052内置LoRaWAN协议栈,不支持二次开发,通过at指令进行控制,具体at指令可以参考RHF76x-052指令文档。RHF76x-052指令文档

1.把RHF76x-052节点连接到电脑串口,打开电脑串口软件,默认波特率为9600,8个数据位,无校验位,1个停止位,没有流控,然后打开串口,输入“at”,若返回“+AT: OK”则证明电脑能够发送at指令给模块。

注意,输入at指令每次都要加回车换行符“\r\n”,否则默认为输入错误。

2.模块第一次上电建议恢复出厂模式,串口输入“AT+FDEFAULT”,如果成功则返回“+FDEFAULT: OK”,,输入“at+id”查看模块id信息

3.节点模块与网关之间的通讯必须频率一致,到Loriot后台查看网关频率

然后配置节点模块频率与网关频率一致。

a)输入“AT+CH”即可查看节点模块配置的频率

b)输入“at+ch=xx,xx”(通道数,频率)进行频率配置

例如根据Loriot后台查看网关频率所示,依次输入

“AT+CH=0,472.300”

“AT+CH=1,472.500”

“AT+CH=2,472.700”

“AT+CH=3,472.900”

“AT+CH=4,471.500”

“AT+CH=5,471.700”

“AT+CH=6,471.900”

“AT+CH=7,472.100”

如果每次配置成功,则返回当前配置频率和通道数

e.g AT+CH=0,472.3

Return:   +CH: 0,472300000,DR0:DR5

4.OTAA入网并且发送数据

a)每个节点要到后台进行注册,在后台页面Applications→SimpleApp→Enroll new device进行添加设备,在Device EUI文本框中填入步骤2得到DevEui,最后点击Enroll OTAA/ABP device ,则成功添加设备。

b)选择步骤a新添加的的节点,进入Device details页面,点击device guides页面

然后选择RisingHF Module / Modem,即可看到节点key配置指导,按照网页提示在串口依次配置DevEui,AppEui,APPKEY。

c)串口发送“at+mode=lwota”即可配置节点模块入网方式为OTAA模式。

d)串口发送“at+join”即可申请该节点入网,如果入网成功,则返回DevAddr

+JOIN: Starting

+JOIN: NORMAL, count 1, 0s, 0s

+JOIN: Network joined

+JOIN: NetID 4C5254 DevAddr a9:4b:5c:0a

+JOIN: Done

e)串口发送“AT+CLASS=A”即可配置为CLASS A模式

f)串口发送“AT+CMSGHEX=“xxxx””即可发送16进制信息,如果发送成功,即可返回图中信息。

5.ABP入网方式并且发送数据

a)每个节点要到后台进行注册,在后台页面Applications→SimpleApp→Enroll new device进行添加设备,在Device EUI文本框中填入步骤2得到DevEui,最后点击Enroll OTAA/ABP device ,则成功添加设备。

b)选择步骤a新添加的的节点,进入Device details页面,点击device guides页面

然后选择RisingHF Module / Modem,即可看到节点key配置指导,按照网页提示在串口依次配置DevAddr,NWKSKEY,APPSKEY。

c)串口发送“AT+MODE=LWABP”即可配置节点模块入网方式为ABP模式。

d)串口发送“AT+CMSGHEX=“xxxx””即可发送16进制信息,如果发送成功,即可返回图中信息。

注意:每次发送要有时间间隔,单发送数据后返回“+CMSGHEX: No band in 143638ms”,说明要过返回值时间后才能下次成功发送。