Skip to main content

WisMesh Hub Quick Start Guide

WisMesh Hub is a solar-powered repeater that comes in a waterproof enclosure with a high-performance built-in antenna, making it deployable anywhere regardless of power availability or weather conditions.

This guide covers the basics for the RAKwireless Meshtastic devices that are not covered by the Meshtastic documentation.

For detailed instructions how to configure the devices for the Meshtastic network, follow the Meshtastic Getting Started guide.

NOTE

To be sure to run the latest version of the Meshtastic firmware, we advice you to download the Meshtastic firmware and upload it to your RAKwireless device to make it compatible with the Meshtastic network.

For Firmware 1.3 and 2.0 (from November 1, 2022), the WisBlock Base board is autodetected. There's a special firmware if you have the RAK14000 WisBlock E-Ink Display connected. All other use cases are covered in the stock firmware.

  • All the base boards with RAK4631 - firmware-rak4631-w.x.yy.zzzzzzz.uf2
  • RAK4631 with RAK14000 - firmware-rak4631_eink-w.x.yy.zzzzzzz.uf2

Prerequisite

Before going through each and every step on using WisMesh Hub, make sure to prepare the necessary items listed below:

Hardware

Software

The WisBlock Core module of the WisMesh Hub comes pre-flashed with the Meshtastic firmware.

However to connect the device to the Meshtastic network you will have to configure it. The preferred method for the configuration of the WisMesh Hub is from a mobile phone through a BLE connection with the following:

Alternatively, the WisMesh Hub has an USB connector in its unused battery cabinet. To access it, you have to open the battery lid. With the USB connection you can use either of these configurations:

The location of the USB connector is shown in Figure 5

Zoomable
Figure 1: WisMesh Hub USB access

Make sure that you have installed one of these applications, as they are required for the configuration of the Meshtastic network.

Product Configuration

Hardware Setup

The WisMesh Hub comes fully assembled. However, it is required to connect it to the Solar Battery Lite to power it up. The WisMesh Hub itself has no internal battery.

warning

The WisMesh Hub has the option to power the device with four LiSoCl2 batteries. But due to the power consumption of the Meshtastic LoRa network, it is not recommended to power the device with these non-rechargeable batteries. The lifespan of these batteries will be very limited.

Connect the battery

Connect the Solar Battery Lite to the WisMesh Hub as shown in Figure 6

Zoomable
Figure 1: WisMesh Hub connection to the Solar Battery
NOTE

The cable from the Solar Battery Lite can be plugged into any of the two connectors of the WisMesh Hub.

To recharge the battery, mount the Solar Battery Lite in direct sun light without any shadowing.

NOTE

For more details about the mounting options of the solar battery lite, refer to the Solar Battery Lite Installation Guide.

Antenna

The WisMesh Hub has internal LoRa and BLE antennas and does not require the assembly or connection of any external antenna.

Assembling and Disassembling of WisMesh Hub

warning

It is strongly recommended to keep both the WisMesh Hub and the Solar Battery Lite closed at all times. If the devices are opened, the devices might not be waterproof anymore and can be easily damaged.

Software Setup

To be sure to run the latest version of the Meshtastic firmware, we advice you to download the latest Meshtastic firmware and upload it to your RAKwireless device to make it compatible with the Meshtastic network.

For Firmware 1.3 and 2.0 (from November 1, 2022), the WisBlock Base board is autodetected. There's a special firmware if you have the RAK14000 WisBlock E-Ink Display connected. All other use cases are covered in the stock firmware.

  • All the base boards with RAK4631 - firmware-rak4631-w.x.yy.zzzzzzz.uf2
  • RAK4631 with RAK14000 - firmware-rak4631_eink-w.x.yy.zzzzzzz.uf2
Flashing the WisMesh Hub firmware:

The WisMesh Hub comes pre-flashed with the Meshtastic firmware. If you encounter problems, update the Meshtastic firmware to the latest version.

For the setup of the WisMesh Hub for the Meshtastic network, follow the configuration guide in the Meshtastic documentation.