SX1268LORAHAT用户手册

1、SX1268 LoRa HAT用户手册产品概述本产品是基于SX1268芯片，具有LoRa调制功能无线串口模块的树鞋派扩展板。具有多级 中继实现超远距离通信，低功耗唤醒通信、加密传输等优点。提供完善的配套树俅派（python例程）、STM32例程。产品特性板我树辘派接 口，可宜接接入 Raspberry Pi Zero/Zero W/Zero WH/2B/3B/3B+支持全球免许可ISM 433MHz频段，支持470MHz抄表频段。板我CP2102 USB转UART芯片，方便进行串口调试引出模组UART等控制接口，方便接入Arduino/STM32等主控板板载4个LED指示灯，方便查看模块运行状

2、态支持波特率范围：1200bps115200bps（默认为9600bps）,支持0.3k62.5kbps数据传输速率支持空中唤醒，即超低功耗功能，适用于电池供电的应用方案：支持定点传输、广播传输、信道监听，多级中继用于超远距离通信支持RSSI信号强度指示功能，用于评估信号质量、改善通信网络支持LBT功能，在发送前监听信道环境噪声，可极大提高模块在恶劣环境下的通信成功率 LoRa扩频技术，多达84信道可选支持空中唤醒，在线配置，载波监听，自动中继，通信密钥，低功耗休眠理想环境下通信距离可达5KM,双天线可选（IPEX/邮票孔）提供完善配套资料手册（Raspberry/STM32等示例程序）我的参

3、数功耗发射电流100mA （瞬时功耗）最大发射功率 发射长度 缓存容量 工作频段 接收灵敏度 空中速率 通信接口 参考距离接收电流11mA休眠电流2uA（LoRa模组深度休眠）22. OdBmdO. 13、17、22dBm 软件选择）240Byte（32. 64、128、24OByte 软件选择）lOOOByte410. 125493. 125MHz-147dBm 0. 3Kbps 空中速率0. 3K62.5Kbps （可软件选择）UART5KM（晴朗空旷,天线增益5dBi,天线高度2.5米，空中速率2.4kbps）我的其它参数供电电压逻辑电平工作温度产品尺寸5V3. 3V/5V-40、856

4、5mmX 35mm目录 TOC o 1-5 h z HYPERLINK l bookmark3 o Current Document 产品概述1 HYPERLINK l bookmark5 o Current Document 产品特性1 HYPERLINK l bookmark7 o Current Document 我的参数2我的其它参数2 HYPERLINK l bookmark11 o Current Document 硬件介绍4 HYPERLINK l bookmark13 o Current Document 寄存器配置5寄存器描述8 HYPERLINK l bookmark15

5、o Current Document 调试12 HYPERLINK l bookmark17 o Current Document 串口测试13使用14树库派14下载树锥派树例程14 HYPERLINK l bookmark24 o Current Document 拷贝到树馋派14安装必要的函数库17打开树馋派SERIAL串口17 HYPERLINK l bookmark26 o Current Document 运行透传通信测试代码18 HYPERLINK l bookmark34 o Current Document 运行中继通信测试代码22 HYPERLINK l bookmark40

6、 o Current Document 运行唤醒通信测试代码24 HYPERLINK l bookmark42 o Current Document STM3226 HYPERLINK l bookmark44 o Current Document 硬件连接26 HYPERLINK l bookmark46 o Current Document 预期效果27硬件介绍LoRa模式选择模式(0-3)Ml MO模式介绍备注0传输模式00 串口打开，无线打开，透明传输支持特殊指令空中配置1 WOR模式01可定义为WOR发送方和WOR接收方低功耗，支持空中唤醒2配置模式10 可用串口对寄存器进行访问，改

7、变模块工作状态3深度休眠 11 LoRa模组进入休眠.将Ml、M0进行高低电平组合，确定工作模式，其中Ml、M0默认高电平，切换工作模式 后，若模块空闲，则进入新的工作模式，否则将处理完当前发射接收后再进入新工作模 式。2,模式0,用户串口输入数据后，模块启动无线发射，空闲时，无线接收功能打开，接收到 数据串口 TXD输出。.模式1,当定义为发射时，发射前自动增加定时间唤醒码，接收等同于模式0。4,模式2,无线收发功能关闭，用户可以参造寄存器配置设置寄存器。.模式3,无线收发关闭，进入深度休眠模式，当进入其他工作模式，模块重新配置参数0寄存器配置配置模式（模式2： Ml=l M0=0）下，支持

8、的指令列表如下（设置时，只支持9600, 8N1格 式）：序号指令功能详细说明1设置寄存 器指令：C0+起始地址+长度+参数响应：C1+起始地址+长度+参数例1：配置信道为0 x11指令起始地址长度 参数发送： C0050111返回： C1050111例2:同时配置模块地址(0 x1234)、网络地址(0 x00)、串口(9600 8N1)、空速(1.2K)发送：C0 00 04 12 34 00 61返回：C100 04 12 34 00 612读取寄存 器指令：C1+起始地址+长度响应：C1+起始地址+长度+参数例1:读取信道指令起始地址长度 参数发送：C1050111返回：C105011

9、1例2:同时读取模块地址、网络地址、串口、空速发送：C0 00 04返回：C1 00 04 12 34 00 613设置临时 寄存器指令：C2+起始地址+长度+参数响应:C1+起始地址+长度+参数例1：配置信道为0 x11指令起始地址 长度 参数发送：C2050111返回：C1050111例2:同时配置模块地址(0 x1234)、网络地址(0 x00)、串口(9600 8N1)、空速(1.2K)发送：C2 00 04 12 34 00 61返回：C1 00 04 12 34 00 614无线配置指令：CF CF+常规指令响应：CF CF+常规响应例1：无线配置信道为0 x11无线指令头指令起始

10、地址 长度 参数发送：CFCFC2050111返回：CFCFC1050111例2:无线同时配置模块地址(0 x1234)、网络地址(0 x00)、串口(9600 8N1)、空速(1.2K)发送：CF CF C2 00 04 12 34 00 61返回：CF CF C1 00 04 12 34 00 615格式错误格式错误响应FF FF FF注意：.使用无线配置时，应先配置两个模块地址、NETID、空速和密钥，使之参数相同，再使用CFCF 指令格式进行无线配置。例如：模块A地址、NETID、空速和密钥为1、1、2.4Kbps和1,模 块B地址、空速和密钥为2、2、62.5kbps和2,若模块A要

11、无线配置模块B,须先将模块A 的地址、NETID、空速和密钥设置为模块B的参数，然后再使用CFCF指令无线配置模块B。.设置临时寄存器后，LoRa模组将使用临时寄存器的值工作，掉电重启后，临时寄存冰的值丢 失，LoRa模块会重新设置寄存器。设置值为上次使用C1指令格式配置的值。寄存器描述序号读写名称描述备注00H读/写ADDHADDH（默认 0）模块地址高字节和低字节注意：当模块地址等于FFFF时，可作为 广播和监听地址，此时模块将不再进行地 址过滤01H读/写ADDLADDL（默认 0）02H读/写NETIDNETID（默认 0）网络地址，用于区分网络，相互通信时， 应设置为相同。03H读/

12、写REGO765UART 中 口速率（bps）000由口波特率为1200相互通信的两个模块，串口波特率可以不 同，校验方式也可以不同：当连续发射较大数据包时，用户需耍考虑 波特率相同带来的数据阻塞，甚至可能丢 失；般建议通信双方波特率相同001申口波特率为2400010市口波特率为4800011中口波特率为9600（默认）100串口波特率为19200101串口波特率为38400110中口波特率为57600111出口波特率为11520043中口校验位通信双方串口模式可以不同；008N1（默认）01801108E1118N”等同于00）210无线空中速率（bps）通信双方空中速率必须相同：空中速率

13、越高，延迟越小，传输距离越 短。000空中速率0.3K001空中速率1.2K010空中速率2.4K（默认）011空中速率4.8K100空中速率9.6K101空中速率19.2K110空中速率38.4K111空中速率62.5K04H读/写REG176分包设定用户发送数据小于分包长度，接收端串口 输出呈现为不间断连续输出：用户发送数据大于分包长度，接收端串口 会分包输出。00240字节（默认）01128字节1064字节1132字节5环境噪音使能启用后，可在传输模式或WOR发送模 式发送指令CO Cl C2 C3指令读取寄存 器：寄存源0 x00 ：当前环境噪声 RSSI：寄存器0X01 ：上次接收数

14、据 时的RSSI （当前信道噪声为：dBm=- RSSI/2）：指令格式：C0C1C2 c3+起始 地址+读取长度；返回：C1+地址+读取 长度+读取有效值;如:发送CO Cl C2 C3 00 01返回Cl 00 01 RSSI （地址只能从 00开始）0禁用（默认）1启用432保希10发射功率功率和电流是非线性关系，最大功率时， 电源效率最高；电流不会随功率降低而 同比例降低。0022dBm（默认）0117dBm1013dBm11lOdBm05H读/写REG2信道控制（CH）O83分别代表总共84个信道实际频率=410.125+ CH默认433.125MHz06H读/写REG37启用RSS

15、I字节启用后，模块收到无线数据，通过串口 TXD输出后，将跟随个RSSI强度字 节。0禁用（默认）1启用6传输方式定点传输时，模块会将串口数据的前三个 字节识别为：地址高+地址低+信道，并 将其作为无线发射目标。0透明传输（默认）1定点传输5中继功能中继功能启用后，如果目标地址不是模块 自身，模块将启动次转发；为了防止 数据回传，建议和定点模式配合使用； 即：目标地址和源地址不同。0禁用中继功能（默认）1启用中继功能4LBT使能0禁用（默认）启用后，无线数据发射前会进行监听，可 以在定程度上避开干扰，但可能带来 数据延迟：LBT最大停留时间2秒，达 到两秒会强制发出。1启用3WOR模式收发控制

16、仅针对模式1有效；WOR接收方收到 无线数据并通过串口输出后，会等待 1000ms后才再次进入WOR,用户可以 在此期间输入串口数据并通过无线返 回：每个串口字节都会刷新1000ms时 间：用户必须在1000ms内发起第个 字节。0WOR接收方（默认）模块收发打开,且在发射数据时. 加入一定时间的唤醒码。1WOR发射方模块无法发射数据,I：作再WOR 监听模式,可以节省大量功耗。210WOR周期仅针对模式1有效；周期T=（l+WOR） *500ms,最大 4000ms,最小为500ms： WOR监听间隔周期时间 越长，平均功耗越低，但数据延迟越 大：收发双方必须致（非常重要）000500ms0

17、011000ms0101500ms0112000ms1002500ms1013000ms1103500ms1114000ms07h写CRYPT_H密钥高字节（默认0）只写，读取返回0：用于加密，避免被 同类模块截获空中无线数据；模块内部 将使用这两个字节作为计算因子对空中 无线信号进行变换加密处理。08H写CRYPT.L默认低字节（钛认0）80H-86H读PID产品信息7字节产品信息7个字节调试串口测试.准备两个SX1268LoRaHAT模块（以下统称Lora模块），两根Micro USB线,装配SMA 天线，跳帽置于A上，M0和Ml连接GND。. WINDOWS PC上安装CP2102驱动，

18、两个Lora模块使用Micro USB连接至PC。.打开PC设备管理器，查找CP2102对应的两个COM 口，使用SSCOM串口软件分别连 接两个Lora模块，波特率都设置为9600. Dtsa.Sfi好懵 RneiU!K FJH3?kv V RC(COMQLPT)9 Skon Labs CP210 x USB to UAR7 Bridge (CCW22J 9 Sifcon Labs CP210 xVS8to UART Bridge (COM3) . V aE X0M1)iE4SI计目质串Q二鹿用人Ei入S1m声音妙ass神0 陪2JlaWS f斯本行e蝮翎H)三拿没中月树eaHSR细甲昱同U

19、晋题入34.其中,个SSCOM串口软件的输入栏输入数据，点击发送按钮，在另一个SSCOM串口软 件显示栏可以看到LoRa模块收到的数据。ft SSCOVVS *3.t -x 怖 SSCCMglNO匚稗咕.- X遇艮a口 口em i示 鳍 多亨行小工H MS!联挈性遇用;口”口包3显示 友是 多会落 小工只 总 联导作上，巴二竺三 F，/三 也上,到口: “CBH曲至与3元廨可:/！（分22n初3 CP21OV4 A名称八修改日期蝇大小overlays2018/9/12 J 0:58文件夹| RaspberryPi 2018/11/2417:27bcm2708.rpi0.wdtb、2018/6/

20、19 12:06DTB文件22 KBbcm2708-rpi-b.dtb2018/6/19 12:06DTB文件22 KBbcm2708- rpi-b- plus.dtb2018/6/19 12:06DTB文件22 KB如下: 然后弹出U盘，将SD卡插入树俅派中，插上USB上电，查看/boot目录的文件:Is /bootploraspberrypi:- $ Is /boot/b(ii2798-rpl-G-w.dtb b(fi2708-rpi-b.dtb bcn?708-rpi-b-plus.dtb txn27O0-rpi-cra.dtb bcm2Z09-rpi-2-b.dtbbcw2710-rp

21、l-3-b.dtb lxii2710-rpl-3-b-plus . dtb txw2710-rpi-cmJ.dtb bootcode.bin cmdline.txtconfig.txtCOPYING.IInux fixup cd.dat fixup.dat fixup db.datflxup_x.dat FSCKmO.RECFSCK9G91.REC issue.txt kernel/, imq kernel. Ing LICENCE, broadc o IICENSE. oracle overlaysstartled.elf start-db.elf startTelf startx.elfS

22、ystn volune infomation执行如下命令将其复制到用户目录下，并修改其用户权限:sudo cp -r /boot/RaspberryPi/ . /piraspberrypi：- $ sudo cp -r /boot/RaspberryPi/ ./ piQraspberrypi：- $ Iscode libcode I RdspberrvPil RPIlib ubuntu usbdisk piraspberrypi：- $ sudo chmod 777 -R RaspberryPi/ piQraspberrypi$ Iscode libcode |RaspbLyPi | RPIl

23、ib ubuntu usbdisksudo chmod 777 -R RaspberryPi/进入目录，查看文件:piraspberrypi：- $ cd Raspb&rryPi piraspberrypi：-/RaspberryPi $ Is Light Sensor Servo Driver test web_Python piQraspberrypi;-/RaspberryPi $ |安装samba服务方式Samba是在Linux上实现SMB协议的个免费软件，由服务琳及客户端程序构成，是种在局 域网上共享文件和打印机的种通信协议，我们可以使用访问局域网设备的方式来复制文件。安装 samb

24、a: sudo apt-get install samba samba-common-bin然后需要修改配置文件：sudo vi /etc/samba/smb. confft By default, the home directories are exported read-only Change the # next parameter to no if you want to be able to write to them.0ead only = no找到 193 行，把read only = yes” 修改成 read only = no然后重启 samba 服务：sudo /etc

25、/init. d/samba restart添加默认用户 pi 到 samba： sudo smbpasswd -a pi输入访问密码，需要两次都要一样，注意输入密码的时候是没有光标提示的。piraspberrypi:- $ ifconfigethO: flaqs=4163UP,BROADCAST,RUNNING,MULTICAST mtu 1500inetj192,168.6.142 jnetmask 255.255.255.0 broadcast 192.168.6.255 ine16e8o7Ta821 Id62f:dl3d:93al prefixlen 64 scopeid 0 x20

26、ether b8:27：eb:26:26:8b txqueuelen 1000 (Ethernet)RX packets 21161 bytes 1198959 (1.1 MiB)RX errors 0 dropped 0 overruns 0 frame 0TX packets 644 bytes 75391 (73.6 KiB)TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0查看树藤派IP地址：这里使用的是有线，如果使用的是无线连接，那么将会在wlanO中查看IP地址。然后在windows卜打开-我的电脑，在地址栏输入IP,并加

27、pi&S网珞僦-个 Im 192.169.6.142pi此时会弹出个框，用户名输入pi,密码输入之前设置的密码。即可访问树寿派了，将解压文 件中RaspberryPi文件夹复制到根目录： 阿洛 192.168.6.142 pivz4A 名窗八修改习期大小Jcode2018/11/15 16:30文件去ylibcode2018/8/29 10:49文件夹4I RaspberryPi2018/11/26 19:35Rllib2018/9/28 16:40文件夹ubuntu2018/9/17 16:01文件夹usbdisk2018/9/30 15:52文件突安装必要的函数库需要安装必要的函数库（py

28、thon库），否则以下的示例程序可能无法正常工作。安装方法详 见：（如果是新系统请按照如下进行操作，若已经安装好以下的库可跳过）安装python库：sudo apt-get install python-pipsudo pip install RPi. GPIOsudo apt-get install python-smbussudo apt-get install python-serial打开树莓派SERIAL串口sudo raspi-configaspoerry Pi Software Configuration Tocl (raspi-config)卜Change User Passw

29、ord Change passwo rd for the current userNetwork Options Configure network settingsBoot Options Configure options for start-upinterfacing options configure connections to peripherals-oslisnticn Options Set up langsgQ 3ndgionnl settings to match your locationOverclockConfigure overclocking for your P

30、iAdvanced Options Configure advanced settingsUpdateUpdate this tool to the latest versiong About raspi-config Infonr.aticn about this configuration tool弋Finish1 ixadpk/Ci i y r xvvi i xui c lvi i i vw l i oopx - win x/|Pl CameraEnable/Disableconnection to the Raspberry Pi CameraP2 SSHEnable/Disabler

31、enote command line access to your Pi usingSSHP3 vncEnable/Disablegraphical remote access to your Pi usingRealVNCP4 SPIEnable/Disableautomatic loading of SPI kernel moduleP5 12cEnablo/Disabluautomatic loading of 12c kernql module6 Serial Enablc/D工sable shell and kernel mQssagqs on th。 sorial connect。

32、P7 1-Wir EnablG/DisablG onG-wir interfaceP3 Remote GPIO Enable/Disable renote access to GPIO pins更多参考内容在微雪课堂:would you like the serial port hardware to be enabled?运行透传通信测试代码广播通信输出ABCD0 x01 0 x01 0 x17 地址高地正低信道输出ABC1)不输出0 x03 0 x03 0 x18地址高地址低信道定点通信输出ABCD输入ABCD不输出0 x01 0 x01 0 x17 地址高地址低信道0 x01 0 x01

33、 0 x17 地址高地址依信道0 x02 0 x02 0 x17 地址高地址低信道不输出1.准备Raspberry Pi 3B+ （以下统称Pi3B+） , LoRa模块直接接入Pi 3B+的40Pin 口，跳帽置于B. M0和Ml由Pi 3B+的10控制，不再使用跳帽2.另,个LoRa模块通过Micro USB连接至PC,跳帽置于A, Ml和M0连接GND,打开X X.XBQ方力3. B43 tf M333n-等二1I IJEe* i44JS2a;: 昌昌8n进入RaspberryPi/transparent目录，输入指令sudo python transparent.py BROADCAS

34、T_AND_MONITOR,连接 Pi 3B+的 LoRa 模块约两秒广播,次数据，连接PC的LoRa模块收到并打印数据。同时，用户也可以在SSCOM串口软件输入并发送数据，Pi 3B+收到后打印数据。：*9B】t 5 0KWW 皿 UMlWaUi W4XA5T tfd KICh 9 ad qxI artudcjMt 5WI 0CW4CWara*dc*!? 一 “六bromol arcudeMt e btwdct -，” brokdcact m|1Wl br araadcMt (vui|7电址高 啮址帐irno。诵1x010 x020 x01 0 x17l）（）i ut 2relay20-与一

35、“point5output,晟隅地址马地址城XETID的道fftkl W J.HK EI1D Mlfl idl （ixii? OxiXi ihl70 x01 IHQG null 0M7HlhLffi 地址代 II0 frifi 0*010*020*03 O 1sbwxjrrr;cm 0口 ：gawiwKUxV 2八 OWV5.H 1 Z.UltSMZ*: t;T7OCl WC5BTIfO BOf ag Irtt -W 4ia & *? AKtmEM9atZ4AtAia! C6_ r- rri瑞整亘器萼票翳迈瑞嘉_3 :国二，作j厂百百可F：&a*&改彳可，? vam 工M，m.9 20MfO

36、r- aatMcrdule AZor”W. 1，加 pfthcA Ey.力wn 41Y 3cciA, 5a。”，*W0 1rcm a oy ahw.mic can a? xft *，缶，4-m wt * 乂8d工&5eMPX (Okr)， .： :.：? r 。了 二工 r 口-二 ,，厂行二一二?”不，二/(- 山里，退阂 ,3 1年? 厂必改r r传凌理Trxr *KaPHWM师X 1与1”如孱aB/小丸idcrg 习 r *tM夕西至等次5久g峨*0惶Hi上力 *VY*妗&太具中*门叼【力。再式IMJ *BR4W工早时霞口匕乂，klT 珈RWa，9患2再CMsBl：F “，分，*Ewwd

37、taxcn 公：0F-30COMZZEn开 OOOObxIl即运行唤醒通信测试代码唤醒通信是种低功耗操作的通信方式，数据接收会延迟，但模块的功耗小，可用于电池供电 的应用.1.使用串口软件SSCOM设置LoRa模块为WOR接收模式，完成后Ml接GND, M0不接。2.3.LoRa 模块 B 接入 Pi 3B+,进入目录/RaspberryPi/wor,输入指令 sudo python wor.pyoXshell上显示已经发送消息时，SSCOM软件会延迟段时间才能接收到.AM口 YZJi saQD DUD 尔WB EW 2HStii KI TtJKWrfXt .“ywre x VOB*.piii

38、cr ，q wor.pyN，VMlrC 0 mwWO 5*叫帧MJ期 簿皿 KXk Cwot m，”,“， wor Mt1|r2普工冈，。|.00力 w | nr/) f ：函*|r 必】-1. g-WJKIDI jafifJ厂 X*r： I /GW 1 碗 而L?匕-W*IW eiwld 2fiEaLFfm*9” - knjrf”碗一献/笨；公二2J CHO5S5 IJ 13 #-rJ.r3WC5ft.%i *7，和 E用 *TG 心班3匕4STM32本例程使用的开发板Openl03C,芯片为STM32F103CBT6,程序是基于HAL库硬件连接跳帽连接BSX1268 LoRa HATSTM325V5VGNDGNDRXDPA10TXDPA9MlPB15MOPB14 1 预期效果.连接电脑USB的LoRa模块的设置同以上三个例程相同。.打开Keil工程文档，在main.c文件第75行至I 77行使用不同的定义使用不同的通信方式#define TRASNSPARENT/ffdefine RELAY/ffdefine WOR透传通信1%V5.1 B.1 =二例-OX且艮口闩口制I至示双多手/小工具MR）联系不A K8打*运色I （U立切丁闪】tfi& it tvr.c14rr.t thir it aatt