Table of Contents

OOWOW User Manual

Short introduction: OOWOW getting started

Main Features

Hardware

Supported devices: OOWOW Devices

Hardware Buttons

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.

Common Button Shortcuts

All shortcut events will be displayed on OOWOW status bar and indicated by LEDs.

Tips to Boot OOWOW

LED Indication Table

Most system events have corresponding LED indications:

Events Indications
Device starts or reboots White solid
Device power off Red solid
System start in default mode White heartbeat
Network connected White solid
HotSpot mode activated White fast blinking
HotSpot mode ready White solid
HotSpot client pending White and red blinking
HotSpot client accepted White slow blinking
HotSpot mode deactivated White heartbeat
Easy Wi-Fi activated White blinking
Easy Wi-Fi awaits connection White slow blinking
Easy Wi-Fi deactivated White heartbeat
Firewall block incoming Red breathing
Firewall allow incoming White solid, red off
Firewall disabled Red blinking
Image installation progress Red & white blinking
Image installation done White solid, red off

Multifunctional modes:

Events Indications
Hotspot White off
Firewall block incoming White solid, red off
Firewall allow incoming White & red solid
Cancel White blinking

Interfaces

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

HDMI + Keyboard

A HDMI screen and keyboard is the primary interface modality.

Web Access

Examples:

Access can be restricted by the firewall

Mobile Navigation

SSH Access

Access can be restricted by the Firewall.

Serial UART Access

For developers and advanced users.

WEB API

For developers and advanced users WIP:

Access can be restricted by the firewall

Dump eMMC by usb network

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

Dump eMMC by LAN network

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

Write Image to eMMC by LAN network

Write to eMMC 
curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - IMAGE

Write Image to SD by LAN network

Write to SD
curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - IMAGE -sd

Write SPI oowow image by LAN network

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 SPI oowow image by USB-otg network

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

Backup

Store backup

  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.

Restore backup

  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.

Networks

Network connection is required for:

Device Network Name

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

device-xxxxx:

Network name examples:

Network Name Resolution

Depends on your LAN configuration, for example:

  • Use device ip address if name resolution doesn't work.
  • OOWOW uses the DHCP hostname.
  • OOWOW uses the MDNS hostname announcement.

Network Name Usage Examples

~$ 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 LAN

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

Wireless LAN

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

  • Wi-Fi configurations are automatically saved and will persist after rebooting.
  • All system configurations will be saved only after a planned shutdown. Check animation.

Easy Wi-Fi

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:

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

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.

Hotspot

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

The OOWOW hot-spot will have the following configuration:

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

Tip: For security reasons, you need to manually accept incoming hotspot connections by short pressing the POWER button once.

Hotspot QR code

Network → Hotspot → Hotspot QR code.

Web access QR code

USB-OTG Network

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.

Firewall

Network → Firewall Mode:

  • By default, remote access is blocked by the firewall
  • Easily configure the firewall with the hardware button shortcuts
  • ICMP pings are always allowed, irrespective of firewall mode
  • Hotspot mode allows incoming connections only after pressing the POWER button (device access: 172.23.0.1 or http://172.23.0.1)
  • USB-OTG connection is always allowed

Usage Examples

Configure Wi-Fi with Wizard

Check here.

Wi-Fi Connection

Check here.

Easy Wi-Fi Connection

Check here.

Hotspot Mode

Check here.

Hotspot Mode + Ethernet LAN

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

Hotspot Mode + Wi-Fi WLAN Connection

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

Ethernet

WIP:

Device configure KBI

Main menu ⇒ Device configure KBI

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

Reset MCU to factory mode

Reset MCU/KBI configuration to default values

This procedure totally safe, and never change eMMC storage content or any other parts.

Boot-mode

Setup device boot-mode values:

For use Android need setup boot-mode to emmc

WIP:

Security and Privacy

Limitations

Updates

Download OOWOW

Image Types

Filename for Latest OOWOW Version

Download the latest OOWOW SD images:

Download images command line examples:

More information