diff --git a/docs/helios64/download.md b/docs/helios64/download.md index fd432ef..196f069 100644 --- a/docs/helios64/download.md +++ b/docs/helios64/download.md @@ -6,48 +6,37 @@ All the following images are generated by [Armbian](https://www.armbian.com/heli ### 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)
-*MD5SUM : cdb4463097190de35a2e58b1b12223f9
-Build date : 19/11/2019
-Size : 274 MB
* -[Direct Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_buster_current_4.19.84.7z) +[![Debian Stretch](/helios64/img/os/debian10.png)]()
+*MD5SUM :
+Build date :
+Size : MB
* +[Direct Download]() !!! 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. ### 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)
-*MD5SUM : cb7124089b8e1ff6feed32a5c5b768af
-Build date : 19/11/2019
-Size : 258 MB
* -[Direct Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_stretch_legacy_4.14.154.7z) +[![Debian Stretch](/helios64/img/os/debian9.png)]()
+*MD5SUM :
+Build date :
+Size : MB
* +[Direct Download]() !!! note OMV4 (OpenMediaVault 4) can be installed with the **armbian-config** tool as explained [here](/helios4/omv/#install-openmediavault). ### 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)
-*MD5SUM : 7d0f80524bf2d24a3de403a6233a655b
-Build date : 19/11/2019
-Size : 192 MB
* -[Direct Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_bionic_current_4.19.84.7z) +[![Ubuntu Bionic](/helios64/img/os/ubuntu.png)]()
+*MD5SUM :
+Build date :
+Size : MB
* +[Direct Download]() ## 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 @@ -57,12 +46,4 @@ Size : 192 MB
* Filename | Download | MD5 ---------|----------|---- -**Armbian_19.11.3_Helios4_buster_current_4.19.84.7z**
Armbian 19.11.3 Debian 10 Buster (Kernel 4.19.84)
Build date : 19/11/2019
Size : 274 MB|[Download](https://dl.armbian.com/helios4/archive/Armbian_19.11.3_Helios4_buster_current_4.19.84.7z)|cdb4463097190de35a2e58b1b12223f9 -**Armbian_19.11.3_Helios4_stretch_legacy_4.14.154.7z**
Armbian 19.11.3 Debian 9 Stretch (Kernel 4.14.154)
Build date : 19/11/2019
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**
Armbian 19.11.3 Ubuntu 18.04 Bionic (Kernel 4.19.84)
Build date : 19/11/2019
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**
Armbian 5.91 Debian 10 Buster (Kernel 4.19.63)
Build date : 02/08/2019
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**
Armbian 5.91 Debian 9 Stretch (Kernel 4.14.135)
Build date : 02/08/2019
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**
Armbian 5.91 Ubuntu 18.04 Bionic (Kernel 4.19.63)
Build date : 02/08/2019
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**
Armbian 5.77 Debian 9 Stretch (Kernel 4.14.106)
Build date : 14/03/2019
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**
Armbian 5.77 Ubuntu 18.04 Bionic (Kernel 4.14.106)
Build date : 14/03/2019
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**
Armbian 5.75 Ubuntu 18.04 Bionic (Kernel 4.14.98)
Build date : 10/02/2019
Size : 193 MB|[Download](https://dl.armbian.com/helios4/archive/Armbian_5.75_Helios4_Ubuntu_bionic_next_4.14.98.7z)|d70b2d51b29e6729c33bbec90825f47a +***TBD*** \ No newline at end of file diff --git a/docs/helios64/img/usb/otb_cable_usb_c.jpg b/docs/helios64/img/usb/otb_cable_usb_c.jpg new file mode 100644 index 0000000..21c4b75 Binary files /dev/null and b/docs/helios64/img/usb/otb_cable_usb_c.jpg differ diff --git a/docs/helios64/img/usb/usb_diagram.png b/docs/helios64/img/usb/usb_diagram.png new file mode 100644 index 0000000..5ece80d Binary files /dev/null and b/docs/helios64/img/usb/usb_diagram.png differ diff --git a/docs/helios64/img/usb/usb_mux.png b/docs/helios64/img/usb/usb_mux.png new file mode 100644 index 0000000..69c182d Binary files /dev/null and b/docs/helios64/img/usb/usb_mux.png differ diff --git a/docs/helios64/usb.md b/docs/helios64/usb.md new file mode 100644 index 0000000..8b7a165 --- /dev/null +++ b/docs/helios64/usb.md @@ -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 *** ----- + + + diff --git a/mkdocs.yml b/mkdocs.yml index e5ee27d..7f43e10 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,6 +79,7 @@ nav: - GPIO : 'helios64/gpio.md' - I2C : 'helios64/i2c.md' - LED : 'helios64/led.md' + - USB : 'helios64/usb.md' - Helios4: - Introduction: 'helios4/intro.md' - Kit Assembly: 'helios4/kit.md'