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 00:57]
hyphop [Hardware Buttons] 		software:oowow:user-manual [2023/02/27 01:37] (current)
hyphop ↷ Links adapted because of a move operation
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 ====
  
 +{{:products:sbc:vim4:hardware:vim4-buttons.webp?400|}}
  
-You can use the three [[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 30: 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 44: Line 46:
  
  
-  * Eject your TF card before booting OOWOW (TF card has highest priority)+  * Eject your micro SD-card before booting OOWOW (micro SD-card has highest priority)
   * Boot OOWOW from sleep: hold **FUNCTION** button + short press **RESET** button + release **FUNCTION** button   * Boot OOWOW from sleep: hold **FUNCTION** button + short press **RESET** button + release **FUNCTION** button
   * Boot OOWOW with power cable: hold **FUNCTION** button + plug power cable   * Boot OOWOW with power cable: hold **FUNCTION** button + plug power cable
Line 74: 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 89: 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 107: Line 110:
  
 <WRAP tip > <WRAP tip >
-Access can be restricted by the Firewall.+Access can be restricted by the [[#firewall]]
 </WRAP> </WRAP>
  
Line 132: 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 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 
 +```
  
 ===== Networks ===== ===== Networks =====
Line 190: Line 223:
  
 ```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 232: Line 265:
  
   * 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 244: Line 277:
  
  
-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 272: Line 305:
 ### 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 281: Line 314:
  
 ==== Firewall ==== ==== Firewall ====
- 
  
 **Network -> Firewall Mode:** **Network -> Firewall Mode:**
Line 334: Line 366:
 === 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 342: Line 406:
   * 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 359: Line 423:
 ===== 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 00:57 by hyphop

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads