SX1302 LoRaWAN Gateway HAT

From Waveshare Wiki
Jump to: navigation, search
SX1302 LoRaWAN Gateway HAT
SX1302 LoRaWAN Gateway HAT




Onboard Interfaces


This is a communication HAT for Raspberry Pi with LoRaWAN protocol support, which incorporates the core LoRa gateway module SX1302 868M LoRaWAN Gateway. It has lots of advantages including long-range transmission, concurrent communication, large capacity node, and high receiving sensitivity. There are L76B GNSS module and Mini-PCIe socket on the baseboard for easy integration, along with our rich development resources, you can attach it to Raspberry Pi and build the LoRa network fast.


  • Standard Raspberry Pi 40PIN GPIO extension header, supports Raspberry Pi series boards
  • Incorporate L76B module with GPS/BD support, Gateway module for providing accurate clock and location info
  • Comes with development resources and manual (example in C)
  • Integrates Semtech SX1302 normal band and SX1250 radio RF frond-end chip, EU868 band
  • Onboard PA and LNA, features 26dBm emit power and -141dBm high sensitivity receiving gain
  • 10x signal channel supports multiple nodes concurrent communication and FEC (Forward Error Correction) algorithm
  • Supports SF5~SF12 spreading factor, 19Kbps MAX (SF5/BW125KHz) data rate
  • Utilizing SPI communication protocol and standard Mini-PCIe socket, for easy integration into sorts of embedded systems


Power supply 5V
Fequency range EU868 (863-870MHz) GPS L1 (1575.42MHz)
BD2 B1 (1561.098MHz)
Positioning accuracy - < 2.5m CEP
Modulation LoRa/(G)FSK -
Emit power > [email protected] -
Receiving sensitivity [email protected]/SF12
[email protected]/SF5
acquisition: -148dBm
tracking: -163dBm
re-acquisition: -160dBm
Overall power consumption emitting: [email protected] GPS on
receiving: [email protected] GPS on
sleep: [email protected] GPS off
Communication bus SPI, I2C UART
External connector Mini-PCIe -
Operating temperature -40~85℃
Dimensions 50.95 x 30mm



LoRa & LoRaWAN

What is LoRa ?

[Semtech]'s LoRa is a long-distance, low-power wireless platform for the Internet of Things (IoT), which generally refers to radio frequency chips using LoRa technology. The main features are as follows:

  • The spread spectrum modulation technology used by LoRa (abbreviation of long range) is derived from chirp spread spectrum (CSS) technology, which is one of long-distance wireless transmission technology and LPWAN communication technology. At present, LoRa mainly operates in the ISM frequency band, mainly including 433 , 868, 915 MHz, etc.
  • LoRa technology integrates technologies such as digital spread spectrum, digital signal processing and forward error correction coding, which greatly improves the performance of long-distance communication. LoRa's link budget is better than any other standardized communication technology. The main factors that determine distance in a given environment
  • LoRa RF chips mainly include SX127X series, SX126X series, SX130X series, of which SX127X, SX126X series are used for LoRa nodes, and SX130X is used for LoRa gateways. For details, please refer to [Semtech]'s product list

What is LoRaWAN ?

  • [LoRaWAN] is a low power wide area network open protocol based on LoRa radio modulation technology. Aims to wirelessly connect battery-powered "things" to the Internet in a regional, national or global network and targets key Internet of Things (IoT) requirements such as bi-directional communications, end-to-end security, mobility and localized services. Node wireless connection to the Internet has access authentication, which is equivalent to the establishment of encrypted communication channel between node and server. Access details refer to [document] and [source code]. LoRaWAN protocol level is shown in the figure below.
  • The Class A/B/C node devices in the MAC layer basically cover all the application scenarios of the Internet of Things. The differences among the three nodes lie in the different time slots for receiving and receiving nodes
  • EU868 and AS430 in the Modulation layer show that frequency band parameters are different in different countries. Please click the reference [link] for regional parameters

To achieve LoRaWAN network coverage in cities or other areas, it needs to be composed of four parts: node (LoRa node radio frequency chip), gateway (or base station, LoRa gateway radio frequency chip), server and cloud, as shown in the following figure

  • The DEVICE (node device) needs to initiate a network access request packet to the GATEWAY (gateway) and then to the server. After the authentication is passed, it can send and receive application data with the server normally.
  • GATEWAY (gateway) can communicate with the server through wired network, 3/4/5G wireless network
  • The main operators on the server side are [TTN], etc. For building cloud services by yourself, please refer to [lorawan-stack], [chirpstack]



LoRa devices and networks such as LoRaWAN enable smart IoT applications to help solve the planet's formidable challenges in energy management, natural resource reduction, pollution control, infrastructure efficiency, disaster prevention, and more. Semtech's LoRa devices have achieved hundreds of successful use cases in smart cities, homes and buildings, communities, metrology, supply chain and logistics, agriculture, and more. LoRa networks have covered hundreds of millions of devices in more than 100 countries and are committed to a smarter planet.

The examples here are based on the TTS ( The THINGS STACK) and the [ Semtech SX1203 libraries).
If you want to create the cloud server yourself, please refer to LoRaWan-Stack and chirpstack.

Hardware connection

Attach the LoRA HAT on the Raspberry Pi and set the GPS antenna in an open area where the sky is visible.

SX1302 LoRaWAN Gateway HAT 001.jpg

Network instructions

  • MCU runs LoRaWAN protocol and connects to Pico-LoRa-SX1262-868M as a node device (End Node), and through [https:/ / SX1302 LoRa Gateway (Gateway)] upload data to TTS server, or receive data from TTS server data, the specific network topology is as shown in the picture below

Pico-LoRa-SX1262-868M 005.jpg

  • Please select the applicable frequency band according to the local radio management regulations. Pico-LoRa-SX1262-868M is suitable for use in EU868 regional countries. The frequency band distribution diagram is as follows. For the specific table, click link view or visit LoRa Alliance

Pico-LoRa-SX1262-868M 004.jpg

Install libraries

Open the terminal of the Raspberry Pi and install libraries with the following commands:

sudo apt update
sudo apt install git
cd ~/Documents/
git clone
cd sx1302_hal
make clean all
make all
cp tools/ util_chip_id/
cp tools/ packet_forwarder/

Connect TTS

  • Sign up for a TTS account and login
  • Get the gateway EUI and add the gateway device to TTS, please choose the correct frequency according to the local area.
# get sx1302 EUI
cd ~/Documents/sx1302_hal/util_chip_id/
  • Go to the device Overview page and download the configuration file, then modify the test_conf file of sx1302_hal libraries according to the configuration file as figures
cd ~/Documents/sx1302_hal/packet_forwarder/
cp global_conf.json.sx1250.EU868 test_conf
  • Run the packet_forwarder
after running the codes, the gateway will keep connecting to the TTS
cd ~/Documents/sx1302_hal/packet_forwarder/
./lora_pkt_fwd -c test_conf


If you require technical support, please go to the Support page and open a tickets.