~~tag>OOWOW howto~~
====== OOWOW How-To ======

===== 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]]

  * 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
  * boot-up from SD-card and wait upgrade process will be complited
  * remove SD-card 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]]


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

===== All how-to topics =====

~~NOCACHE~~

<catlist . -noHead >