Skip to main content

Connecting to Your Device

Connecting to Your Device

The MeshCore CLI (meshcore-cli) supports three connection methods. Choose the one that matches your hardware and situation.

Serial (USB)

The most reliable method. Connect your device via USB and use the default baud rate:

meshcore-cli

The CLI auto-detects the serial port on most systems. If you have multiple serial devices:

meshcore-cli --port /dev/ttyUSB0   # Linux/macOS
meshcore-cli --port COM3            # Windows

Baud rate: 115200

Bluetooth (BLE)

Connect wirelessly to a nearby device. The device must have BLE enabled:

meshcore-cli --ble connect

If the device does not appear, ensure it is powered on and not already connected to the MeshCore app. Only one BLE client can connect at a time.

TCP (Wi-Fi / LAN)

Connect to a device that exposes a TCP interface (useful for remote administration of fixed nodes):

meshcore-cli --tcp 192.168.1.100:4403

Replace the IP and port with the device’s actual address. Port 4403 is the MeshCore default.

Verifying Connection

Once connected, run info to confirm the connection and see device details:

info

Expected output includes firmware version, battery level, node name, and radio configuration.