dbroqua/kobol-wiki
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Merge pull request #1 from aprayoga/usb_page

Browse source 
Usb page
This commit is contained in:
nurix87 2020-03-05 17:03:20 +07:00 committed by GitHub
commit db56cd5a9d
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
6 changed files with 178 additions and 35 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

51
docs/helios64/download.md
View file

@ -6,48 +6,37 @@ All the following images are generated by [Armbian](https://www.armbian.com/heli
### Armbian Buster (Debian 10) ### Armbian Buster (Debian 10)
[![Debian Stretch](/helios64/img/os/debian10.png)](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_buster_current_4.19.84.7z)<br> [![Debian Stretch](/helios64/img/os/debian10.png)]()<br>
*MD5SUM : cdb4463097190de35a2e58b1b12223f9<br> *MD5SUM : <br>
Build date : 19/11/2019<br> Build date : <br>
Size : 274 MB<br>* Size : MB<br>*
[Direct Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_buster_current_4.19.84.7z) <s>[Direct Download]()</s>
!!! important !!! important
OMV5 (OpenMediaVault 5) for Debian 10 Buster is still in beta and unstable. If you wand to use OMV, then you should use Debian 9 Stretch with OMV 4 for now. OMV5 (OpenMediaVault 5) for Debian 10 Buster is still in beta and unstable. If you wand to use OMV, then you should use Debian 9 Stretch with OMV 4 for now.
### Armbian Stretch (Debian 9) ### Armbian Stretch (Debian 9)
[![Debian Stretch](/helios64/img/os/debian9.png)](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_stretch_legacy_4.14.154.7z)<br> [![Debian Stretch](/helios64/img/os/debian9.png)]()<br>
*MD5SUM : cb7124089b8e1ff6feed32a5c5b768af<br> *MD5SUM : <br>
Build date : 19/11/2019<br> Build date : <br>
Size : 258 MB<br>* Size : MB<br>*
[Direct Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_stretch_legacy_4.14.154.7z) <s>[Direct Download]()</s>
!!! note !!! note
OMV4 (OpenMediaVault 4) can be installed with the **armbian-config** tool as explained [here](/helios4/omv/#install-openmediavault). OMV4 (OpenMediaVault 4) can be installed with the **armbian-config** tool as explained [here](/helios4/omv/#install-openmediavault).
### Armbian Bionic (Ubuntu 18.04) ### Armbian Bionic (Ubuntu 18.04)
[![Ubuntu Bionic](/helios64/img/os/ubuntu.png)](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_bionic_current_4.19.84.7z)<br> [![Ubuntu Bionic](/helios64/img/os/ubuntu.png)]()<br>
*MD5SUM : 7d0f80524bf2d24a3de403a6233a655b<br> *MD5SUM : <br>
Build date : 19/11/2019<br> Build date : <br>
Size : 192 MB<br>* Size : MB<br>*
[Direct Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_bionic_current_4.19.84.7z) <s>[Direct Download]()</s>
## Known Limitations ## Known Limitations
- SDcard High Speed timing have compatibility issue with some brands.
**Temporary workaround :** Disable UHS option/support.
*Can be manually enable, refer to the following [page](/helios4/sdcard).*
- During SATA heavy load, accessing SPI NOR Flash will generate ATA errors.
**Temporary workaround :** Disable SPI NOR flash.
*Can be manually enable, refer to the following [page](/helios4/spi).*
## Image List ## Image List
@ -57,12 +46,4 @@ Size : 192 MB<br>*
Filename | Download | MD5 Filename | Download | MD5
---------|----------|---- ---------|----------|----
**Armbian_19.11.3_Helios4_buster_current_4.19.84.7z**<br>Armbian 19.11.3 Debian 10 Buster (Kernel 4.19.84)<br>Build date : 19/11/2019<br>Size : 274 MB|[Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_buster_current_4.19.84.7z)|cdb4463097190de35a2e58b1b12223f9 ***TBD***
**Armbian_19.11.3_Helios4_stretch_legacy_4.14.154.7z**<br>Armbian 19.11.3 Debian 9 Stretch (Kernel 4.14.154)<br>Build date : 19/11/2019<br>Size : 258 MB|[Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_stretch_legacy_4.14.154.7z)|cb7124089b8e1ff6feed32a5c5b768af
**Armbian_19.11.3_Helios4_bionic_current_4.19.84.7z**<br>Armbian 19.11.3 Ubuntu 18.04 Bionic (Kernel 4.19.84)<br>Build date : 19/11/2019<br>Size : 192 MB|[Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_bionic_current_4.19.84.7z)|7d0f80524bf2d24a3de403a6233a655b
**Armbian_5.91_Helios4_Debian_buster_next_4.19.63.7z**<br>Armbian 5.91 Debian 10 Buster (Kernel 4.19.63)<br>Build date : 02/08/2019<br>Size : 261 MB|[Download](https://cdn.kobol.io/files/Armbian_5.91_Helios4_Debian_buster_next_4.19.63.7z)|9c48344c208dfa50b5868debe6fae629
**Armbian_5.91_Helios4_Debian_stretch_default_4.14.135.7z**<br>Armbian 5.91 Debian 9 Stretch (Kernel 4.14.135)<br>Build date : 02/08/2019<br>Size : 252 MB|[Download](https://cdn.kobol.io/files/Armbian_5.91_Helios4_Debian_stretch_default_4.14.135.7z)|e8416b359a7620bb01b5a13c6a10612f
**Armbian_5.91_Helios4_Ubuntu_bionic_next_4.19.63.7z**<br>Armbian 5.91 Ubuntu 18.04 Bionic (Kernel 4.19.63)<br>Build date : 02/08/2019<br>Size : 192 MB|[Download](https://cdn.kobol.io/files/Armbian_5.91_Helios4_Ubuntu_bionic_next_4.19.63.7z)|62983d7519f15e67355d6dd5e60ee353
**Armbian_5.77_Helios4_Debian_stretch_next_4.14.106.7z**<br>Armbian 5.77 Debian 9 Stretch (Kernel 4.14.106)<br>Build date : 14/03/2019<br>Size : 238 MB|[Download](https://cdn.kobol.io/files/Armbian_5.77_Helios4_Debian_stretch_next_4.14.106.7z)|5f2e19d6ecf8a35de89c881fb06bd56e
**Armbian_5.77_Helios4_Ubuntu_bionic_next_4.14.106.7z**<br>Armbian 5.77 Ubuntu 18.04 Bionic (Kernel 4.14.106)<br>Build date : 14/03/2019<br>Size : 177 MB|[Download](https://cdn.kobol.io/files/Armbian_5.77_Helios4_Ubuntu_bionic_next_4.14.106.7z)|90805f23c5c6491bbf1b251f4d3d74a0
**Armbian_5.75_Helios4_Ubuntu_bionic_next_4.14.98.7z**<br>Armbian 5.75 Ubuntu 18.04 Bionic (Kernel 4.14.98)<br>Build date : 10/02/2019<br>Size : 193 MB|[Download](https://dl.armbian.com/helios4/archive/Armbian_5.75_Helios4_Ubuntu_bionic_next_4.14.98.7z)|d70b2d51b29e6729c33bbec90825f47a

BIN
docs/helios64/img/usb/otb_cable_usb_c.jpg Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 8.7 KiB

BIN
docs/helios64/img/usb/usb_diagram.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 38 KiB

BIN
docs/helios64/img/usb/usb_mux.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 21 KiB

161
docs/helios64/usb.md Normal file
View file

@ -0,0 +1,161 @@
## USB on RK3399
There are two types of USB controller available on RK3399. Each type has two controller so total USB controllers is 4.
### Generic EHCI USB 2.0 Controller
There are two controller of this type. This controller is Host only controller that is compatible with USB 2.0 and backward compatible with USB 1.1.
Supported speed:
- High Speed (480 Mbps)
- Full Speed (12 Mbps)
- Low Speed (1.5 Mbps)
### Synopsys DesignWare USB 3.0 Dual-Role Device Controller
There are two controller of this type. This controller support On-The-Go /Dual Role which mean it can be configured as Host and also Device.
Supported speed:
- Super Speed (5 Gbps)
- High Speed (480 Mbps)
- Full Speed (12 Mbps)
- Low Speed (1.5 Mbps)
The controller is connected to Rockchip Type-C PHY.
## USB on Helios64
![!USB Connection](/helios64/img/usb/usb_diagram.png)
One of EHCI Controller is connected to M.2 socket.
The first Synopsys DesignWare USB 3.0 Dual-Role Device Controller is connected to USB Type-C connector and configured as OTG with help of FUSB302.
The second Synopsys DesignWare USB 3.0 Dual-Role Device Controller is connected to USB Hub 3.1 Gen 1 and configured as Host only.
### Power Budget
Each of external USB port is protected by Power Distribution switch with following current limit.
| Port | Voltage | Maximum Current | Remarks |
|------------|-------|------------------|---------|
| USB 3.0 Upper Back Panel | 5V | 900 mA | |
| USB 3.0 Lower Back Panel | 5V | 900 mA | |
| USB 3.0 Front Panel | 5V | 900 mA | |
| Type-C | 5V | 1200 mA | PDO source only |
## USB Type-C Functionality on Helios64
To simplify the cabling, Helios64 is designed to have
![!USB Mux](/helios64/img/usb/usb_mux.png)
### Serial Console
Serial Console of Helios64 is connected to FT232 USB Serial converter and the USB 2.0 signal of the FT232 is connected to USB 2.0 signals of USB Type-C Port.
Refer to ***JUMPER PAGE***
### DisplayPort Alternate Mode
Using USB Type-C to DisplayPort cable or USB Type-C to HDMI dongle, Helios64 can be connected to monitor to display Linux Desktop or other GUI application.
*** Put USB Type-C to DisplayPort cable photo here ***
*** Put USB Type-C to HDMI dongle photo here ***
!!! note
DisplayPort Alternate Mode is NOT supported on U-Boot.
### USB Host
Using OTG cable such as,
![!USB-C OTG Cable](/helios64/img/usb/otb_cable_usb_c.jpg)
Helios64 can act as USB host and can be connected to various USB device.
### USB Device
Helios64 can be used as Direct Attached Storage (DAS) with proper configuration and kernel module. Refer to [Helios64 as Direct Attached Storage (DAS) device](#helios64-as-direct-attached-storage-das-device)
Helios64 can also used as "USB eMMC reader/writer" for OS recovery purpose. Refer to [USB OTG Port (USB Type-C)](#usb-otg-port-usb-type-c)
## USB under U-Boot
### USB Host Port
USB Host support in U-Boot is quite minimal, it only support USB storage and USB ethernet.
### USB OTG Port (USB Type-C)
USB Type C port is configured as USB device mode as USB Mass Storage connected to eMMC.
This function can be activated by pressing Recovery Button.
This is to serve as a way to (re)install OS to eMMC.
## USB under Linux
### USB Bus Mapping
| USB Controller | Bus number | Remarks |
|----------------|------------|---------|
| EHCI Host0 | 0 | |
| EHCI Host1 | 1 | |
| DWC3 Typec0 USB 3.0 | 2 | |
| DWC3 Typec0 USB 2.0 | 3 | |
| DWC3 Typec1 USB 3.0 | 4 | |
| DWC3 Typec1 USB 2.0 | 5 | |
----- ***TBC*** ------
### Helios64 as Direct Attached Storage (DAS) device
Helios64 can be used as Direct Attached Storage (DAS) device with help of Linux USB Gadget kernel module.
The kernel moodule only export the underlying block device NOT the filesystem layer. Therefore if the block device is formatted with filesystem unique to Linux,
the exported disk may not readable by computer that has Helios64 connected to.
For example, the block device is formatted with EXT4 filesystem and Helios64 connected to Windows PC as DAS,
the Windows PC will not be able to read the disk content unless 3rd party software/driver installed.
!!! warning
Do NOT access Helios64 simultanouesly as DAS and NAS, as the filesystem is not managed by system and can lead to data corruption.
#### Individual Disk Exported as Separate Disk
----- ***more info soon*** -----
```
modprobe g_mass_storage file=/dev/sda,/dev/sdb,/dev/sdc,/dev/sdd,/dev/sde
```
----- *** Put Windows Explorer & Disk management screenshot here *** -----
----- *** Put lsusb & lsblk here *** -----
#### RAID device exported as One Disk
----- ***more info soon*** -----
```
modprobe g_mass_storage file=/dev/md/md-raid6
```
----- *** Put Windows Explorer & Disk management screenshot here *** -----
----- *** Put lsusb & lsblk here *** -----

1
mkdocs.yml
View file

@ -79,6 +79,7 @@ nav:
- GPIO : 'helios64/gpio.md' - GPIO : 'helios64/gpio.md'
- I2C : 'helios64/i2c.md' - I2C : 'helios64/i2c.md'
- LED : 'helios64/led.md' - LED : 'helios64/led.md'
- USB : 'helios64/usb.md'
- Helios4: - Helios4:
- Introduction: 'helios4/intro.md' - Introduction: 'helios4/intro.md'
- Kit Assembly: 'helios4/kit.md' - Kit Assembly: 'helios4/kit.md'