Гайд для новичков#

Если ты впервые вкатываешься в MeshCore, то ниже представлено простое руководство, которое позволит впервые выйти в сеть.

Зайди в чат в телеге#

У воронежского сообщества MeshCore есть чат в котором люди смогут помочь, если возникнут какие-то проблемы.

Если увидишь непонятные слова – можешь глянуть словарь.

Анализ местности#

Зайти в раздел “карта” на meshcoretel, посмотри есть ли рядом с тобой наблюдатели или ретрансляторы (точки красного или синего цвета).

Зайди в раздел “покрытие” на meshcoretel. Приблизь карту к месту, где планируешь использовать MeshCore и вытяни ползунок в нижнем правом углу в крайнее правое положение (подпись должна быть “Геоблок P7”). Найди нужное место на карте и наведи туда курсор, в верхнем правом углу появится список устройств, которые тут бывает слышно и как хорошо.

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

Закупка оборудования#

Хорошим тоном является покупка настройка 2х устройств: репитера и компаньона. Плюс такой сетап позволит проверить работоспособность оборудования “на столе” до выхода в общую сеть. Но если пока не уверен в своем желании или ограничен в бюджете, то можно начать с одного компаньона.

Интернет нужен только на этапе настройки — чтобы скачать прошивку и приложение. В полевых условиях сеть работает без него.

Ссылки на товары могут протухать, тогда просто ищи по названию на любых маркетплейсах, но чаще всего самый оптимальный вариант будет заказать с Aliexpress. Также можно поискать в чате MeshCore/Барахолка или на Avito.

И почти наверняка тебе стоит смотреть в сторону устройств рассчитанных на 868MHz (а что на счет 433MHz?). При покупке обязательно проверяй на какую частоту рассчитан товар.

Компаньон#

Heltec T114 с антеной Gizont

Компаньон - устройство, преобразующее радио сигнал в понятный телефону или компьютеру bluetooth/wifi/usb. Этого устройства достаточно для выхода в сеть, если добиваешь до одного из соседних репитеров. Обычно представляет собой портативное устройство с маленькой антенной и аккумулятором.

Для компаньона важно иметь низкое энергопотребление, поэтому рекомендуется брать ноду с чипом nRF. Одним из популярных решений с хорошим соотношением цена/качество является Heltec T114. Но можешь выбрать и любой другой вариант ноды (включая самосборные).

Если ты не планируешь покупать репитер или планируешь часто общаться вне дома, где репитер будет не близко, то стоит сразу подумать об антене получше стандартной. Хорошим вариантом будет антена Gizont для 868MHz.

Репитер#

Репитер - аналог WiFi роутера. Он использует хорошую антену, часто питается от сети с резервным аккумулятором или от солнечной батареи. Всегда стоит на одном месте, является важной частью инфраструктуры Mesh сети и “доводит” сигнал до компаньона. Помогает увеличить покрытие сети.

Для репитера очень важна антена т.к. это связующий узел. Про антены есть отдельная статья. Если очень упрощать, то антены бывают направленные и всенаправленные. Выбор между ними не однозначный и сильно зависит от покрытия, застройки и высоты расположения. На практике лучше поэкспериментировать с разными вариантами антен.

В идеале нода должна быть автономной, чтобы могла работать в случае потери питания, поэтому было бы удачно подключить ее к аккумулятору/павербанку. А если обстановка располагает, то можно подключить солнечную панель.

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

  1. Ближайший сосед один и/или очень далеко (20+ км) - Яги.
  2. Ближайшая группа соседей в одной стороне на расстоянии ~10км и нет возможности поставить крупную антену - Moxon (Ozon, так добивает с левого берега до северного)
  3. Есть возможность поставить крупную антену - вертикальный штырь ~40см, например RAK (Ozon, с таким появилась первая связь между Рамонью и Воронежем)
  4. Нет возможности поставить крупную антену - вертикальный штырь ~20см, например Gizont (Али)

В идеале нода должна быть автономной, чтобы могла работать в случае потери питания, поэтому было бы удачно подключить ее к аккумулятору/павербанку. А если обстановка располагает, то можно подключить солнечную панель.

Установка приложения#

Выбери любое приложение на свой вкус из раздела приложения.

Прошивка и настройка#

Вот наконец железо на руках и надо их прошить и настроить. Прошивка делается через браузер и поддерживается только Chrome.

Перед прошивкой репитера обязательно подключаем антенну. Это нужно, чтобы не сжечь выходной тракт. В общем случае правило звучит так: антенна всегда должна быть подключена при передачи данных. Компаньон передает только когда мы на него отправляем сообщения, поэтому в общем случае это не обязательно. Но отправлять сообщения на нем без антенны тоже рисковано.

  1. Подключаем устройство USB кабелем. Нужно убедиться, что кабель имеет дата линии, иначе устройство будет просто получать питание.
  2. Заходим в онлайн прошивальщик.
  3. Выбираем свое устройство из списка.
  4. Выбираем прошивку “Companion Bluetooth” или “Repeater” соответственно.
  5. Ставим галочку “Erase device”.
  6. Нажимаем “Flush”.
  7. Дожидаемся окончания процесса.

Прим. если в будущем ты захочешь поставить кастомную прошивку (например мост или наблюдатель), то вместо выбора своего устройства из списка используй “Custom Firmware” в самом конце списка.

Настройка репитера#

  1. Не отключаем устройство от компа после прошивки (или подключаем заново, если на радостях уже отключили).
  2. Идем на страницу конфигуратора.
  3. Нажимаем “Connect” и во всплывающем окне выбираем наше устройство.
  4. Вверхней части видим публичные и приватные ключи, время и т.п. Ничего из этого не трогаем.
  5. Заполняем имя. У него должен быть суффикс -8R (обозначает репитер на частоте 868MHz). Подробнее см. правила именования устройств
  6. Выбери точку, которая примерно соответствует месту, где он установлен.
  7. Установи пароль админа. С его помощью ты в будущем сможешь настраивать репитер удаленно.
  8. Гостевой пароль можешь игнорировать.
  9. Настройки радио и адвертов возьми тут (Preset выбирать не нужно).
  10. Нажми на галочку “Show advanced settings” и выбери там “Path hash mode” - “2-byte (1)”.
  11. Перед окончанием поднимаемся в самый верх и нажимаем кнопку “Export”. Автоматически скачается файл с заполненными настройками. Его нужно сохранить в надежном месте т.к. если однажды потребуется перепрошить устройство на “чистую”, то поменяется ключ и для всех в сети нода продублируется. Особенно это критично для наблюдателей.
  12. Нажимаем внизу “Save settings”

Настройка компаньона#

Компаньон, в отличии от репитера, настраивается по Bluetooth. Настройка делается через любое приложение.

  1. В приложении подключаемся к устройству. Если у компаньона есть экран, PIN высветится на нём; для устройств без экрана PIN по умолчанию — 123456.
  2. Заходим в настройки.
  3. Задаем имя ноды. У него должен быть суффикс -8M (обозначает компаньон на частоте 868MHz).
  4. Настройки радио аналогичны тем, что задавали для репитера.

Отправка сообщений#

В приложении есть публичный канал #public. Ещё есть канал #public_mco, но он работает только в MCO Advanced.

  1. Выберите канал и напишите сообщение.
  2. Чтобы ваше присутствие увидели другие участники сети, отправьте ваш advert — нажмите на значок радио в правом верхнем углу приложения (метод Flood).

Тестирование#