Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / software / oowow / user-manual
software:oowow:user-manual

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:user-manual [2022/09/26 01:01]
hyphop [Tips to Boot OOWOW] 		software:oowow:user-manual [2024/11/06 21:03] (current)
hyphop [Dump eMMC by LAN network]
Line 1: Line 1:
 ====== OOWOW User Manual ====== ====== OOWOW User Manual ======
  
-[[getting-started]]+Short introduction: [[getting-started]]
  
 ===== Main Features ===== ===== Main Features =====
Line 17: Line 17:
 ===== Hardware ===== ===== Hardware =====
  
 +Supported devices: [[.devices:start]]
  
 ==== Hardware Buttons ==== ==== Hardware Buttons ====
Line 22: Line 23:
 {{:products:sbc:vim4:hardware:vim4-buttons.webp?400|}} {{:products:sbc:vim4:hardware:vim4-buttons.webp?400|}}
  
-You can use the three [[/products/sbc/vim4/hardware/interfaces#hardware-buttons]] on your device to interact directly with the [[:OOWOW:]] system, we will describe them in more detail within the next section.+You can use the three [[/products/sbc/vim4/hardware/interfaces#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   * **RESET** - reset device
Line 31: Line 32:
  
   * Boot OOWOW - hold **FUNCTION** and short press **RESET** then release **FUNCTION**   * Boot OOWOW - hold **FUNCTION** and short press **RESET** then release **FUNCTION**
-  * Toggle Easy Wi-Fi - short press **POWER** button +  * Toggle [[#easy-wi-fi|Easy Wi-Fi]] - short press **POWER** button 
-  * Toggle Hotspot -  short press **FUNCTION** button+  * Toggle [[#hotspot|Hotspot]] -  short press **FUNCTION** button
   * Accept Hotspot client  - short press **POWER** button   * Accept Hotspot client  - short press **POWER** button
   * Power off - Long press the **POWER** button until device shuts down   * 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+  * Enter multifunction mode - press and hold **FUNCTION** button (loop cycle: [[#hotspot|Hotspot]] -> [[#firewall|Firewall Allow]] -> [[#firewall|Firewall Block]] -> Cancel, each mode wait 2 sec ), release to activate selected function
  
 <WRAP tip > <WRAP tip >
Line 75: Line 76:
 Multifunctional modes: Multifunctional modes:
  
-  * Hotspot: **White off** +^ Events ^ Indications ^ 
-  * Firewall block incoming: **White solid, red off** +|Hotspot | White off | 
-  * Firewall allow incoming: **White & red solid** +|Firewall block incoming | White solid, red off |  
-  * Cancel: **White blinking**+|Firewall allow incoming | White & red solid | 
 +|Cancel | White blinking |
  
 ===== Interfaces ===== ===== Interfaces =====
Line 90: Line 92:
 === Navigation === === Navigation ===
  
-  * Keys: 0-9 A-Z ⇦ ⇨ ⇧ ⇩ Space Enter Esc Tab +  * Keys: ''0-9 A-Z ⇦ ⇨ ⇧ ⇩ Space Enter Esc Tab'' 
-  * Mouse: select menu items and press buttons+  * Mouse (for Web Interface only): select menu items and press buttons
  
 === HDMI + Keyboard === === HDMI + Keyboard ===
Line 108: Line 110:
  
 <WRAP tip > <WRAP tip >
-Access can be restricted by the Firewall.+Access can be restricted by the [[#firewall]]
 </WRAP> </WRAP>
  
Line 133: Line 135:
 === Serial UART Access === === Serial UART Access ===
  
 +For developers and advanced users.
  
-For developers and advanced users only. +  * Check how-to [[products:sbc:common:development:setup-serial-tool]] 
- +  * Root access works by default without password 
-  * Check [[products:sbc:common:development:setup-serial-tool|documentation]] to setup the serial debug tool +  * Type ''system'' to enter to main menu, or use other shell commands 
-  * root access works by default without password +
-  * ''system'' - main menu+
  
 ==== WEB API ==== ==== WEB API ====
  
-For developers and advanced users only.+For developers and advanced users WIP: 
 + 
 +<WRAP tip > 
 +Access can be restricted by the [[#firewall]] 
 +</WRAP> 
 + 
 + 
 +==== 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 ==== 
 + 
 +```sh Write to eMMC  
 + 
 +curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - IMAGE 
 +``` 
 + 
 +==== Write Image to SD by LAN network ==== 
 + 
 +```sh Write to SD 
 + 
 +curl OOWOW_HOST_NAME_OR_IP/shell/write | sh -s - IMAGE -sd 
 +``` 
 + 
 +==== Write SPI oowow image by LAN network ==== 
 + 
 + 
 +```sh 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 ==== 
 + 
 +```sh 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 ==== 
 + 
 +  - Navigate to the backup menu: **OOWOW main menu** => **Dump image from eMMC** 
 +  - 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 
 +  - Start backup: **Start**, and wait for few minutes to finish the backup and exit. 
 + 
 + 
 +==== Restore backup ==== 
 + 
 +  - Navigate to the restore menu: **OOWOW main menu** => **Write image to eMMC** 
 +  - 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 
 +  - Restore the image: **Write**, and wait for few minutes to write the image and exit. 
  
 ===== Networks ===== ===== Networks =====
Line 191: Line 259:
  
 ```shell ```shell
-# ping vim4-05690+~$ ping vim4-05690
 PING vim4-05690 (192.168.30.203) 56(84) bytes of data. 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 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 -c1 vim4-05690.local
 PING vim4-05690.local (192.168.30.203) 56(84) bytes of data. 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 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://vim4-05690.local 
-# curl http://192.168.30.203 +~$ curl http://192.168.30.203 
-# curl 192.168.30.203 +~$ curl 192.168.30.203 
-# ssh root@vim4-05690 +~$ ssh root@vim4-05690 
-# ssh root@vim4-05690.local+~$ ssh root@vim4-05690.local
 ``` ```
  
Line 233: Line 301:
  
   * Toggle Easy Wi-Fi - short press **POWER** button   * Toggle Easy Wi-Fi - short press **POWER** button
-  * ***Network -> Wi-Fi -> Easy Wi-Fi oowow > Enable / Disable***+  * **Network => Wi-Fi => Easy Wi-Fi oowow => Enable / Disable**
  
 Setup a new hotspot from your mobile device with the following configuration: Setup a new hotspot from your mobile device with the following configuration:
Line 245: Line 313:
  
  
-You can enable the OOWOW hotspot feature in two ways:+You can enable the OOWOW hot-spot feature in two ways:
  
   * Toggle hotspot - short press **FUNCTION** button   * Toggle hotspot - short press **FUNCTION** button
-  * **Network -> Hotspot -> Hotspot Enable / Disable**+  * **Network => Hotspot => Hotspot Enable / Disable**
  
-The OOWOW hotspot will have the following configuration:+The OOWOW hot-spot will have the following configuration:
  
   * SSID: **vim4-xxxxx** ( xxxxx - last 5 digits from device serial number )   * SSID: **vim4-xxxxx** ( xxxxx - last 5 digits from device serial number )
   * Password: **12345678**   * Password: **12345678**
  
-These hostnames can be used for device access via the hotspot:+These host names can be used for device access via the hotspot:
  
   * http://172.23.0.1   * http://172.23.0.1
Line 273: Line 341:
 ### Web access QR code ### Web access QR code
  
-  * Network -> Hotspot -> Device Web Access QR code +  * Network => Hotspot => Device Web Access QR code 
-  * Network -> Wi-Fi -> Device Web Access QR code+  * Network => Wi-Fi => Device Web Access QR code
  
 ==== USB-OTG Network ==== ==== USB-OTG Network ====
Line 282: Line 350:
  
 ==== Firewall ==== ==== Firewall ====
- 
  
 **Network -> Firewall Mode:** **Network -> Firewall Mode:**
Line 335: Line 402:
 === Ethernet === === 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:
 +
 +  * Manage the programmable MCU
 +  * Carry out low level hardware management
 +  * Let developers utilize all the features of SBC device
 +
 +====  Reset MCU to factory mode ====
 +
 +Reset MCU/KBI configuration to default values
 +
 +<WRAP tip >
 +This procedure totally safe, and never change eMMC storage content or any other parts. 
 +</WRAP>
 +
 +====  Boot-mode ====
 +
 +Setup device boot-mode values:
 +
 +  * ''emmc'' - boot up device from ''eMMC'' **default**
 +  * ''spi'' - boot up device from ''SPI-flash''
 +
 +<WRAP important >
 +For use Android need setup boot-mode to ''emmc''
 +</WRAP>
 +
 +WIP:
  
-TODO. 
  
 ===== Security and Privacy ===== ===== Security and Privacy =====
Line 343: Line 442:
   * OOWOW works only by user demand, and never works in the background   * OOWOW works only by user demand, and never works in the background
   * OOWOW never sends any private data from your device to the internet   * OOWOW never sends any private data from your device to the internet
-  * By default, remote access to your device is blocked by the firewall+  * By default, remote access to your device is blocked by the [[#firewall]]
  
 ===== Limitations ===== ===== Limitations =====
Line 360: Line 459:
 ===== Download OOWOW ===== ===== Download OOWOW =====
  
- +  * [[dl>products/oowow/| OOWOW main download page ]] 
-Check [[dl>products/vim4/firmware/oowow/system/|here]] for oowow system images.+  * [[dl>products/oowow/system/| Latest OOWOW system/firmware images]] 
 +  * [[dl>products/oowow/system/versions/| Full OOWOW versions images]]
  
 ==== Image Types ==== ==== Image Types ====
  
- +  * BOARD-oowow-latest-sd.img.gz - latest oowow image for SD-card or USB-thumb drive 
-  * vim4-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 
-  * vim4-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
-  * vim4-oowow-latest-spi-upgrade-sd.img.gz - upgrade oowow SPI-flash firmware from SD-card+
  
 ==== Filename for Latest OOWOW Version ==== ==== Filename for Latest OOWOW Version ====
  
-  * vim4-oowow-latest-sd.img.gz -> versions/vim4/vim4-oowow-VERSION-sd.img.gz+  * BOARD-oowow-latest-sd.img.gz -> versions/BOARD/BOARD-oowow-VERSION-sd.img.gz
  
 <WRAP tip > <WRAP tip >
-Download the latest OOWOW image file with this link: https://dl.khadas.com/products/vim4/firmware/oowow/system/vim4-oowow-latest-sd.img.gz.+Download the latest OOWOW SD images: 
 +  * https://dl.khadas.com/products/oowow/system/vim4-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/vim3-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/vim3l-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/vim2-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/vim1-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/vim1s-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/edge2-oowow-latest-sd.img.gz 
 +  * https://dl.khadas.com/products/oowow/system/edge-oowow-latest-sd.img.gz
 </WRAP> </WRAP>
  
-Download images using command line:+Download images command line examples:
  
-  * ''curl -JOL https://dl.khadas.com/products/vim4/firmware/oowow/system/vim4-oowow-latest-sd.img.gz'' +  * ''curl -JOL https://dl.khadas.com/products/oowow/system/vim4-oowow-latest-sd.img.gz'' 
-  * ''wget --content-disposition https://dl.khadas.com/products/vim4/firmware/oowow/system/vim4-oowow-latest-sd.img.gz''+  * ''wget --content-disposition https://dl.khadas.com/products/oowow/system/vim4-oowow-latest-sd.img.gz''
  
-===== About OOWOW =====+===== More information =====
  
 +  * [[.devices:start]]
 +  * [[why-oowow]]
 +  * [[about-oowow-name]]
  
-==== Why Create OOWOW? ==== 
- 
- 
-The process of new OS Installation is the biggest headache for users of single board computers (SBC); before installing an OS, users must read tons of manuals, trawl through online forums, learn how to install/reinstall using their desktop/laptop PC, learn where to find proper images etc…If something goes wrong it is possible to “BRICK” (destroy) your device(even through we can use TST mode to recovery rhe device).  
- 
-In other words, any form of device upgrade, maintenance, or OS reinstallation requires advanced skills and external hardware, and this is out of reach for the average user, or users in regions without desktop/laptop PCs. With OOWOW your SBC becomes a standalone device; perform all maintenance functions and OS installation directly from the device itself. 
- 
-OOWOW understands the end user deeply; it provides an out-of the-box, universal OS delivery and device configuration solution for all SBCs in the market today and into the future. 
- 
-Live life easily with OOWOW! 
- 
-==== What is the meaning of 'OOWOW'? ==== 
- 
- 
-oowow - infinity level wow (will be a new 77th word in the English dictionary). 
- 
-  * Pronunciation: /uː/  +  /wau/ = /u:wau/ 
-  * Variations: ∞wow, infinity wow, endless wow 
- 
-<WRAP tip > 
-  * https://en.wiktionary.org/wiki/wow 
-  * https://www.crosswordsolver.org/words-starting-with-oo 
-</WRAP> 
  
Last modified: 2022/09/26 01:01 by hyphop

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads