VIM2 Beginners Guide

VIM2

image

Front (Blue)

Component Purpose
1 USB-A USB 2.0 speed, 500mA max output
2 RJ-45 Gigabit Ethernet with Wake-On-LAN (WOL)
3 HDMI HDMI 2.0a with CEC, 4K@60Hz
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 Current Limit Switch Prevents damage to VIM2 during uneven loading conditions
7 Fan Header 4-wire fan header utilising pulse width modulation
8 Reset Button Force reboot your VIM2 in the event of a system freeze
9 Function Button Press this 3 times in 2 seconds to enter MaskROM mode
A Power Button This button turns on your VIM2
B M2x4 Mounting Point For mounting to cases and heatsinks
C RTC Battery Header Header for attaching a battery for the real time clock
D 40-Pin GPIO Learn how to access the GPIO from here, or use it to add a Toneboard
E Infrared Module 2-channel infrared receiver for use with Khadas IR remote
F LEDs Status indicator LEDs
G FPC Connector 10-pins, 0.5mm pitch, with I2C, IOs
H I-Pex Wi-Fi / Bluetooth Connector Wi-Fi / BT Antenna connector
I I-Pex Wi-Fi / Bluetooth Connector Wi-Fi / BT Antenna connector

Back (Red)

Component Purpose
1 Pogo Pads External 5V power input, can be provided by vTV Board (DVB Tuner)
2 Micro-SD Card Slot Boot alternative OSes via a micro-SD card, or just for extra storage
3 500mA Fuse Fuse for the 500mA USB port
4 WOL Switch Power switch activated via Wake-On-LAN
5 MCU STM8S003 micro-controller with programmable EEPROM
6 MCU Pogo Pads SWIM, UART, ADC, NRST
7 SPI Flash Flash memory module that interfaces over SPI
8 20-Pin Pogo Pads USB, I2C, DVB-Bus, IOs, for docking with the vTV Board (DVB Tuner)
9 XPWR Pads Connect an external power switch using these pads
A 900mA Fuse Fuse for the 900mA USB port

Buttons

Reset Function Power Purpose
x Force Reboot VIM2
x Enter Upgrade Mode (TST)
x Power On/Wake Up VIM2
x x Enter Upgrade Mode (KEYS)
x x x Erase EMMC

Indicator LEDs

Colour Behaviour Meaning
Blue OFF Power source disconnected
Solid ON Power source connected, SBC turned off
White OFF SBC turned off
Solid ON SBC turned on
Red None None

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 (Khadas-Rescue-OS)

image

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.

Main Features:

  • 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:

  1. Download an appropriate image for VIM2 from dl.khadas.com
  2. Burn this image to a micro-SD card, using Rufus, dd (Linux) or Etcher.
  3. Plug in the micro-SD card, USB-C power, and HDMI into your VIM2 device.
  4. Boot your VIM2 device into MaskROM mode (please read!!!).
  5. Use an IR remote control or USB keyboard to navigate the UI menus.

Online Installation via Shell Command:

Online Help:

  • 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:

Learn More:

VIM2 v1.4 What’s New?

Khadas has recently upgraded their VIM2 to v1.4 which features several improvements, such as the addition of XPWR pads for an external power switch, as well as a larger 16MB SPI-flash.

It also has had several components moved / upgraded to accomodate a quieter cooling system:

It is backwards-compatible with the DIY Case, vTV Board and Khadas Tone Board, and supports several new ROMs such as Ubuntu 18.04 and Google Fuchsia.

Learn More:

VIM2 Power Supply

Although your VIM2 SBC is compatible with various types of power supplies, these are the recommended specs for the best performance-output and stability.

  1. 5V, 2000mA Power Adapter
  2. USB-A to USB-C Cable

Learn More:

Displays & User Input

These items are useful when you need to connect your VIM2 SBC to an external display + keyboard mouse + remote control, for use as a desktop computer or media center.

  1. 4K HDMI 2.0 Cable
  2. HDMI-Compatible 1080P/4K Monitor
  3. Wireless USB Keyboard + Mouse
  4. 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.

Learn More:

Making Bootable/Burning SD-Cards/Thumbdrives

These items are useful when you want to upgrade your VIM2 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.

  1. 8GB or Larger, SD-Card
  2. SD-Card Reader
  3. Laptop / Desktop PC
  4. 8GB or Larger, USB-Thumbdrive (U-Disk)

Learn More:

Tips:

  • 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 EMMC mark.
  • 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_USB mark, 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.

Upgrading eMMC Operating System Using USB-C Cable

You’ll need these items if you want to use your laptop or desktop PC to upgrade your VIM2 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.

  1. USB-A to USB-C Data Cable (Legacy Computers)
  2. USB-C to USB-C Data Cable (Modern Computers)
  3. Laptop / Desktop PC

Learn More:

Firmware Images:

Watching Movies, Expanding Internal eMMC Storage

These items are useful if you wish to use your VIM2 SBC as a media center, for storing/downloading large movie files. A microSDXC UHS-I card is expensive, but its also fast enough for 4K video playback. In addition, you can connect external USB-2.0/3.0 SSDs or HDDs for storage that can encompass your entire media library.

  1. 64GB or larger, USB-2.0/3.0 HDD / SSD
  2. 64GB or larger, microSDXC UHS-I SD-Card

Learn More:

Tip: Nowadays most people stream their media, see How To Install LibreELEC.

Software Development / Advanced Crash Recovery

Extreme cases of crash-recovery will require you to use the MRegister to reset your VIM2 SBC. A USB Serial Debug Tool is also useful for developers debugging complex software issues.

  1. Your fingers (for resetting a dead SBC via Khadas-TST, VIM2 V14 only)
  2. Conductive Metal Tweezers (For resetting a dead SBC via MRegister)
  3. USB Serial Debug Tool (For diagnosing software/hardware issues)

Learn More:

VIM2 Website

For more information, please see our website, read more documentation, or visit our forum.

VIM2 Review Video