LoRaPacketForwarder скачать - LoRaPacketForwarder исходный код скачать

LoRaPacketForwarder

AI Исходный код

1.0.0

Скачать

Lora Packet Frowinger для Linux

Одноканал LORA UDP Packet Packeter Идеально подходит для целей разработки или тестирования. Получает и передает двунаправленную. Этот проект идеально подходит для DIY одного из самых дешевых «шлюзов LORA», состоящего из одноразового компьютера и модуля LORA за 4 доллара.

Целью проекта является предоставление простого форварчика Lora для:

Linux - Orange Pi, Raspberry Pi и т. Д.
Поддерживает протокол UDP Semtech V2 - восходящая линейка, нисходящая линия и статистика:
- Сеть вещей - протестированная v2 и v3
- Chirpstack - протестирован v3
Поддерживается классы устройств Lorawan:
- класс A, модуляция Lora - протестированная
Связь SPI на основе WilingPI и модифицированного радиолиба для Linux (Orange Pi или Raspberry Pi) с чипсами LORA:
- SX126X Series
- LLCC68
- SX127X Series
- RFM9X Series
Базовый файл конфигурации JSON

Как использовать

Устройство оборудования

Наряду с сетевым соединением на вашем одностороннем компьютере (Wi-Fi, Ethernet ...) Следующие выводы на вашем устройстве должны быть выделены:

SPI модуль штифты
- Мисо
- Моси
- CLK
3 или 4 штифта GPIO для подключения к модулю LORA:
- CS (он же NSS)
- Дио 0
- Дио 1
- Отдых - необязательно
Power Pins - 2 штифта для VCC (обычно 3,3 В) и 1 для GND

Пожалуйста, обратитесь к команде gpio readall (также проверьте следующие разделы), чтобы получить дополнительную информацию для вашей конкретной платы. Посмотрите также номера WindingPI, потому что файл конфигурации ожидает этой схемы нумерации.

Например:


 +------+-----+----------+------+---+OrangePiH3+---+------+----------+-----+------+
 | GPIO | wPi |   Name   | Mode | V | Physical | V | Mode | Name     | wPi | GPIO |
 +------+-----+----------+------+---+----++----+---+------+----------+-----+------+
 |      |     |     3.3v |      |   |  1 || 2  |   |      | 5v       |     |      |
 |   12 |   0 |    SDA.0 | ALT2 | 0 |  3 || 4  |   |      | 5V       |     |      |
 |   11 |   1 |    SCL.0 | ALT2 | 0 |  5 || 6  |   |      | 0v       |     |      |
 |    6 |   2 |      PA6 |  OFF | 0 |  7 || 8  | 0 | OFF  | TxD3     | 3   | 13   |
 |      |     |       0v |      |   |  9 || 10 | 0 | OFF  | RxD3     | 4   | 14   |
 |    1 |   5 |     RxD2 |  OFF | 0 | 11 || 12 | 1 | OUT  | PD14     | 6   | 110  |
 |    0 |   7 |     TxD2 |  OFF | 1 | 13 || 14 |   |      | 0v       |     |      |
 |    3 |   8 |     CTS2 |  OFF | 0 | 15 || 16 | 0 | IN   | PC04     | 9   | 68   |
 |      |     |     3.3v |      |   | 17 || 18 | 1 | IN   | PC07     | 10  | 71   |
 |   64 |  11 |     MOSI | ALT3 | 0 | 19 || 20 |   |      | 0v       |     |      |
 |   65 |  12 |     MISO | ALT3 | 0 | 21 || 22 | 0 | OFF  | RTS2     | 13  | 2    |
 |   66 |  14 |     SCLK | ALT3 | 0 | 23 || 24 | 0 | ALT3 | CE0      | 15  | 67   |
 |      |     |       0v |      |   | 25 || 26 | 0 | OFF  | PA21     | 16  | 21   |
 |   19 |  17 |    SDA.1 | ALT3 | 0 | 27 || 28 | 0 | ALT3 | SCL.1    | 18  | 18   |
 |    7 |  19 |     PA07 |  OFF | 0 | 29 || 30 |   |      | 0v       |     |      |
 |    8 |  20 |     PA08 |  OFF | 0 | 31 || 32 | 0 | OFF  | RTS1     | 21  | 200  |
 |    9 |  22 |     PA09 |  OFF | 0 | 33 || 34 |   |      | 0v       |     |      |
 |   10 |  23 |     PA10 |  OFF | 0 | 35 || 36 | 0 | OFF  | CTS1     | 24  | 201  |
 |   20 |  25 |     PA20 |  OFF | 0 | 37 || 38 | 0 | OFF  | TxD1     | 26  | 198  |
 |      |     |       0v |      |   | 39 || 40 | 0 | OFF  | RxD1     | 27  | 199  |
 |    4 |  28 |     PA04 | ALT2 | 0 | 41 || 42 | 0 | ALT2 | PA05     | 29  | 5    |
 +------+-----+----------+------+---+----++----+---+------+----------+-----+------+
 | GPIO | wPi |   Name   | Mode | V | Physical | V | Mode | Name     | wPi | GPIO |
 +------+-----+----------+------+---+OrangePiH3+---+------+----------+-----+------+

   ___
   _/     SX1278  module
    |      --------------
     --- | ANT      GND |===== Pin #20 [OrangePiH3 Physical]
          | GND     DIO1 |===== Pin #18 [OrangePiH3 Physical] / [a.k.a WiringPi pin ## 10]
          |         DIO2 |
          |         DIO3 |
          |          VCC |===== Pin # 1 [OrangePiH3 Physical]
          |         MISO |===== Pin #21 [OrangePiH3 Physical] / [[a.k.a WiringPi pin ## 12]]
          |         MOSI |===== Pin #19 [OrangePiH3 Physical] / [[a.k.a WiringPi pin ## 11]]
          |         SLCK |===== Pin #23 [OrangePiH3 Physical] / [[a.k.a WiringPi pin ## 14]]
          |          NSS |===== Pin #12 [OrangePiH3 Physical] / [a.k.a WiringPi pin ## 6]
          |         DIO0 |===== Pin #16 [OrangePiH3 Physical] / [a.k.a WiringPi pin ## 9]
          |         REST |===== optional, if it isn't used leave floating or connect to VCC
          |          GND |
           --------------

Клонировать проект

git clone --recurse-submodules https://github.com/zhgzhg/LoRaPacketForwarder.git

Orange Pi: компиляция и установка

Следующие шаги были проверены на Armbian v5.90. Однако рекомендуется использовать свою последнюю версию.

Скомпилируйте WhiringPi для Orange Pi // для нулевой модели Использовать библиотеку WilingOp-zero // с ./build Command
- При желании укажите переменную платформы, чтобы изменить конфигурацию платы (например, для Orange Pi Pi: PLATFORM=orangepipc ./build ) или оставьте сценарий сборки, чтобы автоматически определить его.
- На Armbian и Orange Pi вам может потребоваться добавить наложение spi-spidev . Кроме того, в /BOOT/Armbianenv.txt вам нужно добавить параметр param_spidev_spi_bus=1 или param_spidev_spi_bus=0 в зависимости от модели платы. Например:
  - Orange Pi Zero- param_spidev_spi_bus=1 Если мы рассмотрим следующие активные наложения: i2c0 i2c1 pps-gpio pwm spi-add-cs1 spi-spidev uart1 usbhost2 usbhost3
  - Orange Pi PC - param_spidev_spi_bus=0
  - Для получения дополнительной информации проверить https://docs.armbian.com/user-guide_allwinner_overlays/, https://github.com/armbian/sunxi-d-overlays/blob/master/sun8i-h3/readme.sun8i-h3-overlay
  - Предупреждение: на некоторых новых ядрах Linux (например, 5.10.43-Sunxi) В зависимости от модели платы SPI вообще не работает. Индикация этого может быть пропущенным /dev/spidev* каталогом, несмотря на загруженный драйвер spidev . Временный обходной путь для этого случая - переключение на старое ядро.
  - Предупреждение 2: Изменения в загруженных накладках даже для одной и той же платы дадут разные результаты для доступных булавок GPIO, устройств SPI и т. Д.! Команда gpio readall также будет отображать немного другую таблицу, спрятанные или показаны ряды.
- Выполнить gpio readall , чтобы увидеть таблицу схемы расписания платы
Составьте этот проект с помощью make

Raspberry Pi и другие: компиляция и установка

WindingPi предварительно установлен на Raspbian - никаких действий не требуется
Составьте этот проект с помощью make

Завод LORA UDP Packeter

Создать config.json, копируя config.json.template:
- Отредактируйте значения SPI_PORT и SPI_CHANLAR соответственно.
  - Проконсультируйтесь с MISO / MOSI и, в частности, " gpio readall
  - Дополнительно наблюдайте за выводом sudo ls /dev/spi* , где результаты, такие как EG "/dev/spidev1.0", соответствуют/dev/spidev <pichannelnumber> . <piportnumer>
  - Обратите внимание, что возможность указать пользовательский SPI_PORT -это нестандартная функция, которая может не работать в средах с оригинальной WindingPI для RaspberryPi. Альтернативным решением является создание символов для /dev /spidev <x> . <x> .
- Измените поле IC_Model, чтобы указать модель чипа LORA. Используйте одно из следующих поддерживаемых значений ниже:
  - Для серии SX126X: SX1261 , SX1262 или SX1268
  - Для LLCC68: LLCC68
  - Для серии SX127X: SX1272 , SX1273 , SX1276 , SX1277 , SX1278 или SX1279
  - Для серии RFM9X: RFM95 , RFM96 , RFM97 или RFM98
- Отредактируйте расписание (выполнить gpio readall , чтобы проверить номера PIN -контактов, которые необходимо указать). Обратите внимание, что PIN_REST не является обязательным . Если он не используется, вы должны установить его на -1 и оставить штифт приемопередатчика плавающим или подключенным к VCC;
- Отредактируйте оставшиеся параметры соответственно.
Чтобы выполнить приложение:
- ./LoRaPktFwrd
Чтобы выполнить приложение, а также указать сетевой интерфейс, используемый для генерации идентификатора:
- ./Lorapktfwrd <interface_name>
  - По умолчанию один - eth0
  - Пример: ./LoRaPktFwrd wlan0
Чтобы получить поддерживаемые варианты CLI:
- ./LoRaPktFwrd -h

Запуск LORA UDP Packeter Packeter как системный сервис

Этот проект может быть установлен в качестве службы SystemD (см. File LoRaPktFwrd.service ), которая необязательно может запускаться автоматически после системных сапог. В качестве предпосылки убедитесь, что проект составлен (через команду make ), и он может правильно выполнять с вашим собственным файлом config.json .

Чтобы установить службу LORAPKTFWRD, вы можете выполнить: sudo make install
Чтобы удалить использование услуг: sudo make uninstall
Чтобы позволить службе автоматически работать после ботинок системы: sudo systemctl enable LoRaPktFwrd.service
Чтобы запретить службу автоматического запуска после системных ботинок: sudo systemctl disable LoRaPktFwrd.service
Чтобы вручную запустить / перезапустить / остановить / проверить статус службы:

 sudo service LoRaPktFwrd start
sudo service LoRaPktFwrd restart
sudo service LoRaPktFwrd stop
sudo service LoRaPktFwrd status

Чтобы осмотреть последние журналы службы: sudo journalctl -n 100 -f -u LoRaPktFwrd.service

Зависимости

Lora UDP Packet Packeter полагается на следующие программы и библиотеки:

G ++ Поддержка C ++ 14 Стандарт
делать
Проводка

Как проверить

При условии простых примеров Lora Trasmitter Arduino Project под названием «передача» в текущем каталоге. Подключите свой ESP8266/Arduino/любая плата через SPI в SX1278, составьте его, и он начнет передавать данные. Используя конфигурацию по умолчанию внутри «config.json.template» с точки зрения RF -спецификаций, приложение Foarder должен немедленно выбирать данные из передатчика.

Другие дополнения

Темпмон

Крошечная программа мониторинга температур, которая может работать в фоновом режиме и изменять контакты GPIO в ответ.

Ограничения

Достижение идеального времени передачи в нисходящей линии связи, по-видимому, сложно с комбинацией обычного одноборочного компьютера, оснащенного простым трансивером Lora. Причина этого сводится к неточным аппаратным часам компьютера в сочетании с нереальной природой Linux. Чтобы компенсировать это, этот проект направлен на приоритет очень высокого (почти в реальном времени) и увеличение использования ЦП (примерно 20%), чтобы частично компенсировать нерегулярные задержки ОС.