SX1278 / RA-02 LoRa 433 MHz
Ai-Thinker · Ai-Thinker Ra-02 с SX1278, IPEX-антенна, пример 433 МГц
Низкоскоростной пакетный LoRa-канал для датчиков и телеметрии.
Автор: SLDV LAB
Опубликовано · Обновлено
О МОДУЛЕ
Что делает Ai-Thinker Ra-02 с SX1278, IPEX-антенна, пример 433 МГц
Ra-02 — радиомодуль Ai-Thinker с трансивером Semtech SX1278, кварцем и согласованием антенны. Это SMD-модуль с контактами по краям; для макетных проводов нужна подходящая переходная плата. Пример относится к Ra-02, рассчитанному на 410–525 МГц, и антенне для 433 МГц. Модуль не становится вариантом 868/915 МГц при изменении одной строки программы.
LoRa повышает устойчивость слабого сигнала ценой скорости и времени занятия эфира. Подходит для небольших пакетов измерений, но не для потокового аудио или видео. Сам модуль не является LoRaWAN-шлюзом; в примере используется собственная связь между двумя узлами без LoRaWAN и без шифрования.
Диапазон микросхемы не равен разрешённому диапазону эксплуатации. Частоту, мощность, ширину канала, антенну и допустимый duty cycle выбирают по местным правилам; 433 МГц не разрешены для любого применения во всех странах. Не передавайте без подходящей антенны и не переносите требования Ra-02 на внешне похожую плату с регулятором.
У экземпляра на фотографии маркировка PA +18 dBm; в PDF Ra-02 V1.1 указано 18 ±1 dBm и типичный TX-ток 93 мА на 433 МГц. Текущая страница производителя приводит максимум +20 dBm и 105 мА. Эти значения зависят от исполнения и условий и не подтверждают измеренную мощность конкретного экземпляра.
SX1278 / RA-02 LoRa 433 MHz. Фото: VamosSandor. Оригинал: https://commons.wikimedia.org/wiki/File:Ra-02.png . Лицензия фотографии: CC BY-SA 4.0, https://creativecommons.org/licenses/by-sa/4.0/ . Изменения: Удалён исходный фон вокруг модуля, пигтейла и антенны, включая просвет внутри петли кабеля. Все видимые части комплекта сохранены. Пропорциональное масштабирование, размещение на предоставленном фоне и JPEG-сжатие. Геометрия, маркировка и видимые детали не перерисовывались. Цветокоррекция и повышение детализации не применялись. Адаптация фотографии распространяется по той же лицензии. Ai-Thinker Ra-02, пример исполнения с внешней антенной. Частоту антенны проверяйте отдельно.
Схема распиновки
Авторская распиновка SLDV LAB: Ai-Thinker Ra-02, SMD-16 с IPEX. Сторона металлического экрана; IPEX вверху слева. Оба ряда сверху вниз; модуль повёрнут относительно исходного фото. Для других ревизий и плат требуется отдельная проверка.
Источники: 1. Авторская схема SLDV LAB по фактам документации.
Характеристики
- Радиочип
- Semtech SX1278
- Диапазон именно Ra-02
- 410–525 МГц
- Модуляция примера
- LoRa
- Максимум передатчика по текущей документации Ai-Thinker
- 20 dBm
- Максимальный ток по текущей документации Ai-Thinker
- 105 мА
- Антенна
- Внешняя, разъём IPEX; согласованная на рабочий диапазон
- Интерфейс
- SPI
- Питание модуля
- Питание Ra-02 в примере 3,3 В, логика 3,3 В; 5 В на питание и сигналы подавать нельзя. Предусмотреть отдельный устойчивый источник с запасом на передающие импульсы порядка 105 мА.
ПРАКТИКА
Подключение
| Контакт модуля | Контакт платы | Назначение |
|---|---|---|
| 3.3V | Внешний стабилизатор 3,3 В | Источник с запасом, короткое питание и локальная развязка; не питать от GPIO. |
| GND | GND ESP32 и источника | Объединить земли и контакты GND переходной платы. |
| SCK | GPIO18 | ESP32-DevKitC V4. |
| MISO | GPIO19 | SPI, 3,3 В. |
| MOSI | GPIO23 | SPI, 3,3 В. |
| NSS | GPIO27 | CS модуля. |
| RESET | GPIO14 | Reset модуля. |
| DIO0 | GPIO26 | Первый interrupt-параметр RadioLib. |
| DIO1 | GPIO33 | Четвёртый параметр Module; служебные события. |
| IPEX | Антенна 433 МГц | Подключить до включения; GPIO сюда не подключают. |
Подходит для ESP32, Arduino. Выберите контакты по документации своей платы.
ВАШ ПРОЕКТ · ВАШ ДАТЧИК
Интегрируйте модуль с ChatGPT
Скопируйте запрос в ChatGPT. Укажите свою плату и среду разработки — получите подключение и код для своего проекта.
Помоги интегрировать Ai-Thinker Ra-02 SX1278 410–525 МГц. Уточни страну, точный модуль и переходную плату, антенну, хост, среду, объём пакета и дальность. Согласуй легальные параметры эфира. Дай питание с запасом, SPI/RESET/DIO, зависимости RadioLib, полный пример, обработку ошибок и парный тест. Различай LoRa point-to-point и LoRaWAN; не обещай определённую дальность и не предлагай 868/915 МГц для Ra-02.
Библиотеки
Установите библиотеку для своей среды и откройте пример из её документации.
Что именно прописать
- Плата и API
ESP32-DevKitC V4; Arduino-ESP32 3.3.0; RadioLib 7.2.1Используется обычный ESP32-WROOM-32.
- Заголовок
#include <RadioLib.h>Установить RadioLib 7.2.1.
- Конструктор
SX1278 radio = new Module(27, 26, 14, 33);NSS, DIO0, RESET, DIO1.
- Параметры LoRa
433.0 МГц; BW 125 кГц; SF9; CR 4/7; sync 0x12; 2 dBmДемонстрационные настройки пары; начать передачу можно только после проверки местных правил.
Ra-02: приём пакета с кодом ошибки
cpp#include <Arduino.h>
#include <SPI.h>
#include <RadioLib.h>
SX1278 radio = new Module(27, 26, 14, 33);
void setup() {
Serial.begin(115200);
SPI.begin(18, 19, 23, 27);
int16_t state = radio.begin(433.0, 125.0, 9, 7, 0x12, 2, 8, 0);
if (state != RADIOLIB_ERR_NONE) {
Serial.print("Init error: "); Serial.println(state);
while (true) delay(1000);
}
Serial.println("LoRa receiver ready");
}
void loop() {
String packet;
int16_t state = radio.receive(packet);
if (state == RADIOLIB_ERR_NONE) {
Serial.print("RX: "); Serial.println(packet);
} else if (state != RADIOLIB_ERR_RX_TIMEOUT) {
Serial.print("RX error: "); Serial.println(state);
}
delay(10);
}Полный скетч для ESP32-DevKitC V4 с ESP32-WROOM-32, Arduino IDE и Arduino-ESP32 3.3.0. API сверено по исходникам; компиляция и проверка на реальном оборудовании здесь не выполнялись. Пример только принимает. На втором Ra-02 с той же инициализацией после проверки правил выполнить radio.transmit("SLDV test") по команде оператора и проверить код возврата. Совпадают частота, BW, SF, CR, sync word и CRC. При отсутствии пакетов проверить антенны и параметры; при ошибке init — питание, SPI и RESET. Для полноценной системы добавьте таймауты приложения, номера пакетов и защиту данных.
Проекты с этим компонентом
Все проектыСвязанные проекты пока не опубликованы.
