Skip to content

CumeBox 2

Hardware

Cumebox 2 (aka Bitmi Box, CumeBox2 — same hardware) features an Amlogic S905X, 1GB RAM, 8GB internal storage, one 100M Ethernet port, two USB 2.0 ports, one OTG 2.0 port, two SATA 3.0 ports, dual-band Wi-Fi and Bluetooth, with TF slot and HDMI output.

Integrated Image Deployment

The base image is adapted from Armbian Khadas-vim1 with DTB changes; Ethernet, OLED, Wi-Fi, and OTG all work.

Flashing steps

  1. Download Android TV 6.0 firmware (as an intermediate system)
  2. Short specific pads on the board as shown to enter flashing mode
  3. Use Amlogic USB Burning Tool to flash the Android TV firmware
  4. Install a specific APK in Android TV so the device can boot Armbian from a USB drive or TF card
  5. Reboot into Armbian prepared on external media
  6. Finally, write the integrated image to eMMC via dd

Short pads

Detailed guide: CumeBox2 Armbian install (ruohai.wang)

Upgrade

Write the latest dd image to a USB drive, plug it in, and boot to the USB system. To flash to eMMC, use dd to write the image to eMMC.

Docker Deployment

Install Docker

  • Using distro packages:
    apt install apparmor-utils docker.io -y
    
  • Or the latest:
    curl -fsSL https://get.docker.com | bash
    

Run One-KVM in Docker

# Use OTG HID
# /dev/video0 exists in the system; new USB capture cards start from /dev/video1
docker run --name kvmd -itd --privileged=true \
    -v /dev:/dev -v /sys/kernel/config:/sys/kernel/config \
    -v /lib/modules:/lib/modules:ro \
    -e OTG=1 -e VIDEONUM=1 \
    -p 8080:8080 -p 4430:4430 -p 5900:5900 -p 623:623 \
    silentwind0/kvmd

# After confirming it runs, enable auto-restart
docker logs kvmd
docker update --restart=always kvmd

image-20240926220902937

Usage

Hardware safety warning

To avoid issues such as the target failing to boot or detect devices (and in rare cases hardware damage), take one of these precautions before using a USB cable:

Option 1: cut/remove the red 5V (VCC) wire in the USB cable so only the data lines (D+/D−) and ground remain, breaking the power path.

Option 2: insert a USB hub with its own power switch into the USB link and keep that switch off while connecting.

Some low-power targets can back-power from the KVM via the OTG port before their main power is applied, leaving them in a bad state that persists even after you power them normally.

Unless you fully understand the risks, use one of the safeguards above to protect your hardware.

Data safety reminder

Avoid hard power-offs. Cutting power while eMMC writes are in progress can corrupt data.

If you must cut power, run sync after write operations. For shutdowns/reboots, prefer poweroff or reboot so the system flushes data cleanly.

SSH

Armbian enables SSH by default. Initial credentials: root/1234.

System upgrade warning

Do not run apt upgrade to upgrade the kernel/DTB. It may break OTG.

Connections

image-20240926220219805

OLED

The front-panel OLED cycles through a welcome message, temperature, and IP address.

oled

Wi-Fi

  • Install packages

    apt install network-manager -y
    
  • Connect to Wi-Fi

    1
    2
    3
    # Use the TUI to connect (dual-band supported)
    # After first-time setup, the box will auto-connect on reboot
    nmtui
    

image-20240926220204960

ATX power control

Cumebox 2 can use a USB HID relay for physical power control.

img