cukier/LoraProgrammerFirmware ESP32 (ESP-IDF) para programar e configurar módulos de rádio LoRa, expondo a configuração através de um servidor HTTP em Wi-Fi (SoftAP/STA), acessível também via mDNS (http:// .local/).
Encoder is an open-source printed circuit board by cukier, from the cukier/LoraProgrammer repository on GitHub, published under the MIT licence. It is a 2-layer board of 33 × 128.5 mm with 84 parts on 87 nets, routed with 575 tracks and 58 vias.
It is built around the ESP32-WROOM-32, LM2596S-5.0 and SP3485EN-Y, with the BC807, MMBF170 and MMBT2222ALT1G-CN among its other parts. Its parts include 35 resistors, 15 transistors, 12 diodes, 9 capacitors and 5 ICs. It belongs with the ESP32 boards of this library.
Firmware ESP32 (ESP-IDF) para programar e configurar módulos de rádio LoRa, expondo a configuração através de um servidor HTTP em Wi-Fi (SoftAP/STA), acessível também via mDNS (http://<hostname>.local/).
Dois rádios são suportados; apenas um é compilado por build, escolhido no menuconfig:
| Rádio | Interface | Como funciona |
|---|---|---|
| RF1276 / YL_800IL — AppConWireless (padrão) | UART | Módulo com MCU próprio. O ESP32 lê/escreve os parâmetros (baudrate, paridade, frequência, spreading factor, modo, largura de banda, ID, Net ID, potência) pelo protocolo de comandos com header 0xAF; os dados de payload são transparentes (bytes crus na mesma UART). |
| LoRa127X-C1 / SX1276 — NiceRF | SPI nativa | Modem SX1276 controlado diretamente pelo ESP32 (componente dernasherbrezon/sx127x). Não tem memória de configuração: "programar" significa aplicar os parâmetros (frequência, largura de banda, SF, coding rate, sync word, preâmbulo, potência, CRC) a cada boot e em runtime via POST /lora. |
cd src
idf.py menuconfig # → "KLORA Configuration" → "LoRa radio module"
idf.py buildSem menuconfig, o build usa o RF1276 (CONFIG_KLORA_RADIO_RF1276=y). Os pinos
(UART ou SPI) e os parâmetros de rádio ficam no mesmo menu, e são aplicados no
boot. A escolha do rádio também está exposta como variável de CMake, então o
main/CMakeLists.txt compila só o back end selecionado (kuart.c + RF1216.c
ou klora_sx127x.c).
| Método | Rota | Descrição |
|---|---|---|
GET | /info | RAM livre, versão do firmware, IP, uptime, hora local |
GET | /lora | Configuração atual do rádio (JSON) |
POST | /lora | Aplica/grava parâmetros do rádio (corpo JSON, qualquer subconjunto) |
GET | /lora/rxtx | Hex dump do último pacote recebido pelo ar |
POST | /lora/rxtx | Transmite um payload — corpo JSON {"message": "..."} |
POST | /ota | Atualização de firmware |
POST | /reboot | Reinicia o dispositivo após 5 s |
O formato do JSON de /lora difere entre os rádios (parâmetros distintos), mas a
saída do GET sempre volta a valer como corpo do POST para o mesmo back end.
src/ Firmware ESP-IDF (projeto CMake)
main/ Componente principal (código-fonte)
sch/ Projeto de hardware em KiCad
.github/ Workflows de CI (build do firmware e exports do KiCad)Projeto ESP-IDF padrão. Para compilar:
cd src
idf.py build
idf.py -p <PORT> flash monitorO CI (.github/workflows/firmware.yml) compila o firmware a cada push/PR em src/** e publica os binários (.bin, bootloader.bin, partition-table.bin) como artifact.
Esquemático e PCB em sch/ (KiCad 9). O CI (.github/workflows/hardware.yml) exporta Gerbers, drill files e BOM a cada push/PR em sch/**.
radio.json documenta o formato dos parâmetros de rádio (back end RF1276) expostos pela API HTTP do firmware.
MIT — veja LICENSE.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 23 | 10k | Resistor_SMD:R_0805_2012Metric | R1, R2, R3, R10, R11, R16, R17, R18, R20, R21, R23, R25, R27, R28, R29, R31 +7 |
| 6 | 100nF | Capacitor_SMD:C_0805_2012Metric | C2, C4, C6, C7, C8, C9 |
| 6 | 1k | Resistor_SMD:R_0805_2012Metric | R8, R15, R19, R24, R26, R30 |
| 4 | 560R | Resistor_SMD:R_0805_2012Metric | R12, R14, R34, R36 |
| 4 | BC807 | Package_TO_SOT_SMD:SOT-23 | Q7, Q8, Q9, Q10 |
| 4 | MMBF170 | Package_TO_SOT_SMD:SOT-23 | Q3, Q4, Q13, Q14 |
| 4 | MMBT2222ALT1G | Package_TO_SOT_SMD:SOT-23 | Q1, Q2, Q5, Q15 |
| 3 | BC817 | Package_TO_SOT_SMD:SOT-23 | Q6, Q11, Q12 |
| 2 | SM712 | Package_TO_SOT_SMD:SOT-23 | D4, D13 |
| 2 | 120R | Resistor_SMD:R_0805_2012Metric | R13, R35 |
| 2 | 470uF | Capacitor_THT:CP_Radial_D8.0mm_P3.50mm | C3, C5 |
| 2 | RX2 | LED_THT:LED_D3.0mm | D9, D10 |
| 2 | SP3485EN | Package_SO:SOIC-8_3.9x4.9mm_P1.27mm | U4, U5 |
| 2 | US1M | Diode_SMD:D_SMA | D2, D5 |
| 1 | 1000uF | Capacitor_THT:CP_Radial_D10.0mm_P5.00mm | C1 |
| 1 | 100uH | Inductor_THT:L_Radial_D8.7mm_P5.00mm_Fastron_07HCP | L1 |
| 1 | 10D390K | Varistor:RV_Disc_D12mm_W6.3mm_P7.5mm | RV1 |
| 1 | AP1117-33 | Package_TO_SOT_SMD:SOT-223-3_TabPin2 | U3 |
| 1 | CON_I | Connector_PinSocket_2.54mm:PinSocket_1x09_P2.54mm_Vertical | J4 |
| 1 | CON_O | Connector_PinSocket_2.54mm:PinSocket_1x09_P2.54mm_Vertical | J5 |
| 1 | ENC | Connector_Phoenix_MC:PhoenixContact_MCV_1,5_4-G-3.81_1x04_P3.81mm_Vertical | J3 |
| 1 | ENC | LED_THT:LED_D3.0mm | D8 |
| 1 | ESD9B3.3ST5G | Diode_SMD:D_0603_1608Metric | D1 |
| 1 | ESP32-WROOM-32 | RF_Module:ESP32-WROOM-32 | U1 |
| 1 | G6K-2 | Relay_SMD:Relay_DPDT_Omron_G6K-2F-Y | K2 |
| 1 | HEART_BEAT | LED_THT:LED_D3.0mm | D12 |
| 1 | LM2596S-5 | Package_TO_SOT_SMD:TO-263-5_TabPin3 | U2 |
| 1 | PROG | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | J1 |
| 1 | PWR | Connector_Phoenix_MC:PhoenixContact_MCV_1,5_4-G-3.81_1x04_P3.81mm_Vertical | J2 |
| 1 | SS35 | Diode_SMD:D_SMC | D3 |
| 1 | TX1 | LED_THT:LED_D3.0mm | D6 |
| 1 | TX2 | LED_THT:LED_D3.0mm | D7 |
It measures 33 × 128.5 mm and has 2 copper layers, 1.6 mm thick.
84 parts, built around the ESP32-WROOM-32, LM2596S-5.0, SP3485EN-Y and BC807. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
From the cukier/LoraProgrammer repository on GitHub, at the commit this page was made from: the board is sch/Encoder.kicad_pcb and its schematic sch/Encoder.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).
HakanD1/24v-to-5v-50w-buck-converter-stm32
24V to 5V 50W Digital Controlled Buck Converter Hardware, Software, and Control Design. Features an STM32-based closed-loop PI regulation, 120kHz PWM, custom PCB, and a Nextion HMI display interface.
wyolum/mmM
mmMercury is an Open Hardware, blood pressure measurement device (not FDA approved).
jrowe88/ecoport-bridge
CTA-2045 (EcoPort) bridge for a Rinnai REHP65 heat pump water heater
EricSFR/Simple-Projects
In this repository i'll show some of my projects, manly for the ubniversity
Multiflexmeter/PZLD-Zoutwachter
Automated groundwater conductivity readout based CN0359
tomrodinger/Raspberry_Pi_HAT_RS485
This is a Raspberry Pi HAT for RS485 communication with external devices and it should fit into any Raspberry Pi like Zero/Zero2W/3/4