MeshCore

О MeshCore

MeshCore — это легковесная, портативная C++ библиотека, обеспечивающая многоскачковую маршрутизацию пакетов для встраиваемых проектов с использованием LoRa и других пакетных радиостанций. Она создана для разработчиков, которые хотят строить устойчивые, децентрализованные сети связи, работающие без интернета.

🔍 Что такое MeshCore?

MeshCore теперь поддерживает ряд устройств LoRa, что позволяет легко прошивать их без необходимости вручную компилировать прошивку. Пользователи могут загрузить предварительно собранный бинарный файл с помощью таких инструментов, как Adafruit ESPTool, и взаимодействовать с сетью через последовательную консоль. MeshCore предоставляет возможность создавать беспроводные ячеистые сети, аналогичные Meshtastic и Reticulum, но с упором на легковесную многоскачковую маршрутизацию пакетов для встраиваемых проектов. В отличие от Meshtastic, которая ориентирована на неформальное общение через LoRa, или Reticulum, предлагающей продвинутые сетевые возможности, MeshCore балансирует между простотой и масштабируемостью, что делает её идеальной для индивидуальных встраиваемых решений, где устройства (узлы) могут общаться на больших расстояниях, ретранслируя сообщения через промежуточные узлы. Это особенно полезно в автономных, аварийных или тактических ситуациях, когда традиционная коммуникационная инфраструктура недоступна.

⚡ Ключевые особенности

• Многоскачковая маршрутизация пакетов
  • Устройства могут пересылать сообщения через несколько узлов, расширяя дальность действия за пределы одного радио.
  • Поддерживается настраиваемое количество прыжков для баланса эффективности сети и предотвращения избыточного трафика.
  • Узлы используют фиксированные роли, где узлы-компаньоны (Companion) вообще не ретранслируют сообщения, чтобы избежать использования нежелательных путей.
• Поддержка радиостанций LoRa – работает с Heltec, RAK Wireless и другим оборудованием на основе LoRa.
• Децентрализованность и устойчивость – не требуется центральный сервер или интернет; сеть самовосстанавливается.
• Низкое энергопотребление – идеально для устройств с батарейным или солнечным питанием.
• Простота развёртывания – готовые примеры приложений облегчают начало работы.

🎯 Для чего можно использовать MeshCore?

• Автономная связь: оставайтесь на связи даже в удалённых районах.
• Экстренное реагирование и ликвидация последствий катастроф: быстрое создание сетей там, где инфраструктура разрушена.
• Активный отдых: связь во время походов, кемпинга и приключенческих гонок.
• Тактические и охранные приложения: для военных, правоохранительных органов и частной охраны.
• IoT и сети датчиков: сбор данных с удалённых датчиков и их ретрансляция в центральный пункт.

🚀 Как начать

• Посмотрите Плейлист QuickStart MeshCore от The Comms Channel
• Посмотрите Техническую презентацию MeshCore от Liam Cottle.
• Прочтите наши Часто задаваемые вопросы и Документацию.
• Прошейте прошивку MeshCore на поддерживаемое устройство.
• Подключитесь с помощью поддерживаемого клиента.

Для разработчиков:

• Установите PlatformIO в Visual Studio Code.
• Клонируйте и откройте репозиторий MeshCore в Visual Studio Code.
• Ознакомьтесь с примерами приложений, которые можно изменять и запускать:
  • Companion Radio — для использования с внешним чат-приложением через BLE, USB или Wi-Fi.
  • KISS Modem — последовательный мост протокола KISS для хост-приложений. (документация по протоколу)
  • Simple Repeater — расширяет покрытие сети путём ретрансляции сообщений.
  • Simple Room Server — простой BBS-сервер для общих постов.
  • Simple Secure Chat — защищённая текстовая связь между устройствами через терминал.
  • Simple Sensor — удалённый узел датчика с телеметрией и оповещениями.

С примером Simple Secure Chat можно взаимодействовать через монитор последовательного порта в Visual Studio Code или через USB-терминал для последовательного порта на Android.

⚡️ MeshCore Flasher

У нас есть предварительно собранная прошивка, готовая к загрузке на поддерживаемые устройства.

• Откройте https://meshcore.io/flasher
• Выберите поддерживаемое устройство
• Загрузите один из типов прошивки:
  • Companion, Repeater или Room Server
• После завершения прошивки вы можете подключиться с помощью одного из клиентов MeshCore, указанных ниже.

📱 Клиенты MeshCore

Прошивка Companion

К прошивке Companion можно подключиться через BLE, USB или Wi-Fi в зависимости от типа прошивки, которую вы загрузили.

• Web: https://app.meshcore.nz
• Android: https://play.google.com/store/apps/details?id=com.liamcottle.meshcore.android
• iOS: https://apps.apple.com/us/app/meshcore/id6742354151?platform=iphone
• NodeJS: https://github.com/liamcottle/meshcore.js
• Python: https://github.com/fdlamotte/meshcore-cli

Прошивки Repeater и Room Server

Прошивки Repeater и Room Server можно настроить через USB в веб-инструменте конфигурации.

• https://config.meshcore.io

Также ими можно управлять через LoRa в мобильном приложении с помощью функции удалённого управления.

🛠 Совместимость оборудования

MeshCore предназначен для устройств, перечисленных в MeshCore Flasher.

📜 Лицензия

MeshCore — это программное обеспечение с открытым исходным кодом, выпущенное под лицензией MIT. Вы можете свободно использовать, изменять и распространять его в личных и коммерческих проектах.

Участие в разработке

Пожалуйста, отправляйте Pull Request'ы, используя ветку 'dev' в качестве базовой! Для небольших изменений просто отправьте свой PR, и мы постараемся его рассмотреть, но для более «значительных» изменений, пожалуйста, сначала создайте Issue и начните обсуждение. Лучше сначала озвучить, чего вы хотите достичь, и попытаться прийти к консенсусу относительно наилучшего подхода, особенно если это влияет на структуру или архитектуру данной кодовой базы.

Вот несколько общих принципов, которым следует стараться следовать:

• Сохраняйте простоту. Пожалуйста, не думайте как программист высокоуровневого языка. Думайте о встраиваемых системах и делайте код кратким, без лишних слоёв.
• Никакого динамического выделения памяти, кроме как в функциях setup/begin.
• Используйте тот же стиль скобок и отступов, что и в основных модулях исходного кода (Скоро будет добавлен .clang-format, но, пожалуйста, НЕ переформатируйте ретроактивно существующий код. Это создаёт ненужные diff'ы, которые затрудняют поиск проблем).

Помогите нам расставить приоритеты! Отмечайте thumbs-up те issues/PR, которые наиболее важны для вас. Мы учитываем количество реакций при планировании работы.

Запуск модульных тестов

Чтобы запустить модульные тесты, выполните следующую команду:

pio test --environment native --verbose

План развития / Задачи

В очереди есть ряд довольно крупных функций, без привязки к конкретным срокам. В примерном хронологическом порядке:

• Compaion radio: редизайн интерфейса
• Repeater + Room Server: добавление ACL (как у Sensor Node)
• Стандартизация режима Bridge для ретрансляторов
• Repeater/Bridge: стандартизация транспортных кодов для зонирования/фильтрации
• Core + Repeater: улучшенное обнаружение соседей с нулевым прыжком
• Core: поддержка ручного маршрута с возвратом (round-trip)
• Companion + Apps: поддержка нескольких подсетей (и режим повтора клиента «off-grid»)
• Core + Apps: поддержка сжатия сообщений LZW
• Core: динамический CR (кодовая скорость) для слабых и сильных прыжков
• Core: новая инфраструктура для размещения нескольких виртуальных узлов на одном физическом устройстве
• Спецификация протокола V2: обсуждение и консенсус по пакетному протоколу V2, включая хеши путей, новые спецификации шифрования и т.д.

📞 Получить поддержку

• Сообщайте об ошибках и запрашивайте функции на странице GitHub Issues.
• Находите дополнительные руководства и компоненты на моём сайте.
• Присоединяйтесь к MeshCore Discord, чтобы пообщаться с разработчиками и получить помощь от сообщества.