SX127x (LoRa transceiver) driver for (Micro)Python on ESP8266/ESP32/Raspberry_Pi

Wei Lin

2017/08/11

1. 緣由

    最近幾年 LoRa 很紅，使用這種技術的無線通訊模組 通常比較 便宜(使用免費頻段)、小、省電、通訊距離長 (~15Km)，主要用來讓末端遠距的 IoT 設備能互相溝通 或 與主機交換資料。市面上的 LoRa 模組很多，最近入手的是 HopeRF 出的 RFM96W，其上搭載 SX1278 (相容)晶片體積很小 很迷人。

RFM96W 模組的外觀如下圖，大約只有 16mm x 16mm 見方，中間的正方形 IC 就是 SX1278 (相容)晶片 。

使用 Arduino 搭配 RFM96W 很快就可以做出一個可以收發資料的裝置，網路上有 SX127x library for Arduino 可以用，很方便。

如果是使用 Raspberry Pi 來主控，可以用 Python 搭配 pySX127x 來驅動 RFM96W。

但是我最近比較常用 ESP8266 + MicroPython ，pySX127x 太大了 無法在 ESP8266 上面使用，所以我只好用 Python 把 arduino-LoRa 改寫成 for  MicroPython + ESP8266 的版本。

GitHub repo. 在這。



2. 效果

可以半雙工 互傳資料，很有趣，改天再來試試看能打多遠的距離。

LoRa 半雙工 互傳資料

使用 SX1278 + MicroPython + ESP8266 

reboot 的時候 LED 會閃兩次
後續每收到一個 packet 的時候 LED 會閃一下

3. Config

RFM96W vs. NodeMCU 接腳對應

RFM96W pinout

NodeMCU (ESP8266) pinout

接腳對應

接好大概就像這樣

4. 使用方式

簡單的收發測試方式:

1. 按照上述的接腳對應方式準備兩組 NodeMCU+SX1278模組 (RFM96W)。
2. NodeMCU (ESP8266) 燒錄 MicroPython 韌體。
3. 由 GitHub 下載 檔案。
4. 將下圖 DuplexCallback 資料夾中的檔案分別 全部上傳到兩組 NodeMCU上 (直接放在 根目錄之下即可)。
5. 上電之後兩台 NodeMCU 應該就會開始互傳資料。

5. 使用 ESP32

ESP8266 內建 WiFi 連網的能力，這樣已經足以作為一個 Gateway 了，但是 ESP8266 的記憶體比較小 有時候不夠用，所以今天把其中一台改為使用 ESP32，程式也調整了一下 可以兼容。

for ESP32 的 MicroPython 韌體 在這。

NodeMCU (ESP32) pinout

接腳對應

接好線 大概像這樣

哥倆好

6. 使用 Raspberry Pi

既然已經做到這邊，索性再多花一點時間兼容 Raspberry Pi，我是使用 Raspberry Pi Zero W。
以前一直沒有用 Raspberry Pi 實作硬體專案，這次剛好藉這個機會熟悉一下 RPi 的硬體介面操作。

Raspberry Pi 的 pinout

接腳對應
(這是對應 2017/09/02 之前的程式碼)

 (這是對應 2017/09/02 之後的程式碼)

接好線 大概像這樣
(這是對應 2017/09/02 之前的程式碼，
之後已經調整 NSS和DIO0 的對應腳位)

LoRa 半雙工 互傳資料

ESP8266+ESP32+Raspberry Pi Zero W

6.1 使用 Raspberry Pi 測試

1. 要先 enable Raspberry 上的 SPI 介面。
2. RPi 上需安裝:
1. Python3
2. sudo pip3 install RPi.GPIO
3. sudo pip3 install spidev
3. 按照上述的接腳對應方式接線。
4. 由 GitHub 下載 檔案。
5. 將下圖 DuplexCallback 資料夾中的檔案 全部上傳到 RPi 上的某一個資料夾中。
6. cd 到該資料夾的位置。
7. 在該資料夾中 執行如下的 Python 程式碼，RPi 就會開始半雙工收發資料 : 
• sudo python3 main.py

7. 支援雙通道 (雙 transceivers)

看到網路上有人用 ESP8266 搭配兩個 LoRa transceivers 做成雙通道的模組，這倒是一個好主意，我也來改一下。

接腳對應 for ESP8266

接好線 大概像這樣

LoRa 雙通道 on ESP8266

接腳對應 for ESP32

接好線 大概像這樣

LoRa 雙通道 on ESP32

接腳對應 for Raspberry Pi

接好線 大概像這樣

7.1 使用 Raspberry Pi 測試

1. 要先 enable Raspberry 上的 SPI 介面。
2. RPi 上需安裝:
1. Python3
2. sudo pip3 install RPi.GPIO
3. sudo pip3 install spidev
3. 按照上述的接腳對應方式接線。
4. 由 GitHub 下載 檔案。
5. 將所有的 *.py 檔案都複製到 RPi 上的某一個資料夾中。
6. cd 到該資料夾中。
7. 將 main.py 中 第 8 行的 "import test" 改為 "import test_dual_channels as test"
8. 進入 Python3 環境:
• sudo python3
9. 執行如下的 Python 指令，RPi 就會開始使用兩個 RFM96W 模組接收資料 : 
• import main

8. 使用 TTGO 的 ESP32+LoRa+OLED 整合模組

  網路上有賣這種 ESP32 + SX1278 LoRa + SSD1306 OLED 的整合模組，整體設計相當簡潔，目前的價格大約台幣 300元，以後可能更便宜。

  為了兼容這個模組，特別加了一個 controller_esp_ttgo_lora_oled 的 subclass，並且將有使用到的 SSD1306 driver 含括進來。 雖然腳位定義不同，但已經都封裝在 controller 的子類別 (controller_esp_ttgo_lora_oled ) 中，所以應用的時候使用者可以如常使用 controller 所定義的 interface 即可，不需要去操煩底層實作的細節。

有個 display 還是比較方便一點，也許以後可以做個 LoRa 推文顯示器

A. MQTT bridged LoRa networks with MicroPython on ESP32

  有天想到可以用 蜂巢網路的模式，透過 MQTT 串聯分散在各地區的 LoRa networks，於是就做了 這個實驗。