Skip to main content

Get Started with Meshtastic

The SenseCAP MeshPager X2 Series uses physical buttons to operate two Meshtastic interfaces: MUI, with graphical pages and maps, and Base UI, with information screens and menus.

For specifications, connectors, and pin assignments, see SenseCAP MeshPager X2 Series Introduction.

Before powering on

Connect a LoRa antenna matched to the operating band. Use the specified X2 battery, rated for 4.4 V charging; a cell rated for a maximum charge voltage of 4.2 V is unsuitable.

Flash Firmware​

If firmware is already installed, continue to Get Started.

  1. Connect X2 to a computer using a USB data cable.
  2. Open the Meshtastic Web Flasher in a browser that supports Web Serial, such as desktop Chrome or Edge.
  3. Open Select Target Device and look for Seeed MeshPager X2. If it is available, select it and choose a compatible firmware version.
  4. Click Flash and follow the prompts to enter download mode and select X2's current USB port. Keep USB connected until programming completes.
If X2 is not listed

X2 was not present in the public Web Flasher's device list when this guide was checked. If you cannot find Seeed MeshPager X2, use the X2 factory image and Manual Firmware Installation. Do not select another device model for X2.

To force X2 into firmware flashing mode, press and hold Power and Return at the same time, then plug in the USB cable. Keep both buttons held for 1 second, then release them.

To flash a downloaded X2 .factory.bin, follow Manual Firmware Installation with esptool.

Use X2 firmware only

Use firmware for Seeed MeshPager X2 (seeed_meshpager_x2) and follow the instructions supplied with the image. Enable full erase only when required, and back up your settings first.

Get Started​

Power On and Navigate​

  1. Connect a regulated 5 V USB supply to the USB-C port to charge the battery.
  2. Use the Power key to start X2. To leave the charge-only screen, release Power, then hold it for approximately 5 seconds.
  3. Wait for Base UI or MUI to load.

With USB connected, shutting down may return X2 to the charge-only screen.

Forced Restart​

To force X2 to restart, press Power and plug in a powered USB-C (Type-C) cable at the same time.

Button Controls​

KeyBase UIMUI
Up / DownBrowse menu items, nodes, or message threads. From Home, open the message composer.Highlight navigation icons or controls.
Left / RightSwitch information screens or move between keyboard keys.Right enters a highlighted page. Within a page, switch tabs, adjust sliders, or move between keyboard keys.
Confirm (left orange key)Open a screen's menu or select an item.Activate the highlighted item.
Hold ConfirmRun the selected control's long-press action, where supported.Run the selected control's long-press action, where supported.
ReturnCancel input or close a menu.Close a keyboard, list, or dialog, or go back one level.
PowerShort press: screen off/wake. Hold approximately 4 seconds: shutdown.Short press: screen off/wake. Hold approximately 4 seconds: shutdown.

In this guide, select means highlight an item with the direction keys and press Confirm. Confirm is the orange key below the screen on the left, marked with a horizontal line. Left/Right refer to the direction pad.

UI Switching​

Choose the switching direction below. Reflashing is not required.

Close-up of MeshPager X2 Base UI showing battery, node, satellite, and channel-utilization information
Base UI — information screens and menus.
Close-up of MeshPager X2 MUI showing the Home page and navigation icons along the left edge
MUI — graphical pages and maps.
  1. Use Left/Right to reach System, then press Confirm.
  2. Select Reboot/Shutdown → Switch to MUI → Yes.
  3. Wait for X2 to restart into MUI.
Base UI to MUI. Video ends during restart.

Phone Connection​

Step 1. Enable Bluetooth on X2.

Bluetooth is enabled after switching from MUI. To enable it manually, open System, press Confirm, and select Bluetooth Toggle. Restart if prompted. If Wi-Fi prevents Bluetooth pairing, disable Wi-Fi first.

X2 Base UI Home screen with BT off and the example node name outlined in red
1. Check Bluetooth status. BT off means Bluetooth is disabled. The node name shown here is an example; look for your own X2 in the app.
X2 Base UI System Action menu with Bluetooth Toggle and the left orange Confirm key outlined in red
2. Enable Bluetooth. On the System screen, press Confirm, select Bluetooth Toggle, and follow any restart prompt.

Step 2. Download Meshtastic App

Click here to download the Meshtastic app for iOS or Android.

Step 3. Pair with Device

Enable Bluetooth on your phone, open the Meshtastic app, and grant the requested Bluetooth or Nearby Devices permissions. The screenshots below illustrate the app workflow; select your X2's device name from the list.

  1. Open the Bluetooth panel in the Meshtastic app and select your X2 under Available Radios.
Meshtastic iOS app Bluetooth panel with an example radio highlighted under Available Radios
  1. Enter the code shown on X2's screen, then tap Pair to connect. If you configured a fixed PIN, use that PIN.
iOS Bluetooth pairing request showing the PIN entry field and Pair button

Wait for the device configuration to load before changing settings.

Configure LoRa​

Before communicating over the mesh, set your region. This setting controls the frequency range your device uses and should match your location, X2's 863–928 MHz radio hardware, and its antenna.

Region List

Region CodeDescriptionFrequency Range (MHz)Duty Cycle (%)Power Limit (dBm)
UNSETUnsetN/AN/AN/A
USUnited States902.0 - 928.010030
EU_868European Union 868MHz869.4 - 869.651027

Refer to LoRa Region by Country for a more comprehensive list. The power limits above are Meshtastic region limits; X2's actual transmit power also depends on its hardware and firmware.

EU_868 duty cycle

EU_868 has a 10% duty-cycle limit, calculated every minute over a rolling hour. If the device reaches this limit, it stops transmitting until transmission is allowed again.

  1. Use Left/Right to reach LoRa, then press Confirm.
  2. Select LoRa Region, choose your region, and confirm any prompts.
X2 Base UI LoRa Actions menu with LoRa Region and the Confirm key outlined in red
Open region settings. Select LoRa Region, then choose the region for your location on the next screen.
X2 Base UI LoRa Info screen showing the example US region, LongTurbo preset, frequency, and a BLE identifier
Check the current configuration. LoRa Info shows the region, modem preset, and frequency. This example uses US / LongTurbo; use the settings appropriate for your location and group.

The four-character BLE label on LoRa Info is a device identifier, not the Bluetooth pairing PIN. When pairing, use the PIN displayed by X2's pairing prompt or your configured fixed PIN.

To communicate with other nodes, match their modem preset, frequency slot, channel name, and pre-shared key. You can configure these settings or import your group's channel configuration in the phone app.

Transmit power and duty-cycle settings must comply with local regulations. See Meshtastic LoRa configuration for details.

Map Usage​

Use MUI to view maps. For your current location, enable GPS and wait for a fix outdoors; see Configure GPS.

Offline maps require MUI and a microSD card.

Step 1. Prepare the card.

  1. Back up the card before formatting; formatting erases its contents. Prepare the card with MBR partitioning and FAT32.
  2. Download a style ZIP from the Meshtastic UI map starter kit, such as osm.zip or atlas.zip.
  3. Extract the archive to the card's root, preserving the folders inside it. Check the resulting path rather than adding another maps folder around the extracted files:
microSD root/
└── maps/
└── <style>/
└── <zoom>/
└── <x>/
└── <y>.png

For example, a style named osm belongs under /maps/osm/. Avoid an extra folder level such as /maps/maps/osm/.

  1. Safely eject the card after copying finishes.
Start with an overview map

The official starter-kit archives contain worldwide tiles at zoom levels 1–6. Zoom out to level 6 or lower to check that the map loads. For street-level detail, download tiles covering your area at higher zoom levels; the starter kit alone does not include those details. See the map download instructions.

Step 2. Insert the card and open the map.

MeshPager X2 microSD card slot with the outer cover removed
X2 microSD card slot.
  1. Shut down X2 and disconnect USB before inserting or removing the card.
  2. Insert the microSD card fully, then start X2 and enter MUI.
  3. For your current location, enable GNSS and wait for a fix outdoors.
  4. Enter Map and select the style matching your tiles.

Downloaded tiles work without Wi-Fi or cellular service.

MeshPager X2 MUI Locations Map showing street tiles, location markers, zoom buttons, and navigation controls
MUI map with location markers, zoom, and navigation controls.

Step 3. Navigate with the buttons.

Map stateOperation
BrowseUse the direction keys to pan.
Open controlsPress Confirm.
Zoom or positionUse Up/Down to highlight a control, then Confirm.
Back to mapPress Return.
Back to navigation barPress Return again.

Send and Read Messages​

Compose a message

  1. Use Left/Right to reach the Home information screen.
  2. Press Up or Down to open the message composer.
  3. Select [Select Destination], then choose a channel or node.
  4. Select a canned message to send it, or [-- Free Text --] to open the keyboard.
  5. Use the direction keys and Confirm to enter characters. Use the keyboard's backspace key to delete.
  6. Select the keyboard's Enter key to send. Return cancels input.

You can also open the composer from the Messages screen: press Confirm and select New Preset Msg in the Message Action menu. Check the destination before choosing a preset or entering free text.

X2 Base UI Message Action menu with New Preset Msg and the Confirm key outlined in red
Open the message composer. On Messages, press Confirm and select New Preset Msg. Choose the destination and a canned message, or select Free Text to open the keyboard.
X2 Base UI free-text keyboard with the character keys and ENTER outlined in red, addressed to the example LongTurbo channel
Type and send. Check the recipient beside To:, use the direction keys and Confirm to type, then select ENTER to send. LongTurbo is the example destination.

If the composer is unavailable, enable the Canned Message module in the phone app and use firmware with on-screen keyboard support.

MeshPager X2 Base UI showing the Message sent to LongFast confirmation
Base UI: message sent to the LongFast channel.

Read messages

Use Left/Right to reach the message screen, Up/Down to browse threads, and Confirm to open conversation actions.

Direct messaging requires the devices to exchange node information and public keys first.

Advanced Usage​

Connect via Website​

Use the Meshtastic Web Client to read messages, send text, and configure your node from a browser. Use desktop Chrome or Edge with firmware that supports the selected connection method. Browser support varies; see the Web Client compatibility guide.

Step 1. Open the Web Client.

Meshtastic Web Client landing page

Step 2. Add a connection. Select New Connection. The screenshots illustrate the client workflow; device names and port numbers are examples. Select your own X2 when connecting.

New Connection button in the Meshtastic Web Client

Step 3. Choose a connection method.

  1. Enable Bluetooth on X2. In MUI, enter the Bluetooth connection mode described in Phone Connection.
  2. Disconnect the phone app from X2 so the browser can connect.
  3. Select Bluetooth in the Web Client and choose X2 in the browser's device picker. Complete pairing if prompted.
  4. Wait for the node configuration to load, then open a channel or conversation.

Step 4. Check the connection. Select the added device to connect if it is not already connected. The client then displays the node's status and loads its configuration. Open the message view to select a channel or a node conversation.

Example node shown as connected in the Meshtastic Web Client

Configure GPS​

Use X2 outdoors with a clear view of the sky and wait for a satellite fix.

Use Left/Right to reach Position, press Confirm, and select On/Off Toggle → Enabled.

MeshPager X2 Base UI Position screen showing satellite count, latitude, longitude, and altitude
Base UI position screen.

Configure on Phone

Connect the Meshtastic app to X2, open Position under the device's radio configuration, and adjust the settings below. Save your changes and reconnect if the device restarts.

SettingWhat it controls
GPS ModeEnable or disable X2's GNSS receiver.
GPS Update IntervalHow often the device requests a new GNSS position.
Position Broadcast IntervalHow often the device broadcasts its position over the mesh.
Smart PositionAllow position broadcasts based on movement, subject to the configured thresholds.
Fixed PositionUse a fixed location. Disable this when you want the device's location to follow its movement.
Meshtastic phone app Position settings for GPS updates and position broadcasts

Shorter intervals can provide more frequent updates, but increase power use or mesh traffic. Choose intervals suitable for how often the device moves. See Meshtastic Position configuration.

iOS location permission

If you use the phone's location in the Meshtastic app or share it with a node, allow location access and enable Precise Location for Meshtastic in iOS Settings. This permission controls the location supplied by the phone; X2's built-in GNSS receiver obtains its own fix independently.

iOS location permission settings with Precise Location enabled for Meshtastic

Sensor connection​

X2 has built-in sensors for environmental readings, compass heading, and motion detection. Configure them according to the function you want to use:

SensorFunctionConfiguration
SPA06-003 barometerPressure and sensor temperature readings.Telemetry → Environment in the phone app.
BMM350 magnetometerCompass heading.Position → Compass and Compass Calibrate in Base UI.
Six-axis IMUAcceleration and angular velocity measurements.Used by supported firmware features; the environmental Telemetry page does not display raw six-axis readings.

Enable environmental telemetry

  1. Connect to X2 and open Settings → Module Configuration → Telemetry.
  2. Enable Environment Metrics Enabled and set the Environment Metrics interval.
  3. Enable Show on device screen if you want supported environmental readings on Base UI, then save the settings.
Meshtastic iOS app Telemetry settings for environmental measurements and on-screen display

The screenshots use example nodes and readings. X2's environmental telemetry displays readings supported by its detected sensor and installed firmware. It does not enable compass calibration or transmit raw accelerometer and gyroscope readings. For compass operation, use the Position tab under Other Function.

Other Function​

Use the direction keys to highlight a control. Press Confirm to select it, or hold Confirm for its long-press action. Press Return to close a dialog or go back. Menu availability depends on the installed firmware and enabled modules.

X2 operationEffect
Hold Confirm on HomeResynchronize MUI with the node's configuration and data.
Hold Confirm on NodesOpen the node filters.
Hold Confirm on SettingsLock the display. Use Power to wake it and enter the screen PIN if configured.

The microphone and speaker provide hardware for future voice-messaging updates. Notification sounds can be configured using the controls above.

FAQ​

Device can not pair with Phone via BLE​

  • In MUI, enter Bluetooth pairing mode before searching for X2 in the phone app. Open Settings → Reboot / Shutdown, highlight the Bluetooth icon, and short-press Confirm. Wait for the pairing screen and use the PIN displayed on X2.
MUI Settings, Reboot / Shutdown menu, and Bluetooth pairing mode

On X2, use the direction keys to highlight controls and press Confirm to select them. For the X2 button illustrations, see Phone Connection.

  • In Base UI, enabling Wi-Fi disables Bluetooth. To keep using Wi-Fi, connect the phone to the same network and choose Network in the Meshtastic app, using X2's IP address. To pair over BLE instead, disable Wi-Fi and enable System → Bluetooth Toggle on X2.
Meshtastic phone app Network connection settings
  • Enable Bluetooth on the phone and grant the app its Bluetooth / Nearby Devices permissions. Disconnect any other phone or browser already connected to X2, then scan again.
  • If pairing still fails, forget the old X2 pairing in the phone's Bluetooth settings and reconnect from the Meshtastic app. Enter the current on-screen PIN or your configured fixed PIN.

Device can not connect with my Wifi​

  1. Use a 2.4 GHz Wi-Fi network. X2 does not support 5 GHz Wi-Fi. To test the connection, try a phone hotspot configured for 2.4 GHz.
  2. Check the Wi-Fi name and password, including capitalization, then enable Wi-Fi after saving them. Follow the Online Map tab in Map Usage.
  3. Check the Wi-Fi icon and IP address on the MUI Home page. A grey icon and empty IP field indicate that Wi-Fi is disabled or has not connected. A white icon with an IP address indicates a connection.
MUI Home page showing Wi-Fi icon and IP address before and after connecting

Entering Bluetooth connection mode disables Wi-Fi. After returning to MUI, enable Wi-Fi again when you need online maps. The Wi-Fi network must also provide internet access to download map tiles.

Device automatically turn off​

Description

  • X2 turns off or repeatedly restarts shortly after powering on.
  • Serial logging stops and the device becomes unresponsive.

Troubleshoot

  1. Check the battery charge and USB power connection. If only the screen has gone dark, short-press Power to check whether X2 is still running. Screen timeout is different from a shutdown.
  2. If X2 shows only the charging screen, release Power, then hold it for approximately 5 seconds to start Meshtastic. Avoid interrupting power while settings are being saved or firmware is being written.
  3. If the device remains unresponsive, follow Forced Restart. If it repeatedly restarts after that, capture the startup serial log to help identify the cause.
  4. If the problem persists with a stable power supply, perform a clean installation of compatible X2 firmware. Follow Manual Firmware Installation for the full-erase factory-image procedure.
Clean installation

A full erase removes settings, channels, keys, and saved data. Save anything you need before continuing. After reinstalling, configure the LoRa region and channels again.

Factory Reset​

A factory reset restores the default configuration. Save the settings and channel information you want to keep before resetting.

  1. Open Settings → Configuration Reset.
  2. Select Factory Reset, then select OK using the direction keys and Confirm.
  3. Wait for X2 to restart with the default configuration.
MUI Configuration Reset menu with Factory Reset and its confirmation dialog

Reconnect to X2 after the restart and set the correct LoRa region and channels before using the mesh.

Direct Message Fail​

First check that both nodes use compatible LoRa settings and are within range, directly or through the mesh. Try sending a shared-channel message. If channel messages work but direct messages fail, check the stored node information and keys below.

NodeDB Reset​

NodeDB stores information about nodes discovered on the mesh. An outdated entry, such as one saved before the other node changed its keys, can prevent direct messaging. Resetting NodeDB clears the local node database so the device can discover nodes again.

Open Settings → Configuration Reset, select NodeDB Reset, and select OK. Use the direction keys and Confirm on X2. The device will restart.

MUI Configuration Reset menu with NodeDB Reset and its confirmation dialog

Allow time for the node list to repopulate, then exchange user information before retrying the direct message.

Exchange User Info​

Nodes periodically broadcast their user information, including the public key needed for encrypted direct messages. If a node's information is missing or outdated, open its entry in the phone app and select Exchange User Info. Allow the exchange to complete; repeat from the other node if needed.

Meshtastic app node menu with Exchange User Info

Retry the direct message and check its delivery status. A message appearing in the sender's conversation alone does not confirm receipt.

Regenerate Private Key​

If direct messaging still fails after refreshing the node information, you can regenerate the affected node's key pair from the phone app's Security settings. Use Regenerate Private Key, save the change, and restart the device as prompted.

Meshtastic phone app Security settings for regenerating the private key
After regenerating keys

The node's public key changes, so other nodes must learn its new information. Remove the stale entry from the other node's list if necessary, then exchange user information again. Keep the private key confidential; only the public key is shared with other nodes. See Meshtastic Security configuration.

Signal Quality​

  • SNR (signal-to-noise ratio) measures how strong the received signal is relative to background noise. A higher value generally indicates a clearer link. LoRa can receive signals with a negative SNR; the usable limit depends on the modem preset.
  • RSSI (received signal strength indicator) measures received signal power in dBm. A less negative value means a stronger signal: for example, −90 dBm is stronger than −110 dBm.

Check both values together with actual message delivery. A single SNR or RSSI reading does not establish that a device is faulty. To improve the link, use an antenna matched to the operating band, check its connection, and move to a higher, open location away from obstructions and interference.

The Computer Cannot Find X2 or Connect to Its Serial Port​

  1. Use a USB data cable and check the computer's port list before and after connecting X2. A charging screen alone does not confirm a USB data connection.
  2. Recheck the port after reconnecting X2, changing USB sockets, or entering download mode. On macOS, the /dev/cu.usbmodem... suffix can change.
  3. Close other flashers, serial monitors, or browser connections using the port. On Linux, also check USB access permissions.
  4. If the device is absent from the port list, try another data cable or connect directly to the computer to check the USB connection.
  5. For firmware installation, enter flashing mode as described in Flash Firmware. For the Web Client, run Meshtastic normally.

If a flasher reports No serial data received, it has not established communication with the bootloader. The message alone does not identify a Flash capacity problem or a defective device.

Linux USB Access​

Compare the serial ports before and after connecting X2:

ls /dev/ttyACM* /dev/ttyUSB* 2>/dev/null

If access is denied, check the detected port's permissions (replace /dev/ttyACM0 as needed):

ls -l /dev/ttyACM0

On Ubuntu/Debian, if the port belongs to dialout, add your user to that group:

sudo usermod -aG dialout "$USER"

Log out and back in, then retry. Close other applications using the port. Recheck the port name after entering download mode.

GNSS Does Not Show a Position​

  • Enable GNSS using Configure GPS.
  • Move outdoors with a clear view of the sky and allow time to acquire a fix. A first fix after a long period of inactivity can take longer than a subsequent fix.
  • Check the satellite and location status on X2 before expecting its position to appear on the map.
  • If the position stays fixed while you move, check the phone app's Fixed Position setting and the GNSS update interval. See Meshtastic Position configuration.

The Offline Map Is Blank​

  1. Check the card's MBR/FAT32 format and the /maps/<style>/<zoom>/<x>/<y>.png folder structure.
  2. Select the same style in MUI as the style copied to the card.
  3. Check that the downloaded tiles cover the location and zoom level being viewed. With only the official starter kit installed, zoom out to level 6 or lower.
  4. For your current location, wait for a GNSS fix. If the card is not detected, shut down X2 and disconnect USB before reseating it.

See Map Usage for preparation steps.

Manual Firmware Installation​

Use esptool to flash the X2 .factory.bin at 0x0. This combined image contains the bootloader, partition table, and application. An application-only .bin is not suitable for this procedure.

Full erase

The flashing command below erases all internal flash, including settings, channels, and saved data. Back up anything you need before continuing.

  1. Download the X2 factory firmware 2.8.1.0046b50. Rename the downloaded file from firmware-seeed_meshpager_x2-2.8.1.0046b50.factory copy.bin to x2.factory.bin and place it in a folder on your computer.
  2. Install Python 3.10 or later.
  3. Connect X2 to the computer using a USB data cable. Close the Web Flasher, Web Client, and any serial monitors that may hold the port.
  4. Open a terminal in the folder containing x2.factory.bin and follow the commands for your system. Send the 1200 bps reset first, then use esptool with --before usb-reset.

The 1200 bps step triggers a reset; esptool performs the firmware write. 1200 bps is not the firmware transfer speed. The USB port may disappear and reappear with a different name after reset, so list the ports again before flashing.

In PowerShell, install esptool and list the serial ports:

py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade "esptool>=5,<6"
.\.venv\Scripts\python.exe -m serial.tools.list_ports

Replace COM5 with X2's current port and send the 1200 bps reset:

.\.venv\Scripts\python.exe -c "import serial,time; s=serial.Serial('COM5',1200,timeout=0.2); s.dtr=True; time.sleep(0.5); s.dtr=False; s.close(); time.sleep(2)"
.\.venv\Scripts\python.exe -m serial.tools.list_ports

Check the port again. Replace COM5 below with the port X2 now uses, then flash:

.\.venv\Scripts\python.exe -m esptool --chip esp32s3 --port COM5 --baud 460800 --before usb-reset write-flash --erase-all 0x0 x2.factory.bin

Keep USB connected until esptool reports Hash of data verified and finishes. Restart X2 with both Power and Return released, then configure the LoRa region and channels again.

If esptool reports No serial data received, check for another application holding the port, repeat the 1200 bps reset, and select the newly enumerated port. Lowering the transfer speed alone does not put X2 into download mode.

If the software reset is unavailable, use the X2 button procedure described in Flash Firmware, then recheck the port. The required reset behavior can depend on the installed firmware and hardware revision.

If a connection is established but writing repeatedly fails, retry the write command with --baud 115200.

Tech Support & Product Discussion​

Join the Seeed Studio Meshtastic community on Facebook

Loading Comments...