Short introduction: OOWOW getting started

• Install / reinstall OS
• Download online OS images
• Backup and restore system
• Display full device information
• Configure device
• Device hardware testing
• Online script collection
• Rescue shell
• Developer and advanced features

Supported devices: OOWOW Devices

You can use the three hardware-buttons on your device to interact directly with the oowow system, we will describe them in more detail within the next section.

• RESET - reset device
• FUNCTION - multi functions
• POWER - multi functions

• Boot OOWOW - hold FUNCTION and short press RESET then release FUNCTION
• Toggle Easy Wi-Fi - short press POWER button
• Toggle Hotspot - short press FUNCTION button
• Accept Hotspot client - short press POWER button
• Power off - Long press the POWER button until device shuts down
• Enter multifunction mode - press and hold FUNCTION button (loop cycle: Hotspot → Firewall Allow → Firewall Block → Cancel, each mode wait 2 sec ), release to activate selected function

• Eject your micro SD-card before booting OOWOW (micro SD-card has highest priority)
• Boot OOWOW from sleep: hold FUNCTION button + short press RESET button + release FUNCTION button
• Boot OOWOW with power cable: hold FUNCTION button + plug power cable

Most system events have corresponding LED indications:

Multifunctional modes:

OOWOW provides a universal user interface (terminal mode menu + top status line) for HDMI, WEB, SSH, Serial-UART, etc (all interfaces work simultaneously)

• Keys: 0-9 A-Z ⇦ ⇨ ⇧ ⇩ Space Enter Esc Tab
• Mouse (for Web Interface only): select menu items and press buttons

A HDMI screen and keyboard is the primary interface modality.

Examples:

• http://DEVICE_IP or http://DEVICE_HOST_NAME - device page
• http://vim4-xxxxx.local/x/ - welcome page
• http://vim4-xxxxx.local/x/control - main menu

• Keys: 0-9 A-Z Space Enter
• Touchscreen: select menu items and press buttons
• Some virtual keyboard have additional keys: ⇦ ⇨ ⇧ ⇩ Esc Tab

• root access works by default without password
• ssh root@vim4-xxxxx.local - plain shell
• ssh root@vim4-xxxxx.local system - main menu

For developers and advanced users.

• Check how-to Setup Serial Tool
• Root access works by default without password
• Type system to enter to main menu, or use other shell commands

For developers and advanced users

curl -L 172.22.1.1/api/disk/rdz/mmc.zst -OJ

curl -L OOWOW_HOST_NAME_OR_IP/api/disk/rdz/mmc.zst -OJ

Write to eMMC

curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - IMAGE

Write to SD

curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - IMAGE -sd

Write or update SPI-flash firmware by LAN

curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - XXX-oowow-latest-spi.img.gz -spi

Write or update SPI-flash firmware by USB-otg network

curl 172.22.1.1/shell/write | sh -s - XXX-oowow-latest-spi.img.gz -spi

1. Navigate to the backup menu: OOWOW main menu ⇒ Dump image from eMMC
2. Select the backup location:
   • on OOWOW disk itself: location > ../ > dumps > okay
   • on USB disk: location > ../ > USB-sdXX…. > okay
   • if OOWOW was booted from special oowow disk backup location will selected automaticly
3. Start backup: Start, and wait for few minutes to finish the backup and exit.

1. Navigate to the restore menu: OOWOW main menu ⇒ Write image to eMMC
2. Select the backup image location:
   • on OOWOW disk itself: vimx-xxxxxx.xxxxxx-…..img.zst > okay
   • on USB disk: ../ > USB-sdb1…. > vimx-xxxxxx.xxxxxx-…..img.zst > okay
   • if OOWOW was booted from special oowow disk backup location will selected automaticly
3. Restore the image: Write, and wait for few minutes to write the image and exit.

Network connection is required for:

• OS downloading and installation
• OOWOW system updates
• Dynamic syncing of online scripts
• Remote control over LAN and WLAN

Every OOWOW device can be accessed remotely via its unique LAN name.

device-xxxxx:

• device: lowercase device name, e.g. VIM4 → vim4
• xxxxx: last 5 digits of the device serial number

Network name examples:

• vim4-00010
• vim4-00012
• vim3-12333

Depends on your LAN configuration, for example:

• vim4-00010 - dns resolver
• vim4-00010.local - umdns resolving - canonical variant for OOWOW
• …

~$ ping vim4-05690
PING vim4-05690 (192.168.30.203) 56(84) bytes of data.
64 bytes from 192.168.30.203 (192.168.30.203): icmp_seq=1 ttl=64 time=37.3 ms
 
~$ ping -c1 vim4-05690.local
PING vim4-05690.local (192.168.30.203) 56(84) bytes of data.
64 bytes from 192.168.30.203 (192.168.30.203): icmp_seq=1 ttl=64 time=37.3 ms
 
~$ curl http://vim4-05690.local
~$ curl http://192.168.30.203
~$ curl 192.168.30.203
~$ ssh root@vim4-05690
~$ ssh root@vim4-05690.local

Ethernet works automatically; just plug in an ethernet cable from your router.

User can setup and configure a WLAN connection Network → Wi-Fi → Wi-Fi Select Connection.

In cases wherein you are unable to configure a WLAN or LAN connection locally on your device, you can share your internet connection from a mobile device (e.g. smartphone) to your single board computer using the Easy Wi-Fi mode.

You can enable the Easy Wi-Fi mode on your device in two ways:

• Toggle Easy Wi-Fi - short press POWER button
• Network ⇒ Wi-Fi ⇒ Easy Wi-Fi oowow ⇒ Enable / Disable

Setup a new hotspot from your mobile device with the following configuration:

• SSID: oowow
• Password: 12345678

Once OOWOW is in the Easy Wi-Fi mode, it will automatically scan and connect to your Wi-Fi hotspot generated by your mobile device.

You can enable the OOWOW hot-spot feature in two ways:

• Toggle hotspot - short press FUNCTION button
• Network ⇒ Hotspot ⇒ Hotspot Enable / Disable

The OOWOW hot-spot will have the following configuration:

• SSID: vim4-xxxxx ( xxxxx - last 5 digits from device serial number )
• Password: 12345678

These host names can be used for device access via the hotspot:

• http://172.23.0.1
• http://oowow or http://oowow.local - works only for hotspot network
• http://vim4-xxxxx or http://vim4-xxxxx.local

Network → Hotspot → Hotspot QR code.

• Network ⇒ Hotspot ⇒ Device Web Access QR code
• Network ⇒ Wi-Fi ⇒ Device Web Access QR code

Connect your device directly to your computer using a USB cable. This feature will interest developers or advanced users; there is only a peer-to-peer network connection, no internet packets will be forwarded to your device.

Network → Firewall Mode:

• block - Block all incoming connections SECURE
• allow - Allow incoming connections from local networks RECOMMENDED
• disabled - Allow all connections, firewall disabled DANGER

Check here.

Check here.

Check here.

Check here.

Internet access provided by LAN ethernet cable, user device access provided by WLAN hotspot.

Internet access provided by WLAN wifi-connection and user device access provided by WLAN hotspot same time.

Main menu ⇒ Device configure KBI

KBI is an abbreviation for Khadas Bootloader Instructions, which is developed to fulfill the following purposes:

• Manage the programmable MCU
• Carry out low level hardware management
• Let developers utilize all the features of SBC device

Reset MCU/KBI configuration to default values

Setup device boot-mode values:

• emmc - boot up device from eMMC default
• spi - boot up device from SPI-flash

• OOWOW works only by user demand, and never works in the background
• OOWOW never sends any private data from your device to the internet
• By default, remote access to your device is blocked by the firewall

• Unicode international symbols don’t display properly for HDMI (Wi-Fi network names)
• IPV6 disabled at this time

• Automatically looks for updates when internet is connected, user will be notified if new updates need to be applied
• System updates must be manually approved by the user
• Don't turn off computer - during update

• OOWOW main download page
• Latest OOWOW system/firmware images
• Full OOWOW versions images

• BOARD-oowow-latest-sd.img.gz - latest oowow image for SD-card or USB-thumb drive
• BOARD-oowow-latest-spi.img.gz - latest oowow image for SPI-flash
• BOARD-oowow-latest-spi-upgrade-sd.img.gz - upgrade oowow SPI-flash firmware from SD-card

• BOARD-oowow-latest-sd.img.gz → versions/BOARD/BOARD-oowow-VERSION-sd.img.gz

Download images command line examples:

• curl -JOL https://dl.khadas.com/products/oowow/system/vim4-oowow-latest-sd.img.gz
• wget –content-disposition https://dl.khadas.com/products/oowow/system/vim4-oowow-latest-sd.img.gz

• OOWOW Devices
• Why OOWOW?
• About OOWOW name