|1||USB-A||USB 2.0 speed, 500mA max output|
|2||RJ-45||10/100 Mbps Ethernet|
|3||HDMI||HDMI 2.0b with 3D, HDR, CEC and HDCP 2.2|
|4||USB-C||USB 2.0 OTG and 5V power input, can be used for upgrading the OS|
|5||USB-A||USB 2.0 speed, 900mA max output|
|6||Fan Header||4-wire fan header utilising pulse width modulation|
|7||Reset Button||Force reboot your VIM1 in the event of a system freeze|
|8||Function Button||Press this 3 times in 2 seconds to enter MaskROM mode|
|9||Power Button||This button turns on your VIM1|
|A||M2x4 Mounting Point||For mounting to cases and heatsinks|
|B||RTC Battery Header||Header for attaching a battery for the real time clock|
|C||40-Pin GPIO||Learn how to access the GPIO from here, or use it to add a Toneboard|
|D||Infrared Module||2-channel infrared receiver for use with Khadas IR remote|
|E||LEDs||Status indicator LEDs|
|F||I-Pex Wi-Fi / Bluetooth Connector||Wi-Fi / BT Antenna connector|
|1||VIN||5V power input|
|2||Micro-SD Card Slot||Boot alternative OSes via a Micro-SD card, and for extra storage|
|3||M-Register||Allows the EMMC to enter MaskROM mode|
|4||XPWR Pads||Connect an external power switch using these pads|
|x||Force Reboot VIM1|
|x||Enter Upgrade Mode (TST)|
|x||Power On/Wake Up VIM1|
|x||x||Enter Upgrade Mode (KEYS)|
|Blue||OFF||Power source disconnected|
|Solid ON||Power source connected, SBC turned off|
|White||OFF||SBC turned off|
|Solid ON||SBC turned on|
The above behaviours are default out-of-the-box, and can be altered by a user. For example the white LED can be made to blink or breathe. For more information on how to program them via your favourite OS (each OS is different), please consult with experts at forum.khadas.com.
Krescue is an extremely small (21mb) operating system that you can boot directly from a micro-SD card or your EMMC. It is a “Swiss Army knife”, and you can use it to perform a variety of low-level SBC maintenance tasks. Most notable of which are backing-up your EMMC by dumping a raw-compressed .img.gz, and rapidly installing a new OS via flashing a .img.gz back into the EMMC. As of January 2020, Krescue can download and install OS images directly from the web via wired Ethernet.
- Backup EMMC memory contents to an SD card, USB, LAN host.
- Restore .img.gz into an EMMC on another device.
- Online OS installation via Ethernet.
- View device information.
- Rescue shell for expert users.
- Shell access via UART, USB network, and LAN network.
Steps to Boot Krescue:
- Download an appropriate image for VIM1 from dl.khadas.com
- Burn this image to a micro-SD card, using Rufus, dd (Linux) or Etcher.
- Plug in the micro-SD card, USB-C power, and HDMI into your VIM1 device.
- Boot your VIM1 device into MaskROM mode (please read!!!).
- Use an IR remote control or USB keyboard to navigate the UI menus.
Online Installation via Shell Command:
- curl -sfL dl.khadas.com/.mega | sh -s - –help
- wget -O- dl.khadas.com/.mega | sh -s - –help
Write Krescue directly to EMMC via the web:
- curl -sfL dl.khadas.com/.mega | sh -s - VIM1 > /dev/mmcblk?
- curl -sfL dl.khadas.com/.mega | sh -s - VIM2 > /dev/mmcblk?
- curl -sfL dl.khadas.com/.mega | sh -s - VIM3 > /dev/mmcblk?
- curl -sfL dl.khadas.com/.mega | sh -s - VIM3L > /dev/mmcblk?
More shell commands and examples:
- YouTube - Krescue Introduction
- YouTube - Krescue Online OS Installation
- Khadas Forum - Krescue Help & Discussion
Although your VIM1 SBC is compatible with various types of power supplies, these are the recommended specs for the best performance-output and stability.
- 5V, 2000mA Power Adapter
- USB-A to USB-C Cable
- Khadas Shop - Power Adapter
- Khadas Shop - USB-C Cable
- Extra Power Input For Khadas VIMs
- Khadas VIM Specifications
These items are useful when you need to connect your VIM1 SBC to an external display + keyboard mouse + remote control, for use as a desktop computer or media center.
- 4K HDMI 2.0 Cable
- HDMI-Compatible 1080P/4K Monitor
- Wireless USB Keyboard + Mouse
- CeC-Compatible Remote Control
Note: Please do not attach multiple cables with large heads that interfere with each other, as that may bend or twist the connectors, and this will cause intermittent connectivity issues after some time.
These items are useful when you want to upgrade your VIM1 SBC’s operating system via SD-Card or Thumbdrive (Burning Cards). Or if you want to run operating systems that can only be run from external media (Booting Cards) like LibreELEC.
- 8GB or Larger, SD-Card
- SD-Card Reader
- Laptop / Desktop PC
- 8GB or Larger, USB-Thumbdrive (U-Disk)
- eMMC image should be burned directly to the eMMC using a USB-C data cable, from a Ubuntu or Windows Host. It must not be burned into an SD-Card. For Example: Android and Ubuntu distributions containing the
- SD/USB image should be copied into an SD-Card, before that card is then used to reformat the eMMC storage with a new OS. For Example: Armbian, Ubuntu distributions containing the
SD_USBmark, as well as LibreELEC and CoreELEC.
- In order to bootup from SD/USB images, you need Android (V180209 or newer) or Ubuntu (V180531 or newer) running on your eMMC with Multi-Boot activated.
You’ll need these items if you want to use your laptop or desktop PC to upgrade your VIM1 SBC’s operating system stored in its eMMC storage. For example, changing the bootup operating system from Android to Ubuntu, or installing a more exotic 3rd-party OS.
- USB-A to USB-C Data Cable (Legacy Computers)
- USB-C to USB-C Data Cable (Modern Computers)
- Laptop / Desktop PC
Extreme cases of crash-recovery will require you to use the MRegister to reset your VIM1 SBC. A USB Serial Debug Tool is also useful for developers debugging complex software issues.
- Conductive Metal Tweezers (For resetting a dead SBC via MRegister)
- USB Serial Debug Tool (For diagnosing software/hardware issues)
For more information, please see our website, read more documentation, or visit our forum.