{"id":13801904,"url":"https://github.com/azorg/sx127x_esp","last_synced_at":"2026-02-15T11:09:20.712Z","repository":{"id":146876304,"uuid":"117332646","full_name":"azorg/sx127x_esp","owner":"azorg","description":"Connect Ra-01 module base on LoRaTM sx127x chip to ESP8266/ESP32 under MicroPython","archived":false,"fork":false,"pushed_at":"2018-10-03T18:22:45.000Z","size":4202,"stargazers_count":12,"open_issues_count":1,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-05T00:06:54.594Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azorg.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-01-13T09:54:27.000Z","updated_at":"2024-05-11T18:14:35.000Z","dependencies_parsed_at":"2023-10-20T18:13:15.792Z","dependency_job_id":null,"html_url":"https://github.com/azorg/sx127x_esp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azorg%2Fsx127x_esp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azorg%2Fsx127x_esp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azorg%2Fsx127x_esp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azorg%2Fsx127x_esp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azorg","download_url":"https://codeload.github.com/azorg/sx127x_esp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225217889,"owners_count":17439712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T00:01:29.805Z","updated_at":"2026-02-15T11:09:20.677Z","avatar_url":"https://github.com/azorg.png","language":"Python","funding_links":[],"categories":["Libraries"],"sub_categories":["Communications"],"readme":"Connect Ra-01 module base on LoRaTM SX127x chip to ESP8266/ESP32 under MicroPython\n==================================================================================\n\n### Notes\n1. This is experimental example, not software product ready for use\n2. This this free and open source software\n3. Author: Alex Zorg azorg(at)mail.ru\n4. Licenced by GPLv3\n5. Some sources based on:\n * https://github.com/Wei1234c/SX127x_driver_for_MicroPython_on_ESP8266\n * https://wei1234c.blogspot.tw/2017/08/sx127x-lora-transceiver-driver-for.html\n\n## Download Micropython firmware\nGo to:\n\n1. \"Getting started with MicroPython on the ESP8266\"\nhttp://docs.micropython.org/en/latest/esp8266/esp8266/tutorial/intro.html\n\n2. \"Firmware for ESP8266/ESP32 boards\"\nhttp://micropython.org/download\n\n## Install `esptool.py` - ESP8266 \u0026 ESP32 ROM Bootloader Utility\n```\n$ sudo apt-get install python-pip\n$ sudo pip install esptool\n```\nOR\n```\n$ sudo apt-get install python-serial\n$ sudo apt-get install python-ecdsa ecdsautils\n$ sudo apt-get install python-slowaes\n$ git clone https://github.com/espressif/esptool.git\n$ cd esptool\n$ sudo python setup.py install\n```\n\n## Flash firmware on ESP8266/ESP32 board\nESP8266:\n```\n$ esptool.py --port /dev/ttyUSB0 erase_flash\n$ esptool.py --port /dev/ttyUSB0 --baud 115200 write_flash --flash_size=detect 0 firmware.bin\n```\nESP32:\n```\n$ esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash\n$ esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash -z 0x1000 firmware.bin\n```\n\n## Connect LoRa module to ESP8266/ESP32\n\n|   GPIO   | DOIT ESP32 | NodeMCU v3 |   Signal    |  SX1278 (color)  |\n| -------- | ---------- | ---------- | ----------- | ---------------- |\n|     0    |    -       |     D3     |             |                  |\n|     2    |    D2      |     D4     |  Blue LED   |                  |\n|     4    |    D4      |     D2     |    IRQ      | DIO0   (yellow)  |\n|     5    |    D5      |     D1     | HARD RESET  | RESET  (magenta) |\n|     9    |    -       |     S2?    |             |                  |\n|    10    |    -       |   S3/SK?   |             |                  |\n|    12    |    D12     |     D6     |    MISO     | MISO   (blue)    |\n|    13    |    D13     |     D7     |    MOSI     | MOSI   (green)   |\n|    14    |    D14     |     D5     |    SCK      | SCK    (white)   |\n|    15    |    D15     |     D8     |    CS       | NSS    (grey)    |\n|    16    |    RX2     |     D0     |    DATA*    | DIO2*  (brown)   |\n|    -     |    -       |     -      |    DCLK**   | DIO1** (orange)  |\n|          |    3V3     |     3V     |    3.3V     | 3.3V   (red)     |\n|          |    GND     |     G      |    GND      | GND    (black)   |\n\nNote (*):  DIO2(DATA) is optional and may used in continuous FSK/OOK mode\n\nNote (**): DIO1(DCLK) unused\n\n## Build `mpy-cross`\n\n```\n$ sudo apt-get install build-essential libreadline-dev libffi-dev git\n\n$ git clone --recurse-submodules https://github.com/micropython/micropython.git\n\n$ cd ./micropython/ports/unix\n$ make axtls\n$ make\n$ sudo cp ./micropython /usr/local/bin\n\n$ cd ../../mpy-cross\n$ make\n$ sudo cp ./mpy-cross /usr/local/bin\n```\n\n## Install `ampy` - Utility to interact with a MicroPython board over a serial connection\n```\n$ sudo pip install adafruit-ampy\n```\nOR\n```\n$ sudo apt-get install python-click\n$ git clone https://github.com/adafruit/ampy.git\n$ cd ampy\n$ sudo python setup.py install\n```\n\n## Read and edit \"main.py\" and \"sx127x.py\", compile \"sx127x.py\"\n```\n$ vim sx127x.py\n$ vim main.py\n$ mpy-cross -O3 sx127x.py\n```\n\n## Load python examples to ESP module\n```\n$ ampy --port /dev/ttyUSB0 put sx127x.mpy\n$ ampy --port /dev/ttyUSB0 put main.py\n```\n\n## Run terminal (minicom, picocom or screen)\n```\n$ minicom -D /dev/ttyUSB0 -b 115200\n\n$ picocom /dev/ttyUSB0 -b 115200\n\n$ screen /dev/ttyUSB0 115200\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazorg%2Fsx127x_esp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazorg%2Fsx127x_esp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazorg%2Fsx127x_esp/lists"}