/ _____)             _              | |    
( (____  _____ ____ _| |_ _____  ____| |__  
 \____ \| ___ |    (_   _) ___ |/ ___)  _ \ 
 _____) ) ____| | | || |_| ____( (___| | | |
(______/|_____)_|_|_| \__)_____)\____)_| |_|
  (C)2013 Semtech-Cycleo

Проект пакетного фронтенда LoRa

1. Основная программа: lora_pkt_fwd

Пакетный фронтенд — это программа, работающая на хосте LoRa-шлюза, которая пересылает радиопакеты, полученные концентратором, на сервер через IP/UDP связь, и передает радиопакеты, отправленные сервером. Она также может генерировать синхронизированный сигнал GPS для координации всех узлов сети.

((( Y )))
    |
    |
+- -|- - - - - - - - - - - - -+        xxxxxxxxxxxx          +--------+
|+--+-----------+     +------+|       xx x  x     xxx        |        |
||              |     |      ||      xx  Интернет  xx        |        |
|| Концентратор |<----+ Хост |<------xx     или    xx-------->|        |
||              | SPI |      ||      xx  Локальная сеть  xx   | Сервер |
|+--------------+     +------+|       xxxx   x   xxxx        |        |
|   ^                    ^    |           xxxxxxxx           |        |
|   | PPS  +-----+  NMEA |    |                              |        |
|   +------| GPS |-------+    |                              +--------+
|          +-----+            |
|                             |
|            Шлюз            |
+- - - - - - - - - - - - - - -+

Подъем: радиопакеты, полученные шлюзом, с метаданными, добавленными шлюзом, пересылаются на сервер. Может также включать статус шлюза.

Спуск: пакеты, сгенерированные сервером, с дополнительными метаданными, для передачи шлюзом по радиоканалу. Может также включать конфигурационные данные для шлюза.2. Вспомогательные программы

Эти программы включены в проект для предоставления примеров того, как общаться с пакетным фронтеном, и для помощи системному построителю в использовании его без необходимости реализации полного сервера LoRa.

3.1. util_sink

Пакетный сейвер — это простая вспомогательная программа, слушающая UDP-датаграммы на одном порту и выводящая сообщение каждый раз, когда она получает датаграмму. Само содержимое датаграммы игнорируется.

3.2. util_ack

Программа-помощник для подтверждения пакетов представляет собой простое приложение, которое прослушивает одиночный UDP-порт и отвечает на PUSH_DATA-пакеты PUSH_ACK, а также на PULL_DATA-пакеты PULL_ACK.

3.3. util_tx_test

Программа-помощник для отправки пакетов используется для отправки пакетов через маршрут от ворот до сервера.

4. Вспомогательные скрипты

4.1. lora_gateway/reset_lgw.sh

Этот скрипт, предоставленный HAL (Hardware Abstraction Layer), должен быть запущен на платформе IoT Start Kit для сброса микросхемы концентратора через GPIO перед запуском любого приложения, использующего концентратор, такого как пакетный фронтенд.

4.2. packet_forwarder/lora_pkt_fwd/update_gwid.sh

Этот скрипт позволяет автоматически обновлять Gateway_ID с уникальным MAC-адресом в JSON-файле конфигурации пакетного фронтенда. Для получения дополнительной информации обратитесь к заголовку скрипта.5. История изменений

v4.0.1 - 2017-03-16

• Класс-B: Добавлено исправление ошибки кристалла для частоты маяка
• Класс-B: Добавлена поддержка всех регионов для формата фрейма маяка (разные скорости передачи данных предполагают разные размеры фреймов), как определено в LoRaWAN v1.1.

v4.0.0 - 2017-01-10

• Добавлена поддержка класса-B, как определено в LoRaWAN v1.1
• Поддержка только в одном направлении для временных меток "tmst" или "tmms". "time" больше не поддерживается ("time" поле сохраняется в Uplink как информационное поле).
• Переработан поток thread_gps для обработки UBX-сообщений GPS для нативного времени GPS.
• Обновлен протокол Gateway <-> NetworkServer для описания нового поля "tmms".
• Обновлены конфигурационные файлы global_conf.PCB286*.json для удаления индексов LUT усиления передатчика выше 20dBm. Используйте PCB336 (также известный как GW v1.5) для соответствия требованиям ETSI по маске передачи между 20dBm и 27dBm.

v3.1.0 - 2016-09-07

• Обновлен JSON-конфигурационный файл "Listen-Before-Talk" для соответствия переработке LBT.

• Добавлен JSON-конфигурационный файл для фильтра вырезки передатчика.

• Обновлено библиотека Parson до последней версии

• Исправлен расчет CRC-16 маяка класса-B

• Удалена локальная функция JiT time_on_air и использован функционал lgw_time_on_air()### v3.0.0 - 2016-05-19 ###

• Слил все различные версии пакетного форвардера в один уникальный lora_pkt_fwd Примечание: Разные версии всё ещё могут быть достигнуты с помощью соответствующего файла global_conf.json.XXX, предоставленного в lora_pkt_fwd/cfg.

• Добавил расписание "just-in-time" для оптимизации использования下行链路容量。

• Обновил протокол Gateway <-> NetworkServer для описания нового формата "tx_ack" сообщения.

• Добавил JSON-конфигурацию "Listen-Before-Talk".

• Разделил скрипт reset_pkt_fwd.sh на 2 разных скрипта:

  • reset_lgw.sh, предоставленного с HAL (lora_gateway)
  • update_gwid.sh, предоставленного с lora_pkt_fwd ПРЕДУПРЕЖДЕНИЕ: Изменился протокол взаимодействия между шлюзом и сервером сети. Пожалуйста, обратитесь к файлу PROTOCOL.txt.### v2.2.1 - 2016-04-12 ###

• util_tx_test: добавлена поддержка FSK и специальный пейлоад для упрощенного тестирования PER.

• base64: исправлена проверка заполнения.

• Обновлены все make-файлы для обработки создания директории obj при необходимости.

• [gps/beacon]_pkt_fwd: исправлена ошибка при выходе, когда GPS не включен.

• [*]_pkt_fwd: добавлена директория cfg, содержащая различные варианты файла global_conf.json для различных плат: Ref Design PCB_E336 (GW1.5-27dBm), Ref Design PCB_E286 (GW1.0), Ref Design с частотным планом US902.

v2.2.0 - 2015-10-08

• Удалена поддержка FTDI из make-файлов для соответствия HAL v3.2.0.
• Использование IPv4 режима на UDP сокете теперь обязательно, вместо автоматического. Автоматический режим вызывал проблемы с правильным разрешением имени сервера LoRa из JSON конфигурационного файла (проблема MariaDB: https://mariadb.atlassian.net/browse/MDEV-4356, https://mariadb.atlassian.net/browse/MDEV-4379).

v2.1.0 - 2015-06-29

• Добавлен вспомогательный скрипт для сброса концентратора через GPIO, необходимый для IoT Starter Kit (reset_pkt_fwd.sh).

• Скрипт reset_pkt_fwd.sh также позволяет автоматически обновлять поле Gateway_ID в JSON конфигурационном файле, используя MAC-адрес платы.

• Обновлен JSON конфигурационный файл с правильными значениями по умолчанию для IoT Starter Kit: адрес сервера установлен на локальный сервер, путь к устройству GPS установлен на правильное значение (/dev/ttyAMA0).### v2.0.0 - 2015-04-30 ###

• Изменено: Несколько параметров конфигурации теперь задаются динамически из JSON-конфигурационного файла: смещение RSSI, источник часов концентратора, тип радио, таблица усиления TX, тип сети. HAL больше не требует перекомпиляции для обновления этих параметров. Пример для платформы IoT Starter Kit представлен в файле global_conf.json для базового, GPS и beacon packet_forwarder.

• Удалено: JSON-конфигурационный файл частоты диапазона удален. Пример для EU 868MHz представлен в файле global_conf.json для базового, GPS и beacon packet_forwarder.

• Изменено: Обновлены make-файлы для поддержки кросс-компиляции из переменных окружения (ARCH, CROSS_COMPILE).

ПРЕДУПРЕЖДЕНИЕ: Обновите ваш JSON-конфигурационный файл с новыми динамическими параметрами.

v1.4.1 - 2015-01-23

• Исправление ошибки: исправлена ошибка в параметре fdev, что приводило к неудачному FSK TX.
• Исправление ошибки: исправлено небольшое округление, зависящее от платформы.
• Бета: обновлен формат beacon, частично соответствующий последнему предложению класса B.

v1.4.0 - 2014-10-16 ###* Функциональное улучшение: добавлена поддержка TX FSK.

• Функциональное улучшение: опциональный автоматический выход при пропуске определенного количества PULL_ACK.

• Функциональное улучшение: время пинга вверх и вниз отображается на консоли.

• Исправление ошибки: некоторые маяки пропускались при высокой частоте маячков.

• Исправление ошибки: критическая ошибка snprintf вызывала аварийное завершение при длинных пакетах.

• Скорость передачи данных FSK теперь отображается в JSON вверх.### v1.3.0 - 2014-03-28 ###

• Функциональное улучшение: добавлена предварительная поддержка маяков для разработки класса B.

• Исправлены предупреждения при компиляции на x86_64 с 64-битными целыми числами.

• Обновлена система сборки для упрощенного развертывания на различных устройствах.

• Изменена организация потоков в программах-перенаправителях.

• Удалена дублирующаяся документация протокола.

v1.2.0 - 2014-02-03 ###* Функциональное улучшение: добавлен перенаправитель пакетов с GPS, используемый для временной метки полученных пакетов с глобально синхронизированным микросекундно точным временем.

• Функциональное улучшение: перенаправитель пакетов с GPS отправляет отчет о состоянии на канал вверх, спецификация протокола обновлена соответственно (отчет включает геолокацию шлюза).

• Функциональное улучшение: пакеты могут быть отправлены без CRC на радио-уровне.

• Исправление ошибки: больше не происходит аварийного завершения при введенном Base64-заполнении.

• Исправление ошибки: больше не происходит ошибок округления для значения 'freq', отправленного на сервер.

• Минимальное значение преамбулы 6 символов LoRa обеспечивает оптимальную чувствительность.

• Заполненный Base64 отправляется на канал вверх, канал вниз принимает заполненный и незаполненный Base64.

• Обновлена библиотека JSON Parson до версии, поддерживающей комментарии.

• Добавлено расширение .md (Markdown) для файлов readme для лучшего просмотра на Github.### v1.1.0 - 2013-12-09 ###

• Функциональное улучшение: добавлены параметры фильтрации пакетов в конфигурационные файлы JSON.

• Исправление ошибки: пакеты, отфильтрованные функцией receive(), больше не отправляются.

• Исправление ошибки: убраны ведущие нули для временной метки в JSON, так как это не соответствует стандарту JSON (может быть интерпретировано как восьмеричное число).

• Убрано расширение TXT для файлов README для лучшего интегрирования на GitHub.

• Улучшена документация, перемещена история изменений в верхний README.

• Изменены Makefiles для упрощения кросс-компиляции.

v1.0.0 - 2013-11-22

• Первоначальное выпуска перенаправителя пакетов, спецификации протокола и вспомогательных программ.

6. Юридическое уведомление

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

ПРОДУКТЫ SEMTECH НЕ ПРОЕКТИРУЮТСЯ, НЕ ПРЕДНАЗНАЧАЮТСЯ, НЕ АВТОРИЗУЮТСЯ И НЕ ГАРАНТИРУЮТСЯ ДЛЯ ИСПОЛЬЗОВАНИЯ В ПРИМЕНАХ С ОБЕСПЕЧЕНИЕМ ЖИЗНИ, УСТАНОВКАХ И СИСТЕМАХ ИЛИ ДРУГИХ КРИТИЧНЫХ ПРИМЕНАХ. ВКЛЮЧЕНИЕ ПРОДУКТОВ SEMTECH В ТАКИЕ ПРИМЕНЕНИЯ ПРИНИМАЕТСЯ КАК ПОДТВЕРЖДЕННОЕ ТОЛЬКО ЗА СЧЕТ СОБСТВЕННОГО РИСКА ЗАКАЗЧИКА. В случае, если заказчик приобретает или использует продукты Semtech для любого такого неавторизованного применения, заказчик обязуется компенсировать и освободить Semtech и его должностных лиц, сотрудников, дочерние компании, аффилированные компании и дистрибьюторов от всех претензий, стоимости, убытков и юридических расходов, которые могут возникнуть.Текста для перевода нет. Пожалуйста, предоставьте текст для перевода.