> For the complete documentation index, see [llms.txt](https://dev.solid-run.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.solid-run.com/nxp/imx8/sbc-platform/cubox-m-quick-start-guide.md).
# CuBox-M Quick Start Guide
## Revision and Notes
| **Date** | **Owner** | **Revision** | **Notes** |
| ----------- | --------- | ------------ | --------------- |
| 21 Oct 2021 | | 1.0 | Initial release |
## Introduction
The following quick start guide provides background information about the [CuBox-M](https://www.solid-run.com/fanless-computers/cubox/#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
| **Model** | **CuBox-M** |
| -------------------------------- | ------------------------------------------------------------------------------------------- |
| I/Os | 2 x USB 3.0 |
| Networking | 1 x Ethernet RJ45 10/100/1000
1 x 802.11 a/b/g/n/ac WiFi and Bluetooth (Optional)
|
| Processor | NXP i.MX8M Plus Quad core Arm Cortex A53 up to 1.8GHz (with Arm M7 GPP) |
| Memory & Storage | Up to 3GB LPDDR4
8GB eMMC
MicroSD
|
| Display | HDMI |
| Misc. | GPIO button
Indication LEDs
RTC
IR receiver
|
| Development and Debug interfaces | Micro USB |
| Power | 12V
Optional PoE
|
| Expansion card I/Os | None |
| Temperature | Commercial: 0°C to 40°C |
| Dimensions | 50 x 50 x 50mm |
| Enclosure | ABS Plastic |
| | [Buy Now](https://shop.solid-run.com/?s=CuBox+M\&post_type=product) |
{% hint style="info" %}
Supported with i.MX8M-PLUS SOM. For more detailed information about our SOM-i.MX8M series please visit this user manual : [i.MX8M Plus SOM Hardware User Manual](/nxp/imx8/com-som/imx8m-plus-som-hardware-user-manual.md) .
{% endhint %}
#### 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
{% hint style="warning" %}
Note that using an adaptor with an output voltage which is higher than 12V will damage your device and possibly other connected USB devices.
{% endhint %}
## Booting form an SD card
**1. Downloading the Debian image**
Download the Debian image by running the following command on your Linux/Windows PC:
```
wget https://solid-run-images.sos-de-fra-1.exo.io/IMX8/imx8mp_build/build_date_20240617-rev_87b97f9/imx8mp-sdhc-debian-87b97f9.img.xz
```
* For more Debian releases, please visit [Debian Release for i.MX8](https://github.com/SolidRun/Documentation/tree/bsp/imx8).
**2. Writing the image to the SD card**
Use the following commands for writing the image to an SD card:
```
xz -dc imx8mp-sdhc-debian-87b97f9.img.xz | dd of=/dev/sdX bs=4k conv=fdatasync
```
* For more information, please visit [Flashing an SD Card](/other-articles/flashing-an-sd-card.md) .
{% hint style="info" %}
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.
{% endhint %}
**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](/other-articles/serial-connection.md) 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
#### Internet
Connect an Ethernet cable to your CuBox-M (for internet access during boot-up).\
Models CuBox-M with WiFi, can be connected via [WiFi](#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
```
* For more detailed information, please refer to [i.MX8M Debian](https://developer.solid-run.com/knowledge-base/i-mx8m-debian/) .
**WiFi**
* You can connect to WiFi using any application, such as : [connmanctl](https://manpages.debian.org/testing/connman/connmanctl.1.en.html) or [wpa\_spplicant](https://wiki.archlinux.org/title/wpa_supplicant).
An example for connecting to WiFi using wpa\_supplicant:
1. To bring a WiFi interface up, run the following :
```
ifconfig wlan0 up
```
{% hint style="info" %}
To discover your wireless network interface name, see [Network Interfaces](https://wiki.archlinux.org/title/Network_configuration#network_interfaces).
{% endhint %}
2\. Install the wpa\_supplicant package:
```
apt-get install wpasupplicant
```
3\. Edit network interfaces file :
At the bottom of the file, add the following lines to allow wlan as a network connection:
```
cat < /etc/network/interfaces.d/wlan0
allow-hotplug wlan0
iface wlan0 inet dhcp
wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
iface default inet dhcp
EOF
```
4\. Create a configuration file with the relevant ssid:
```
cat < /etc/wpa_supplicant/wpa_supplicant.conf
ctrl_interface=/run/wpa_supplicant
update_config=1
network={
ssid="MYSSID"
psk="passphrase"
}
EOF
```
{% hint style="info" %}
Check your personal ssids by running : ‘iw dev wlan0 scan’
{% endhint %}
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.
* For more information about using wpa\_supplicant , you can refer to [wpa\_supplicant](https://www.linuxbabe.com/command-line/ubuntu-server-16-04-wifi-wpa-supplicant) or [wpa\_supplicant](https://blog.nelhage.com/2008/08/using-wpa_supplicant-on-debianubuntu/).
#### Bluetooth
1\. For showing all Bluetooth devices, run the following:
```
apt-get install bluez
hciconfig -a
```
2\. Choose a device, and turn it on:
```
hciconfig hci0 up
```
3\. Set up the Bluetooth name:
```
hciconfig hci0 name 'SolidRun_Ble'
```
4\. Make your Bluetooth detectable by other devices:
```
hciconfig hci0 piscan
```
5\. If you want to connect to other devices:
* Start by scanning for other Bluetooth devices:
```
hcitool scan
```
* Choose a MAC address and connect :
```
rfcomm connect 0 $MAC 10 &
```
* You can check the communication between the devices by writing :
```
l2ping -c 4 $MAC
```
## TLV EEPROM Support
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](/nxp/imx8/sbc-platform/imx8m-other-articles/imx8mp-eeprom-programming-tlv.md) for additional information.
## List Of Supported OS
| **OS** | |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
|  | [Documentation/debian-11\_sr8.md at bsp](https://github.com/SolidRun/documentation/blob/bsp/imx8/debian-11_sr8.md) |
|  | [GitHub - SolidRun/meta-solidrun-arm-imx8 at zeus-imx8mp](https://github.com/SolidRun/meta-solidrun-arm-imx8/tree/zeus-imx8mp) |
|  | [Cubox-M Android](/nxp/imx8/sbc-platform/imx8m-plus-mini-nano-software/cubox-m-android.md) |
|  | [GitHub - SolidRun/imx8mp\_build](https://github.com/SolidRun/imx8mp_build) |
## Build from source
* [i.MX8M Software](/nxp/imx8/sbc-platform/imx8m-plus-mini-nano-software.md)
## Documentation
{% file src="/files/kDwYLMHfg46LiMoa3IoU" %}
* Drag and drop to upload or \[browse for files]
Upload file
File description
{% file src="/files/kDwYLMHfg46LiMoa3IoU" %}
[Buy a Sample Now](https://shop.solid-run.com/?s=CuBox+M\&post_type=product)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://dev.solid-run.com/nxp/imx8/sbc-platform/cubox-m-quick-start-guide.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.