diff --git a/index.html b/index.html index 4f3dbfd..76bd90e 100644 --- a/index.html +++ b/index.html @@ -408,6 +408,13 @@ Wardrive, MQTT, setup + + Repeater Setup +
+ Repeater Setup + Build and program a node +
+ @@ -439,6 +446,7 @@ diff --git a/meshcore-resources.html b/meshcore-resources.html index 8e7c6fd..d40c210 100644 --- a/meshcore-resources.html +++ b/meshcore-resources.html @@ -261,6 +261,7 @@

Official Links

meshcore.io

flasher.meshcore.io

+

CT Mesh repeater setup guide

Note: the flasher requires WebSerial or Web Bluetooth support in your browser

MQTT

diff --git a/repeater-hash-mode-1.png b/repeater-hash-mode-1.png new file mode 100644 index 0000000..2408564 Binary files /dev/null and b/repeater-hash-mode-1.png differ diff --git a/repeater-hash-mode-2.png b/repeater-hash-mode-2.png new file mode 100644 index 0000000..b5119e4 Binary files /dev/null and b/repeater-hash-mode-2.png differ diff --git a/repeater-hash-mode-confirm-iphone.png b/repeater-hash-mode-confirm-iphone.png new file mode 100644 index 0000000..b52d77a Binary files /dev/null and b/repeater-hash-mode-confirm-iphone.png differ diff --git a/repeater-hash-mode-entry-iphone.png b/repeater-hash-mode-entry-iphone.png new file mode 100644 index 0000000..a56101d Binary files /dev/null and b/repeater-hash-mode-entry-iphone.png differ diff --git a/repeater-setup.html b/repeater-setup.html new file mode 100644 index 0000000..bbcccf4 --- /dev/null +++ b/repeater-setup.html @@ -0,0 +1,552 @@ + + + + + + MeshCore Repeater Setup | CT Mesh + + + + + + + + + +
+
+
+ + CT Mesh + +
+ +

MeshCore Repeater Setup

+

This guide walks through the full repeater workflow: choose or build a MeshCore-compatible repeater node, flash and configure it over USB, then finish programming it from your phone using a separate companion node.

+

A repeater is the fixed radio that stays installed to relay traffic for the mesh. A companion is a second node you use to reach and manage that repeater from the MeshCore mobile app. The flow here is: build if needed, flash and configure over USB, test companion-based setup, then deploy the node.

+ +
+ Open MeshCore Flasher + Repeater Parts List +
+ +

Table of Contents

+ + +

Before You Start

+

How This Guide Is Organized

+

Start with the build section if you are assembling a repeater from parts. If you already have a finished repeater or an off-the-shelf device, begin at the flash section instead.

+

What You Will Need Overall

+ +
Note: Look for the MeshCore app by Liam Cottle to make sure you have the correct app. The phone apps do not require internet to use once installed. You just need the app on the phone and a working companion node to reach the repeater.
+ +

Build the Repeater Node

+

If you already have a repeater build or a ready-made device, skip this section and go straight to Flash the Repeater Node.

+

What You Will Need

+ +

Prepare the Enclosure

+
    +
  1. Drill the top of the enclosure for the N-type bulkhead connector. Test-fit as you go so the hole stays snug.
    2. +
  2. Drill the bottom for the solar panel cable input. This opening can also act as a pressure vent.
    3. +
+

Mount the Solar Hardware

+
    +
  1. Mount the solar panel where it gets reliable sun. If you are mounting it to the case, leave enough wire slack for the door to open without pulling on the cable.
    2. +
  2. Splice the panel lead to the included JST pigtail from the Heltec box.
    3. +
+

Install the Radio Hardware

+
    +
  1. Install the N-type bulkhead, attach the antenna to the bulkhead, and connect the radio to the IPEX lead.
    2. +
  2. If you are using a screenless V4, attach the included Bluetooth/Wi-Fi antenna.
    3. +
+

Finish the Physical Assembly

+
    +
  1. After programming is complete, connect the battery and solar lead, then secure the board and battery with zip ties.
    2. +
  2. Seal the bulkhead opening and any other penetrations with outdoor waterproof sealant before deployment.
    3. +
+ +

Flash the Repeater Node

+

This is the point where everyone should start if the repeater hardware already exists.

+

What You Will Need

+ +

An optional power-saving mode is covered in the addendum at the bottom of this guide.

+

Option 1: MeshCore Web Flasher

+
    +
  1. Connect the radio to your computer and open flasher.meshcore.io.
    2. +
  2. Use a Chromium-based browser such as Chrome so the site can access the radio over USB.
    3. +
  3. Load the correct firmware for your hardware and complete the flash.
    4. +
+

Option 2: Flash ESP32 Devices with esptool.py

+
    +
  1. Download the correct firmware file for your repeater hardware from the MeshCore GitHub releases page.
    2. +
  2. Install esptool.py if needed.
    3. +
  3. Put the repeater device into bootloader mode if your hardware requires it.
    4. +
  4. Identify the serial port for the device, then flash the firmware with a command like:
    5. +
+
Example: esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x0 firmware.bin
+
    +
  1. Adjust the serial port, chip target, and firmware filename to match your hardware.
    2. +
+

Option 3: Flash RAK Devices with .uf2

+
    +
  1. Download the correct .uf2 firmware file for your RAK device from the MeshCore GitHub releases page.
    2. +
  2. Put the device into the appropriate USB programming mode. Depending on the model, this may mean holding reset while plugging in USB, or holding the boot button while connecting the USB cable.
    3. +
  3. If a USB flash drive appears, copy the .uf2 firmware file onto that drive and allow the device to reboot when the copy finishes.
    4. +
  4. On some devices you may need to temporarily disconnect the battery during programming.
    5. +
  5. Check the instructions for your exact device and make sure you selected the correct firmware image for that model.
    6. +
+

Configure the Node Over USB

+
Post-flash note: After flashing by any supported method, the node screen may show Please Wait... for up to about a minute during initial setup. If it stays there for more than 5 minutes, retry the flash.
+

After flashing by any supported method, finish the initial repeater configuration over USB before trying to complete setup through the companion.

+
    +
  1. Go to meshcore.io and click Repeater Setup using the gear icon next to it. This opens the Repeater / Room server USB setup page at config.meshcore.io.
    2. +
  2. In the upper-right corner of that page, click Connect.
    3. +
  3. When the browser asks which serial device to use, select your repeater. This is often the top device in the list.
    4. +
  4. Set the repeater name.
    5. +
  5. Set Owner info only if you want public contact details attached to the repeater. This can include a name, phone number, email address, and/or website. This field is publicly shared and has a 119 byte limit.
    6. +
  6. Set the repeater location by clicking the map button, or by copying and pasting latitude and longitude from your web browser for the intended repeater site.
    7. +
  7. Under Access, set a new admin password. This is recommended because it lets you further configure the repeater later from the mobile app for more advanced settings.
    8. +
  8. Leave Guest password empty unless you have a specific reason to enable it.
    9. +
  9. Under Radio settings, set the preset to USA/Canada (Recommended).
    10. +
  10. That preset defaults to: + Frequency 910.525, + Bandwidth 62.5, + Spreading Factor (SF) 7, + and Coding Rate (CR) 5. +
    11. +
  11. If you want additional error correction, you can increase CR as high as 8. This increases radio airtime substantially, nearly doubling it, and can reduce battery life.
    12. +
  12. Your device instructions will often specify the correct TX Power setting. Never set TX power above 30 dBm, which is the FCC limit in the United States.
    13. +
  13. Under Advertising, adjust the values as needed. The UI shows fields for Advert interval (minutes), Flood advert interval (hours), and Flood max.
    14. +
  14. Click Save settings at the bottom, then reboot the device.
    15. +
+
+ Notes: + +
+ +

Programming with a Companion

+

What You Will Need

+ +

Program the Repeater

+
    +
  1. Power on both devices: the repeater and your separate companion node. Make sure the repeater is within range.
    2. +
  2. Open the MeshCore app on your phone. In the upper right, tap the Bluetooth icon where it shows Connect.
    3. +
  3. Choose your companion node from the devices shown and provide the Bluetooth code if needed.
    4. +
  4. Once connected in the app, open the three-dot menu, tap Tools, then tap Discover Nearby Nodes, and then Discover repeaters.
    5. +
  5. The repeater should be discovered quickly if it is powered on and in range. Add it as a contact. You can also favorite it if you want.
    6. +
  6. Open the repeater contact, tap Manage, and enter the admin password.
    7. +
  7. This opens the repeater admin status page. Tap Request status if you want to refresh and view the repeater status.
    8. +
  8. At the bottom of that screen, open Command Line and run set path.hash.mode 1 to set 2 byte mode. View screenshot View result
    9. +
  9. Tap the Settings icon in the bottom right next to Command Line to change other node settings such as advert intervals, owner info, position, syncing the device clock, and other access control or telemetry settings.
    10. +
  10. Set Flood advert interval (hours) to 48 for best public mesh performance if you have not already set it during USB configuration.
    11. +
+
Notes: + +
+ +

Deploy the Node

+

Choose a Good Site

+ +

Tree Mounting

+

For tree installs, a common approach is to use a slingshot to place a lightweight mason line over a suitable branch, then use that line to pull up a stronger rope for hoisting and securing the node. Choose a healthy branch, avoid power lines, and make sure the enclosure and antenna can hang clear without rubbing through on bark or hardware.

+

Structure or Pole Mounting

+

Nodes can also be attached to the side of a structure, a mast, a fence post, or a utility-style pole using appropriate brackets, hose clamps, or other weather-resistant mounting hardware. Keep the enclosure secure, keep cable runs tidy, and position the antenna with as much clear exposure as practical.

+

Other Mounting Options

+

Other logical mounting options include sheds, garages, balcony rails, old TV antenna mounts, rooftop masts, and similar elevated locations with stable support and useful line-of-sight.

+
Spacing Note: If you have more than one LoRa device at a site, keep the LoRa antennas at least 3 feet apart for optimal performance.
+ +

Need More Context?

+

If you want help validating a parts list, firmware choice, or deployment location, ask in Discord before you seal everything up and mount it.

+
+ More MeshCore Guides + Join CT Mesh Discord +
+ +

Power Saving Addendum

+

If you are running a solar-powered repeater or otherwise want to reduce current draw, power saving is available as an optional post-setup change.

+

After logging into the repeater, open the command line and run powersaving on.

+

This can be useful for deployments where power budget matters, especially small solar installations.

+

If you want a lower-power firmware variant, you can also use the flasher's custom firmware option with releases from EasySkyMesh.

+ + Back to CT Mesh + +
+ + + +