|
|
| Line 22: |
Line 22: |
| |} | | |} |
|
| |
|
| == Installing a node ==
| | [[Installing a Node]] |
| | |
| Take the node from the box and charge it fully over USB-C.
| |
| | |
| === Flashing and configuring ===
| |
| * Connect with USB-C to your computer and open [https://flasher.meshcore.co.uk/ MC flasher] in Chrome.
| |
| * Repeaters can't be configured in the app, but need their [https://config.meshcore.dev/ online config tool].
| |
| | |
| ''Note to self: we need to have an offline option as well.''
| |
| | |
| === When setting up take note to ===
| |
| * Jot down the public key on your laptop so you can later add the repeater to your companion contact list.
| |
| * Set preset to EU/UK Narrow.
| |
| * Set the location of the node on the map.
| |
| | |
| === Other settings ===
| |
| * set tx 2
| |
| * set agc.reset.interval 4
| |
| * set multi.acks 1
| |
| * set rxdelay 3
| |
| * Auto Advert Interval (Flood): Set to 12 hours or more (up to 48 hours).
| |
| * Auto Advert Interval (Zero Hop): Set to 0 (disabled).
| |
| | |
| === Public/Private key issues ===
| |
| | |
| * Public Key: Check if your auto-generated Public Key prefix (the first two characters) are unique.
| |
| * Go to the MeshExplore Stats [https://map.w0z.is/stats].
| |
| ** Is there already a repeater using your prefix? If no, you're good to go.
| |
| ** Is your prefix in use? Scroll down to the MeshExplore Unused Repeater Prefixes.
| |
| ** Select one you would like to use and the Meshcore Custom Key Generator site will open. You will see the prefix you selected. Click Generate Key.
| |
| | |
| Copy the public and private keys and save them. We'll finish setting up the repeater and change them at the end using the web console.
| |
| | |
| * Name: It is helpful if your repeater gives a hint about the location, such as a landmark, neighborhood or cross streets.
| |
| * Location: Set the Latitude and Longitude in decimal format (47.xxxx, -122.xxxx).
| |
| * Guest and Admin Password: Use a strong password. Repeaters can be administered over the mesh from the Meshcore app.
| |
| | |
| === Radio Settings ===
| |
| * Repeaters and clients use the “USA/Canada (Recommended)” preset.
| |
| ** Frequency: 910.525 MHz
| |
| ** Bandwidth: 62.5 kHz
| |
| ** Spreading Factor: 7
| |
| ** Coding Rate: 5
| |
| | |
| === Setting Private and Public Keys ===
| |
| If your auto-generated key did not have a unique prefix, you should have generated a new private and public key and saved them. Go back to the Web Flasher [https://flasher.meshcore.co.uk/] and above the list of all the devices, on the right side, click on the Console button and connect to your device. Once you are connected you will see a command prompt:
| |
| | |
| * At the prompt, type in <code>set prv.key</code> and paste in your Private Key.
| |
| * Type in <code>reboot</code>.
| |
| * After your device reboots, verify that the private key is correct by running <code>get prv.key</code>.
| |
| | |
| === Path hash mode ===
| |
| * <code>get path.hash.mode</code> to check current setting (should be 0).
| |
| * Change it with <code>set path.hash.mode 1</code> for 2-byte, <code>set path.hash.mode 2</code> for 3-byte.
| |
| | |
| === Region Settings ===
| |
| Should we add `nl-ams` to all repeaters?
| |
| | |
| === Last checks ===
| |
| * Test if you can add the node to your companion user list before you put it in a high and hard-to-reach position.
| |
| * Make sure that the solar panel is facing south.
| |
| | |
| === Current issues ===
| |
| * Douwe has to learn how to do OTA updates.
| |
| | |
| == Setup hardware ==
| |
| The setup process is nicely detailed in a booklet in the box.
| |
| | |
| ---
| |
| | |
| = Antenna Docs =
| |
| == Summary ==
| |
| Antennas and their qualities.
| |
| | |
| == Antennas ==
| |
| There are several antennas.
| |
| | |
| Henk ordered these:
| |
| | |
| [[File:antenna_order.png|thumb|center|Antenna bill]]
| |
| | |
| | |
| == Sensecap Solar P1 OTA ==
| |
| | |
| OTA = Over the air
| |
| | |
| Unfortunately, we first need to flash all the sensecaps with different bootloader firmware.
| |
| | |
| == Adafruit Bootloader ==
| |
| | |
| [https://github.com/oltaco/Adafruit_nRF52_Bootloader_OTAFIX Adafruit Bootloader Repository]
| |
| | |
| === Install adafruit-nrfutil ===
| |
| To install the utility, run the following command:
| |
| <pre>
| |
| pip3 install adafruit-nrfutil
| |
| </pre>
| |
| | |
| === Download the Firmware ===
| |
| Download the firmware for the Solar P1. Note: the file is named: ''Seeed Studio XIAO nRF52840 BLE (and Seeed SenseCAP Solar Node)''. Currently available here:
| |
| | |
| [https://github.com/oltaco/Adafruit_nRF52_Bootloader_OTAFIX/releases/download/0.9.2-OTAFIX2.1-BP1.2/xiao_nrf52840_ble_bootloader-0.9.2-OTAFIX2.1-BP1.2_s140_7.3.0.zip xiao_nrf52840_ble_bootloader-0.9.2-OTAFIX2.1-BP1.2_s140_7.3.0.zip]
| |
| | |
| Run the following command to flash the firmware:
| |
| <pre>
| |
| adafruit-nrfutil --verbose dfu serial --package xiao_nrf52840_ble_bootloader-0.9.2-OTAFIX2.1_s140_7.3.0.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
| |
| </pre>
| |
| | |
| [[File:adafr_dfu.png|thumb|center|adafruit-nrfutil]]
| |
| | |
| === Flashing Steps ===
| |
| * Open [https://flasher.meshcore.co.uk Meshcore Flasher].
| |
| * Select the "Sensecap Solar P1".
| |
| * Put the Solar P1 in DFU mode.
| |
| * ERASE FLASH (Unfortunately, settings and history are lost).
| |
| * [https://flasher.meshcore.co.uk Flash] the (pre-last, not the newest) Meshcore firmware.
| |
| * The device will reboot.
| |
| | |
| == OTA (Over the Air - Using Bluetooth to Upgrade Firmware) ==
| |
| | |
| * Open the Meshcore client (on your phone).
| |
| * Connect the companion device.
| |
| * Select the Solar Node in the device list.
| |
| * Open "Remote Management".
| |
| * Go to "Command Line".
| |
| * At the prompt, type: <code>Start ota</code>.
| |
| | |
| [[File:ota_img.png|thumb|center|Start OTA]]
| |
| | |
| * It will respond: <code>OK - mac: xx:xx:xx:xx:xx:xx</code>.
| |
| * Now open the "Nordic Semiconductor DFU" app.
| |
| * Select the ZIP file containing the firmware you want to update.
| |
| * Select the device.
| |
| * Bluetooth will be turned on.
| |
| | |
| [[File:dfuapp.png|thumb|center|DFU App]]
| |
| | |
| * Select the Solar P1 (check if the MAC address corresponds with the MAC address you got from the Remote Management command).
| |
| * Press "Start".
| |
| | |
| [[File:fwupfault.png|thumb|center|Firmware Upgrade - First Attempt]]
| |
| | |
| * Mostly, the first attempt fails...
| |
| | |
| === Retry the Upgrade ===
| |
| * Open the DFU app again.
| |
| * Select the device (which is now called "XIAO-DFU").
| |
| * Press "Start".
| |
| | |
| [[File:fwupgrade.png|thumb|center|Firmware Upgrade Progress]] [[File:fwup.png|thumb|center|Firmware Upgrade Complete]]
| |
| | |
| * Wait and monitor the progress until it says "Completed".
| |
| * The node will reboot into the freshly installed firmware.
| |