Khadas Docs

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~tag>OOWOW howto~~
====== OOWOW How-To ======

===== How-to manuals =====

~~NOCACHE~~

<catlist . -noHead >


===== Write OOWOW image to removable storage ======

<WRAP important >
Need replace ''/dev/sdX'' to actual device node name
</WRAP>

```sh VIM1S
curl -L http://dl.khadas.com/products/oowow/system/vim1s-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```

```sh VIM1 
curl -L http://dl.khadas.com/products/oowow/system/vim2-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```

```sh VIM2
curl -L http://dl.khadas.com/products/oowow/system/vim2-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```

```sh VIM3
curl -L http://dl.khadas.com/products/oowow/system/vim3-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```

```sh VIM3L
curl -L http://dl.khadas.com/products/oowow/system/vim3l-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```

```sh VIM4
curl -L http://dl.khadas.com/products/oowow/system/vim4-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```


```sh Edge
curl -L http://dl.khadas.com/products/oowow/system/edge-oowow-latest-sd.img.gz \
| gzip -dc | dd conv=fsync,notrunc of=/dev/sdX
```

## Check whats a latest oowow image

```sh check latest oowow sd image
curl -s -I http://dl.khadas.com/products/oowow/system/${BOARD}-oowow-latest-sd.img.gz | grep Location:
```

''BOARD := [ edge | edge2 | vim1 | vim1s | vim2 | vim3 | vim3l | vim4 ]''


```shell check latest oowow sd image version for vim3 example

~$ curl -s -I http://dl.khadas.com/products/oowow/system/vim3-oowow-latest-sd.img.gz | grep Location:

Location: http://dl.khadas.com/products/oowow/system/versions/vim3/vim3-oowow-230227.000-sd.img.gz
```

## Resolve boot-up problem

if Boot OOWOW doesn't works via hold __FUNCTION__ and short press __RESET__

  * [[#manualy-restore-oowow-spi-flash-firmware]]
  * [[#boot-up-oowow-from-sd-card]]

## Manualy restore OOWOW SPI-Flash firmware

For same cases if OOWOW can't bootup automaticly or via [[..:user-manual#vim4-button-shortcuts|special button shortcuts]]

<WRAP important >
In some case eMMC system content not allowed to boot from removable storages, in this case can try another methods, or need clean eMMC system 1st for example by same OOWOW 
</WRAP>


  * download ''XXX-oowow-latest-spi-upgrade-sd.img.gz'' from [[http://dl.khadas.com/products/oowow/system]]
  * write image ''XXX-oowow-latest-spi-upgrade-sd.img.gz'' to SD-card, USB or any other removable storage
  * boot-up from any removable storage and wait upgrade process will be completed
  * remove removable storage and reboot device

<WRAP info >
replace XXX to right board name ''vim4 edge2 vim1s ...''
</WRAP>

NOTE: [[https://docs.khadas.com/products/sbc/edge2/troubleshooting/usb-burn-online#restore-oowow-firmware|Edge2 restore OOWOW another way]]


## Manual write OOWOW firmware by online  
<WRAP info >
To update or force-write the OOWOW firmware to the SPI flash on your Edge2 device manually **using Linux**, follow these steps:
</WRAP>

  - Use a USB cable to connect your Edge2 device to your PC via the USB OTG port (not the power USB port)  
  - Copy and paste ''%%curl dl.khadas.com/online/rockchip-burn | sh -s - oowow --refresh --write --spi%%'' command line into the linux terminal
  - Wait prompt message ''[i] wait device with upgrade mode - need press KEY_FN 3x times''
  - Press **KEY_FN 3x times** - middle key on left side 
  - Wait prompt message ''Write LBA from file (100%)'' This indicates the firmware has been successfully written to the SPI flash.
  - Auto reboot your Edge2 device into new OOWOW firmware\\ ''
[i] OKAY edge2-oowow-latest-spi.img.gz was written to spi\\
[i] reset device''


```shell manual update OOWOW firmware by online
curl dl.khadas.com/online/rockchip-burn | sh -s - oowow --refresh --write --spi
```

Get much more help information https://dl.khadas.com/online/ or

```shell display much more usage information
curl dl.khadas.com/online/rockchip-burn | sh -s - --help
```

## Manual write OOWOW into SPI flash from local storage 

This method can be useful if we stay offline, or emergency update, restore, fix our SPI system.

  * We need just boot oowow from any source like **sd** / **usb** / **eMMC** / **SPI**
  * Next step is mount any storage with OOWOW SPI image - its can be same **sd** / **usb** / **eMMC**

<WRAP info >
Be careful this method cat write any content into SPI flash without checking for compatibility!
</WRAP>

```shell write oowow to SPI flash example
root@oowow:/# gzip -dc /tmp/mounts/USB-sda1/oowow-spi.img.gz | spi_update
[i] spiupdate => /dev/mtdblock0 (16777216 - 4096)
###  all blks wrtd same
096 3936 4096 0361 3575
SPI flash update DONE

root@OOWOW:/# spi off && mmc on
``` 
## Boot-up OOWOW from SD-card

<WRAP important >
In most cases, it will be same suitable to use any other removable storage like USB-Flash etc
</WRAP>

For same cases if embedded OOWOW can't bootup from SPI-Flash. [[:OOWOW]] can be started from SD-card anytime.

  * download ''XXX-oowow-latest-sd.img.gz'' from http://dl.khadas.com/products/oowow/system/
  * write image ''XXX-oowow-latest-sd.img.gz'' to SD-card
  * boot-up from SD-card

<WRAP info >
 replace XXX to right board name ''vim4 edge2 vim1s ...''
</WRAP>

## Write custom OS image into eMMC from removable storage

  * copy your OS image into any removable storage SD / USB Flash , etc (formatted by exfat or ext2/3/4 or fat)
  * start OOWOW by press __FUNCTION__ + __RESET__
  * exit from wizard
  * plug removable storage with OS image
  * choose this image to write by __menu -> Write image to eMMC __ and up to .. mounts

<WRAP info >
Supported images:
  * raw images ''dd'' suitable - ''.img''
  * compressed images ''.img.xz'' lzma , ''.img.gz'' gzip, ''.img.zst'' zstd
</WRAP>

## Install online OS image without Ethernet

All devices have on-board Wi-Fi module, also can used for for Internet access.

  * Configure Wi-Fi connection one time / automaticly will be used next time
  * or can use [[..:user-manual#easy-wi-fi]] mode

## Headless usage

OOWOW easily can used without display and keyboards.

  * [[..:user-manual#easy-wi-fi]]
  * [[..:user-manual#hotspot]]

## OOWOW and Smartphone

OOWOW easily can controlled by smatphone

  * [[..:user-manual#easy-wi-fi]]
  * [[..:user-manual#hotspot]]
  * [[..:user-manual#hotspot-qr-code]]
  * [[..:user-manual#web-access-qr-code]]


WIP:


===== write custom OS image into eMMC from removable storage =====

  * copy your OS image into any removable storage SD / USB Flash , etc (formatted by exfat or ext2/3/4 or fat)
  * start oowow by press FUNCTION + RESET
  * exit from wizard
  * plug removable storage with OS image
  * choose this image to write by __ menu -> Write image to eMMC __ and up to .. mounts

WIP:
Khadas Docs

User Tools

Site Tools

Page Tools
