Developer
Ask a QuestionBlecon WebsiteBlecon Console
  • Learn Blecon
    • Introduction
    • Blecon Modems
      • Device Identity and Network Security
      • Modem Firmware vs Modem Library
      • Using the Modem
      • Communicating with the cloud
      • Sending data from the cloud to a device
    • Blecon Hotspots
    • Blecon Networks
      • Blecon Accounts
      • Registering devices
        • The Blecon Scanner
        • Blecon Scanner Developer Guide
      • Blecon Events
      • Cloud Integrations
  • Cloud Integrations
    • Webhook
    • AWS S3
    • AWS SQS
    • AWS EventBridge
    • Memfault
  • Getting Started Guides
    • Getting started index
    • Install the Blecon Modem Firmware
    • Set up a Blecon Hotspot
    • Use Blecon from your computer with the Blecon CLI
    • Create a Network and register a device
    • Send device requests and events to your web service
    • Use Blecon from a Development Board
    • Use the Blecon Modem from an MCU
  • Device Guides
    • KKM S5-BCN
  • Development Board Guides
    • Supported Development Boards
    • Ezurio DVK-BL54L15
    • Fanstel EV-BM15C
    • InsightSiP ISP2454-LX-EB
    • Nordic nRF52840DK
    • Nordic nRF54L15DK
    • Minew ME54BE01
    • Panasonic PAN-B511 EVB
    • Raytac AN54L15Q-DB
    • u-Blox EVK-NORA-B20
  • Modem Reference
    • Modem Firmware Releases
      • nRF54L15 DK
      • nRF52840 Dongle
      • nRF52840 DK
    • CLI Releases
    • SDK Releases
    • Modem API Reference
    • Modem Protocol Reference
      • Request Frames
      • Command Protocol
      • UART Transport
    • Guides and best practices
      • Retrieve a device's identity
  • Cloud Reference
    • Configuration API
    • Advanced event routing
  • Hotspot Reference
    • Blecon Hub
Powered by GitBook

Get Support

  • Ask a question
On this page
  • Set up a Blecon Modem
  • Download and run the CLI tool
  • Use the CLI tool to get your modem's ID
  • Next Steps
  1. Getting Started Guides

Use Blecon from your computer with the Blecon CLI

Communicating from your PC to the Blecon Modem

PreviousSet up a Blecon HotspotNextCreate a Network and register a device

Last updated 2 months ago

Although Blecon is usually used with embedded devices, you can use Blecon's functionality from your computer by connecting a Blecon Modem and controlling it with the Blecon CLI.

The Blecon CLI tool is a command-line tool for interacting with the Blecon network and attached modems from your Linux, Mac or Windows computer. With the CLI you can get information about attached Blecon modems as well as send and receive messages from the Blecon network.

By giving access to the full functionality of the Blecon modem, the Blecon CLI turns your computer into a Blecon device. This can be helpful for prototyping software that uses the Blecon modem or testing the web endpoints that will handle messages from your devices.

Set up a Blecon Modem

Your computer will need to communicate through a Blecon Modem to use Blecon. Refer to the to flash the Blecon Modem firmware on a supported development board.

Download and run the CLI tool

Downloads

Instructions

  1. Download and extract the application for your platform. Note where you extracted the blecon-cli.exe application file.

  2. Launch a command prompt. Press the Windows key + R, type "cmd", and press Enter. This will open a Command Prompt window.

  3. Use the cd command to navigate to the directory where you saved the blecon-cli.exe application file

  4. Type .\blecon-cli.exe to run the tool and see a list of supported commands

  5. (Optional) Copy or move blecon-cli.exe to a more convenient location on your machine.

Downloads

Instructions

  1. Download and extract the application for your platform. Note where you extracted the blecon-cli application file.

  2. Start the Terminal application. This can be found in the Applications > Utilities folder.

  3. Use the cd command to navigate to the directory where you saved the blecon-cli application file

  4. Type ./blecon-cli to run the tool and see a list of supported commands

  5. (Optional) Copy or move blecon-cli to a more convenient location on your machine.

Downloads

Instructions

  1. Download and extract the application for your platform. Note where you extracted the blecon-cli application file.

  2. Start a terminal application.

  3. Use the cd command to navigate to the directory where you saved the blecon-cli application file

  4. Type ./blecon-cli to run the tool and see a list of supported commands

  5. (Optional) Copy or move blecon-cli to a more convenient location on your machine.

Use the CLI tool to get your modem's ID

Run the CLI tool with the get-identity subcommand to print out your modem's ID. Your modem ID gives your computer a unique identity on the Blecon network.

You will see output that looks like the following (output from Linux)

$ ./blecon-cli get-identity
Device Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

You now have a fully-working Blecon CLI and modem on your computer!

Next Steps

For this step to succeed you will need to have to your computer

to allow your modem to connect to the cloud.

to your Blecon virtual network so that messages from this modem are routed to your web endpoints.

Install Blecon Modem Firmware getting started guide
Windows x64
macOS x86_64
macOS ARM64
Linux aarch64
Linux x86_64
set up and connected a Blecon Modem
Set up a Blecon hotspot
Register your modem