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
Last revision Both sides next revision
software:oowow:user-manual [2022/09/26 01:22]
hyphop [OOWOW user manual] 		software:oowow:user-manual [2022/12/28 02:56]
hyphop [Common Button Shortcuts]
Line 17: Line 17:
 ===== Hardware ===== ===== Hardware =====
  
 +Supported devices: [[devices]]
  
 ==== Hardware Buttons ==== ==== Hardware Buttons ====
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 91: 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 109: Line 110:
  
 <WRAP tip > <WRAP tip >
-Access can be restricted by the Firewall.+Access can be restricted by the [[#firewall]]
 </WRAP> </WRAP>
  
Line 134: 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 192: 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 234: 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 246: 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 274: 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 283: Line 314:
  
 ==== Firewall ==== ==== Firewall ====
- 
  
 **Network -> Firewall Mode:** **Network -> Firewall Mode:**
Line 336: 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 344: 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 361: 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]]
 +  * [[why-oowow]]
 +  * [[about-oowow-name]]
  
  
Last modified: 2023/02/27 01:37 by hyphop

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads