Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / software / oowow / how-to
software:oowow:how-to:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
software:oowow:how-to:start [2023/01/04 21:45]
hyphop 		software:oowow:how-to:start [2025/03/03 01:27] (current)
hyphop [Manual write OOWOW firmware by online]
Line 1: Line 1:
 +~~tag>OOWOW howto~~
 ====== OOWOW How-To ====== ====== 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 ===== ===== write custom OS image into eMMC from removable storage =====
Line 8: Line 204:
   * plug removable storage with OS image   * plug removable storage with OS image
   * choose this image to write by __ menu -> Write image to eMMC __ and up to .. mounts   * choose this image to write by __ menu -> Write image to eMMC __ and up to .. mounts
- 
  
 WIP: WIP:
  
  
Last modified: 2023/01/04 21:45 by hyphop

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads