CuBox-M Quick Start Guide

Revision and Notes


The following quick start guide provides background information about the CuBox-M.

The guide will give a technical overview about the product and by the end of it you should be able to boot an operating system and begin testing your application.

Hardware Setup

Product Specifications






2 x USB 3.0


1 x Ethernet RJ45 10/100/1000
1 x 802.11 a/b/g/n/ac WiFi and Bluetooth (Optional)


NXP i.MX8M Plus Quad core Arm Cortex A53 up to 1.8GHz (with Arm M7 GPP)

Memory & Storage

Up to 3GB LPDDR4




GPIO button
Indication LEDs
IR receiver

Development and Debug interfaces

Micro USB


Optional PoE

Expansion card I/Os



Commercial: 0°C to 40°C


50 x 50 x 50mm


ABS Plastic



Supported with i.MX8M-PLUS SOM. For more detailed information about our SOM-i.MX8M series please visit this user manual : .

Block Diagram

The following figure describes the i.MX8M-PLUS Block Diagram.


Visual Features Overview


Software Setup

Cable setup and prerequisites

  • Micro USB cable

  • Power supplier : regulated 12V supply with 1.5A source capacity, alternatively you can use a PoE injector to power on the device.

  • Micro SD card

  • Linux or Windows PC

  • Router or switch with Ethernet cable

Note that using an adaptor with an output voltage which is higher than 12V will damage your device and possibly other connected USB devices.

Booting form an SD card

1. Downloading the Debian image

Download the Debian image by running the following command on your Linux/Windows PC:


2. Writing the image to the SD card

Use the following commands for writing the image to an SD card:

xz -dc sr-imx8-debian-bullseye-20230623-cli-imx8mp-sdhc.img.xz | dd of=/dev/sdX bs=4k conv=fdatasync

Note: Plug a micro SD into your Linux PC, the following assumes that the micro SD is added as /dev/sdX and all it’s partitions are unmounted.

3. SD card insertion

Please Insert the SD card into your device.

4. Power connection

Connect your power adaptor to the DC jack, and then connect the adaptor to mains supply.

5. Serial Connection

Please insert the micro USB into your device, then you can refer to Serial Connection for installing necessary serial connection software in Linux/Windows.

Once you installed the necessary serial connection software, you should be able to see the following:

  • In order to be able to log in , please insert “debian” as a username and password as follows:

More Features


Connect an Ethernet cable to your CuBox-M (for internet access during boot-up).
Models CuBox-M with WiFi, can be connected via WiFi or wired Ethernet.

  • Please check you Ethernet connection.

  • Use the following commands in order to keep your system up-to-date:

apt-get update apt-get upgrade reboot

An example for connecting to WiFi using wpa_supplicant:

  1. To bring a WiFi interface up, run the following :

2. Install the wpa_supplicant package:

3. Edit network interfaces file :

At the bottom of the file, add the following lines to allow wlan as a network connection:

4. Create a configuration file with the relevant ssid:

5. Make sure it works:

Restart your device and it should connect to the wireless network. If it doesn't, repeat above steps or get help from an adult.


1. For showing all Bluetooth devices, run the following:

2. Choose a device, and turn it on:

3. Set up the Bluetooth name:

4. Make your Bluetooth detectable by other devices:

5. If you want to connect to other devices:

  • Start by scanning for other Bluetooth devices:

  • Choose a MAC address and connect :

  • You can check the communication between the devices by writing :


Starting from April 01. 2022, the EEPROMs on Carriers, i.MX8M Plus SoMs are being programmed with identifying information such as the product name and SKUs to allow for programmatic identification of hardware. Check our iMXMP EEPROM documentation for additional information.

List Of Supported OS


Build from source


  File Modified

ZIP Archive

Mar 13, 2024 by Yazan Shhady