= Gateworks Newport Family Support = {{{ #!html

Getting Started
Newport Software
Peripherals
User Manuals

Wireless / WiFi Radios
Cellular Modems
GPS
3D Model
}}} [[PageOutline]] The Gateworks Newport product family utilizes the Cavium ARM ThunderX CN80xx / CN81xx SoC (System On Chip) offering a large variety of peripherals with a focus on Networking, and Security. See ​here for a product comparison matrix. = Links = '''Please note: This is a subset of information for Newport, however, please visit our [wiki:WikiStart Main Wiki] for all other information''' == Software == * [wiki:newport/bsp Gateworks Newport Board Support Package] * [#images Pre-built Firmware Images] * [wiki:newport/boot Newport Boot Firmware (up to and including the Bootloader)] * [wiki:newport/bootloader Newport U-Boot Bootloader] * [#linux Linux kernel support] * [#third-party-linux Booting Third Party Linux Distro's on Newport] * [#jtag Newport JTAG Programming] == Peripheral Support == * [wiki:ventana/expansion Gateworks Expansion Modules - GW16081, GW16082, GW16083] * [wiki:SPI SPI Support] * [wiki:I2C I2C Support] * [wiki:gpio/#gpiolib GPIO Control] * [wiki:gpio/#led_class LED Control] * [wiki:alternateconnectors Connector and Cable Information] * [wiki:sata mSATA Information] * [wiki:gps GPS Support] * [wiki:canbus CAN Bus Support] * [wiki:newport/PCIe PCI/PCIe information] * [wiki:minipciexpressmodules PCIe Accessory Cards] * [wiki:MMC MultiMediaCard (microSD/eMMC) Information] * [wiki:gsc Gateworks System Controller (GSC)] - Temperature, voltage, RTC, GPIO, Digital IO, I/O, pushbutton, etc * [wiki:enclosures Gateworks Enclosures] == Performance / Processor / Memory / Power / Thermal == * [wiki:newport/powerthermal Newport Power & Thermal] * [wiki:multicoreprocessing Multi Core Processing] * [wiki:boot_speed Increasing Boot Speeds] == Other Info == * [http://www.gateworks.com/product#newport Product Info] * [http://shop.gateworks.com Where to Buy] * [wiki:newport/orderoptions Newport Board Ordering Options] * [wiki:newport/errata Newport Board Errata] * [wiki:linux/devicetree Linux Kernel Device-Tree info] == All Gateworks newport pages [[TitleIndex(newport)]] == User Manual == * [http://www.gateworks.com/usermanuals All Gateworks User Manuals] == Processor Reference Manual / Datasheet / Errata == The ​[http://www.cavium.com/OCTEON-TX-CN80XX-81XX.html Cavium Website] contains details about the OCTEON TX Dual and Quad core 64bit ARM based SoC's. Additional references: * ​[http://www.cavium.com/pdfFiles/OCTEON-TX-CN80XX-CN81XX-Product-Brief-Rev1.pdf OCTEON TX CN80XX-CN81XX Product Brief] = Newport Ethernet = Newport supports 1GbE. If 10GbE support is needed, please email !sales@gateworks.com Newport Ethernet device mapping: ||= Board =||= Connector =||= Silkscreen =||= U-Boot =||= Linux =||= PoE =||= Phy =|| || GW640x || J21 || Eth#0 || vnic4 || eth4 / enp5s0f5 || 802.3af/at || RGMII DP83867IS || || J22 || Eth#1 || vnic0 || eth0 / enp5s0f1 || Passive 8-60V || QSGMII VSC8574 Port0 || || J22 || Eth#2 || vnic1 || eth1 / enp5s0f2 || None || QSGMII VSC8574 Port1 || || J22 || Eth#3 || vnic2 || eth2 / enp5s0f3 || None || QSGMII VSC8574 Port2 || || J22 || Eth#4 || vnic3 || eth3 / enp5s0f4 || None || QSGMII VSC8574 Port3 |||| || GW630x || J21 || Eth#1 || vnic1 || eth1 / enp5s0f2 || 802.3af/at || RGMII DP83867IS || || J20 || Eth#2 || vnic0 || eth0 / enp5s0f1 || Passive 8-60V || SGMII DP83867IS [=#firmware-version] = Firmware Versioning = You can determine the firmware version of various portions of the firmware by looking for banners on the serial console. For example: {{{#!bash Gateworks Newport SPL (ea21abc Tue Dec 12 23:42:48 UTC 2017) GSC : v49 0x832c WDT:disabled board temp:61C RTC : 0 Model : GW6304-B ... NOTICE: BL1: v1.3(release):OCTEONTX_SDK_6_2_0_build_26 NOTICE: BL1: Built : 15:30:07, Dec 4 2017 ... U-Boot 2017.09-rc1-00023-g1fd1415 (Dec 12 2017 - 15:42:30 -0800) for Cavium OcteonTX CN81XX ARM V8 Core ... [ 0.000000] Linux version 4.14.4-00005-g9e5958b (tharvey@tharvey) (gcc version 5.3.0 (Cavium Inc. Version 0.99 build 440)) #141 SMP PREEMPT Fri Dec 15 10:18:19 PST 2017 ... Ubuntu 16.04 LTS xenial-newport ttyAMA0 ... }}} - The above output shows you: * Secondary Program Loader (SPL) is 'ea21abc' built on Tue Dec 12 23:42:48 2017. The git sha of 'ea21abc'. * GSC v49 0x832c * ATF (ARM Trusted Firmware) is v1.3 built on Dec 4 2017. * U-Boot is '2017.09-rc1-00023-g1fd1415' built on Dec 12 2017. * Linux version 4.14.4-00005-g9e5958b built on Fri Dec 15 10:18:19 PST 2017 * Ubuntu 16.04 (aka xenial) OS (use {{{dpkg -l | grep "^ii"}}} to see what packages and versions are installed If you want more detail on the versions of the various components of the [wiki:newport/boot Boot Firmware] you can look at the {{{version}}} file created/placed by the Newport BSP Makefile in the FAT12 filesystem. See [wiki:newport/boot#version newport/boot/version] for details. [=#firmware-update] = Updating Firmware = This section provides instructions for updating both GSC firmware as well as boot device firmware. There are two methods for updating firmware: * on a live board using Serial Console and Ethernet ('''Note that currently the eMMC FLASH can only be updated on a live board booted from either eMMC or microSD''') * on removable storage (ie recovery microSD) * using a GW16099 JTAG dongle (see [#jtag below]) ('''Note that currently only the GSC firmware can be updated via JTAG''') The various items that can be updated: * GSC Firmware - currently only JTAG updates are supported for Newport - see [#jtag-gsc below] * Boot Firmware (Everything up to and including the Bootloader) - currently must be updated from U-Boot or Linux on a live system - see [#serial-ethernet below] * Root Filesystem (Operating System) - currently must be updated from U-Boot or Linux on a live system - see [#serial-ethernet below] [=#serial-ethernet] == Update Firmware via Serial Console and Ethernet == The quickest and easiest way to update your firmware is via Serial Console and Ethernet. You can do this either in the U-Boot bootloader (recommended) or within a Linux OS. If your primary boot device is corrupt, then you can boot via an alternate boot device (ie microSD) - see [#recovery newport/recovery] for details. [=#serial-ethernet-uboot] === Update Firmware via Serial Console and Ethernet from Bootloader === If updating firmware via !Bootloader/Serial/Ethernet (recommended for speed) you need to setup a TFTP server to host the files for transfer. Alternatively you could load firmware files from removable storage (microSD, mSATA, or USB for example) however the transfer rate is typically very slow compared to Gigabit Ethernet. For details on setting up a TFTP server see [wiki:tftpserver here]. The following instructions assume your board target IP address is 192.168.1.1 and you have a TFTP server at 192.168.1.146. Adjust environment according to your network via 'setenv ipaddr ' and 'setenv serverip '. Note that the {{{dev}}} variable needs to be set to the MMC device you are updating: * setenv dev 0 # boot device * setenv dev 1 # secondary device * use {{{mmc list}}} to see how they are configured The methods you use to update the firmware depends on what specifically you are trying to update. Update the entire device from a Compressed Disk Image ('[wiki:newport/boot boot firmware]' as well as OS): {{{#!bash setenv dev 0 # use 'mmc list' to show which device to use for eMMC vs microSD tftpboot ${loadaddr} xenial-newport.img.gz && gzwrite mmc ${dev} ${loadaddr} ${filesize} }}} - **If the image was created using a minimally sized filesystem you will want to resize it after booting to take advantage of the full partition space. For an {{{ext4}}} root filesystem on the primary MMC device run {{{resize2fs /dev/mmcblk0p2}}}.** To summarize: {{{#!bash setenv ipaddr 192.168.1.1 # sets device IP setenv serverip 192.168.1.146 # sets TFTP server IP setenv dev 0 # sets MMC device to be flashed tftpboot ${loadaddr} xenial-newport.img.gz && gzwrite mmc ${dev} ${loadaddr} ${filesize} # will flash xenial-newport.img.gz which resides in the top most directory of the TFTP server }}} Updating just the kernel can be done with {{{tftpboot}}} and {{{fatwrite}}}: {{{#!bash # kernel tftpboot $loadaddr kernel.itb && fatwrite mmc $dev:1 $loadaddr kernel.itb $filesize # bootscript tftpboot $loadaddr newport.scr && fatwrite mmc $dev:1 $loadaddr newport.scr $filesize }}} Updating the [wiki:newport/boot 'Boot firmware'] (everything up to and including the Bootloader): On a Newport booted to the bootloader: {{{#!bash mmc dev 0 # use 'mmc list' to show which device to use for eMMC vs microSD tftpboot ${loadaddr} firmware-newport.img && mmc write ${loadaddr} 0 8000 # update first 16MB mmc rescan # re-scan the mmc devices in case the partition table changed }}} Incorrect or out of date Boot Firmware may result in the analogue to digital conversion or registers being misinterpreted, in example: {{{#!bash GSC : v51 0x859f WDT:disabled board temp:3276C RTC : 0 Model : GW6300-B MFGDate : 12-13-2017 Serial : 757565 DTB : gw6300.dtb SoC : CN8020-850BG676-SCP-P12-G 1024KB 850/500MHz 0xa2 Pass 1.2 MMC0 : eMMC MMC1 : not detected Boot : eMMC non-trusted DRAM : 1024 MB, 1333 MT/s, DDR4 UDIMM J9 : PCI J10 : PCI J11 : PCI QLM0 : PCIE_1X1@5000MHz QLM1 : SGMII_1X1@1250MHz QLM2 : PCIE_1X1@5000MHz QLM3 : PCIE_1X1@5000MHz Serial : 2x RS232 without flow control PEM0 : QLM0 Link Timeout PEM1 : QLM2 Link Timeout PEM2 : QLM3 Link Timeout temp : 32765 - Failed High: 9000 vin : 7798784 - Failed High: 60000 3p3 : 137088 - Failed High: 3630 5p0 : 84481 - Failed High: 5500 0p9 : 107521 - Failed High: 990 core : 8782184 - Failed High: 946 1p2 : invalid 2p5 : invalid 1p0 : invalid 1p5 : invalid 1p8 : invalid anl : invalid }}} [=#serial-ethernet-linux] === Update Firmware via Serial Console and Ethernet from Linux === If booted to Linux on a board you can also update the kernel and bootscript fairly easily by mounting the FAT12 filesystem and copying the file(s): {{{#!bash mount /dev/mmcblk0p1 /mnt cp kernel.itb /mnt cp newport.scr /mnt }}} You can also easily update the [wiki:newport/boot 'Boot Firmware']. First prepare a boot image that contains your desired partition table, boot firmware, kernel, bootscript and U-Boot environment (see example above). Then on a booted Newport: {{{#!bash cd /tmp wget http://dev.gateworks.com/newport/boot_firmware/firmware-newport.img dd if=firmware-newport.img of=/dev/mmcblk0 }}} * Note above we are writing to {{{/dev/mmcblk0}}} and not a partition * Use {{{/dev/mmcblk1}}} for the secondary MMC device (ie microSD) * Note that Newport boards only supports MMC based boot devices * **Note that this overwrites the partition-table, the U-Boot environment, and the FAT12 filesystem which are things you might have customizations in.** Note that if you want to update the root filesystem itself from within Linux you can only do this by either: a) updating portions of the live filesystem that are not in use (ie package updates) b) booting to a kernel+ramdisk (ie [wiki:buildroot buildroot) and imaging the disk [=#recovery] == Creating a microSD recovery image == If your primary boot won't boot for some reason (ie, you corrupted it during development) you can boot from a microSD (see [#bootdevice here]). To create a bootable microSD meant for recovery purposes only needing the Bootloader you can use [http://dev.gateworks.com/newport/boot_firmware/firmware-newport.img firmware-newport.img]: * On a Linux host: {{{#!bash DEVICE=/dev/sdc # set to the microSD on your host sudo dd if=firmware-newport.img of=$DEVICE }}} - '''Be careful to set the DEVICE above to the device the microSD appears as on your Linux host - you do not want to overwrite part of your hosts filesystem''' * On a Newport board booted from eMMC from U-Boot: {{{#!bash mmc list # if booted from eMMC you should see microSD as dev 1 mmc dev 1 # select microSD tftpboot ${loadaddr} firmware-newport.img && mmc write ${loadaddr} 0 8000 }}} [=#jtag] == JTAG Programming == The Gateworks JTAG adapter (GW16099) is available in the Newport Dev Kit as well as on the Gateworks web store [http://shop.gateworks.com/index.php?route=product/category&path=70_80 here] All Newport boards have a 10-pin JTAG header which provides: * JTAG Programming for embedded FLASH - see [wiki:jtag_instructions here] for instructions * Serial Console access via UART0 (/dev/ttyAMA0) Please Note: * '''Linux software is supported for programming Newport (jtag_usbv4 required).''' Windows is not supported at this time.''' (serial console through Windows does work). * '''JTAG Programming of eMMC has not been made available yet'''. You must boot from a microSD image to program or re-program eMMC flash * '''JTAG Programming of the GSC firmware is supported by the most recent version of jtag_usbv4''' [http://svn.gateworks.com/jtag/linux/x86/jtag_usbv4 here] [=#jtag-gsc] === Update GSC Firmware via JTAG === To update the GSC firmware via JTAG download the {{{jtag_usbv4}}} application on a Linux x86 host from [http://svn.gateworks.com/jtag/linux/x86/jtag_usbv4 here] and execute as follows: {{{#!bash ./jtag_usbv4 -m gsc_630x_v49.txt }}} Note that the {{{ftdi_sio}}} kernel module must not be loaded (sudo rmmod ftdi_sio) and you may need to run this command as root by pre-pending a sudo depending on the configuration of your linux host. For more details please see: * [wiki:jtag Gateworks JTAG wiki page] [=#bootdevice] = Boot Device = Some boards have multiple boot device and may allow selection of which one is the 'primary boot device': ||= board =||= Primary Boot Device =||= Alternate Boot Device =|| || GW630x || on board eMMC || microSD || To boot from the alternate boot device manually you can press-and-release the user pushbutton 5 times in a row and the board will power cycle primary power (the 3.3V LED will go off, then on again) and the board will boot from the alternate boot device. Boards with an Alternate boot device also have a boot watchdog such that if the current boot device fails to boot within 30 seconds, the board will power cycle primary power and attempt boot from the other boot device. The bootloader also has a notion of boot device, either the built in eMMC or an external microSD. This is controlled through the UBoot variable 'dev'. The dev variable is purely for the bootloader, and does not signify what device to boot the kernel/rootfs from. Note if booting with the onboard eMMC as the primary boot device, “0/mmcblk0” is the U-Boot/Linux device node for eMMC and “1/mmcblk1” is the U-Boot/Linux device node for microSD. When booting from the alternate device (microSD) this is swapped. === Booting to a kernel/rootfs on the microSD === This assumes the bootloader will remain on the eMMC, but then we switch to the microSD for the kernel/rootfs. Run the following commands in the uboot bootloader command prompt on the Newport SBC serial console: #This tells the board to always get the bootloader from emmc, which is ok. {{{ setenv dev 0 }}} #now we are going to create a NEW script called boot_sd for booting from the microSD: #note the ext4load command grabs from 1:2, which means dev 1, which will be the microSD as long as you set #dev to 0 above (meaning dev 0 will be emmc, which will hold the bootloader, and then 1 would be the microSD) {{{ setenv boot_sd "ext4load mmc 1:2 ${kernel_addr} boot/${kernel} && setenv root '/dev/mmcblk0p2 rw rootwait' && run setargs && booti ${kernel_addr} - ${fdtcontroladdr}" }}} #now save everything {{{ saveenv }}} #now boot to microSD {{{ run boot_sd }}} If you want to then start doing this automatically everytime, you would look at the variable called boot_cmd. It currently uses the built in script we have to boot from mmc (which means emmc) {{{ GW6304-B> print bootcmd bootcmd=run boot_mmc }}} #if you want to modify this to boot from your new script: {{{ setenv bootcmd 'run boot_sd' saveenv reset }}} [=#bsp] = Board Support Packages (BSP) Software = {{{ #!html }}} == Choosing a BSP == Gateworks offers several Board Support Packages for the Newport Product family. Which one we recommend depends a bit upon what your goal is and what your experience level is. * [#Ubuntu Ubuntu] - '''Recommended for developers trying to heavily leverage opensource software packages or libraries that are not supported by the other BSP's. This is the most user-friendly for developers new to Embedded Linux but will not produce a very trimmed down filesystem image.''' - Uses mainline kernel. - Supports all Newport features. - Documentation provided to use Ubuntu pre-built packages and debootstrap to create a root filesystem in minutes - Native compilation: no SDK or cross-toolchain needed * [#openwrt OpenWrt] - intended for wireless routers and access points (low flash and memory footprint) - '''Recommended for networking users wanting to create a headless router, VPN, basestation, wireless access point and more. Produces by far the smallest storage and memory footprint but users new to Embedded Linux will have a bit of a learning curve''' - Fairly up-to-date and/or vanilla kernel support - Latest wireless drivers (via linux-backports) - Custom application config and init system (nice for small footprint, but can make adding support for additional packages more work) - Wide variety of packages (including a fairly nice web-admin) - Console-based build system (expect 60mins to build BSP for a specific board family) - Downloadable SDK and Toolchain available to build apps on a development host without building the entire BSP - easy firmware upgrade (sysupgrade) and factory-default reset mechanism - Pre-built images available == Newport BSP Software Support Comparison The following table shows details on current device support per BSP: ||= Feature =||= OpenWrt =||= Ubuntu =||= Notes =|| || Version || 18.0x || 16.04 (xenial) || || || Kernel || 4.14.x || 4.14.x || || || [wiki:serial#rs232 RS232] || Yes || Yes || || || [wiki:MMC MMC] || Yes || Yes || || || [wiki:SPI SPI] || Yes || Yes || 1 || [wiki:gps GPS / GPS PPS] || Yes || Yes || || || [wiki:gsc#rtc RTC] || Yes || Yes || || || [wiki:gsc#hwmon HWMON] || Yes || Yes || || || [wiki:gpio LED/GPIO] || Yes || Yes || || || [wiki:USB USB 3.0] || Yes || Yes || || || [wiki:newport/PCIe PCI] || Yes || Yes || || || [wiki:sata SATA] || Yes || Yes || || || [wiki:newport/crypto crypto] || Yes || Yes || 4 || || [wiki:canbus CAN] || Not yet || Not Yet || || || [wiki:serial#RS485 RS485] || Yes || Yes || 2 || [wiki:ventana/expansion] GW16081 || Not Yet || Not Yet || 3 || [wiki:ventana/expansion] GW16082 || Yes || Yes || 3 || [wiki:ventana/expansion] GW16083 || Not Yet || Not Yet || 3 1. SPI does not currently support full-duplex - issue is being investigated with Cavium 2. RS485 has not yet been fully validated but uses the same shared transceiver as RS232 which has been validated. RS485 half duplex mode would require adding support for TIOCSRS485 or managing the TXEN GPIO (gpio12) from userspace. 3. Requires a board with a Mezzanine connector. 4. HW Compression offload is supported (DEV_CAVIUM_ZIP drivers/crypto/cavium/zip.c) and crypto is supported (DEV_CAVIUM_CPT drivers/crypto/cavium) although there may be additional features that could be supported with additional driver work. [=#ubuntu] == Ubuntu == Gateworks offers a pre-built Ubuntu distribution using the latest Gateworks kernel as well as instructions on how to build your own Ubuntu based distribution. * [wiki:newport/ubuntu Newport Ubuntu Wiki and Software] [=#openwrt] == OpenWrt Board Support Package (BSP) == The Newport OpenWrt BSP provides the following: * Linux 4.x kernel (fairly vanilla) * latest wireless drivers (compat-wireless) * tuned for minimal FLASH/memory footprint (entire distro fits on embedded 16MB FLASH) * simple upgrades and factory-reset capability provided by overlay filesystem Newport OpenWrt BSP: * [http://dev.gateworks.com/newport/images/openwrt-newport.img.gz Pre-Built Image] (see [#firmware-update firmware-update] for instructions on how to install) * Source: * [https://github.com/Gateworks/bsp-newport] - Newport BSP support scripts and Makefile ([https://github.com/Gateworks/bsp-newport/subscription watch]) * [https://github.com/Gateworks/openwrt] - Gateworks OpenWrt BSP ([https://github.com/Gateworks/openwrt/subscription watch]) * Additional Gateworks OpenWrt pages:[[TitleIndex(OpenWrt)]] * join the [https://lists.openwrt.org/cgi-bin/mailman/listinfo/openwrt-devel openwrt-devel] mailing list to follow upstream OpenWrt activity [=#third_party_linux] = Third Party Linux Distros = While Gateworks cannot fully support all Linux distros, it is relatively simple to overlay a Gateworks Newport kernel onto any non-Gateworks third party Linux distro rootfs image. The following links will describe what is needed: 1. Linux kernel supporting Newport: [wiki:linux/kernel] 2. Root Filesystem: [#rootfs see below] 3. Bootable media: [wiki:linux/blockdev] [=#rootfs] === Root filesystem Sources === There are several sources of pre-built root filesystems that are compatible with Newport. As Newport uses an ARM 64bit based SoC, you need to use something that is compatible with an ARMv8 instruction set. Many pre-built distributions will reference 'arm64' which means 'ARM 64-bit' which is appropriate for the CN80XX / CN81XX SoC. Some popular third-party sources: * [http://cdimage.ubuntu.com/ubuntu-core/ Ubuntu Core] - this is a minimal filesystem that you can build off of at runtime by adding packages from various repositories. * [https://releases.linaro.org/ Linaro] - Linaro has several root filesystems including server, nano, developer, core, and ALIP. Each root filesystem will have different things installed for different purposes. Choose carefully which will work for you. Notes: * some root filesystems may require you to manually add a user before booting (ie Ubuntu Core) * the default Newport bootloader expects to find the Image in the /boot directory on the 2nd partition of type ext2/3/4 [=#mainline-linux] = Mainline Linux Kernel support = Gateworks actively participates in the development of the Linux kernel. Cavium licenses CPU core IP from ARM and the name they give the CPU core within the OCTEON-TX CN80XX / CN81XX is the Cavium 'ThunderX'. Therefore many of the peripheral drivers within the Linux kernel have 'thunderx' in their name and more often then not the 'OCTEON' name refers to the older OCTEON MIP64 core. The following table shows what OCTEON-TX CN80XX / CN81XX peripherals support is available in the mainline kernel starting from 4.13: ||= Feature =||= Support =||= Notes =|| || [wiki:multicoreprocessing SMP] || Yes || ARCH_THUNDER || || [wiki:serial] UART (SBSA) || Yes || SERIAL_AMBA_PL011 drivers/tty/serial/amba-pl011.c || || [wiki:watchdog] Watchdog (SBSA) || Yes || ARM_SBSA_WATCHDOG drivers/watchdog/sbsa_gwdt.c || || [wiki:I2C I2C] || Yes (4.9+) || I2C_THUNDERX drivers/i2c/busses/i2c-{octeon-core,thunderx-pcidrv}.c || || Networking BGX (SGMII) || Yes (4.2+) || THUNDER_NIC_BGX drivers/net/ethernet/cavium/thunder/thunder_bgx.c || || Networking RGX (RGMII) || Yes (4.9+) || THUNDER_NIC_RGX drivers/net/ethernet/cavium/thunder/thunder_xcv.c || || Networking MDIO (PHY) || Yes (4.6+) || MDIO_CAVIUM/MDIO_THUNDER drivers/net/phy/mdio-{cavium,thunder}.c || || PCI || Yes (4.6+) || PCI drivers/pci/host/pci-thunder-{ecam,pem}.c || || [wiki:SPI SPI] || Yes (4.9+) || SPI_THUNDERX drivers/spi/spi-thunderx.c || || [wiki:MMC] eMMC / microSD || Yes (4.12+) || MMC_CAVIUM_THUNDERX drivers/mmc/host/thunderx-mmc.c || || HW RNG (Hardware Random Number Generator) || Yes (4.9+) || HW_RANDOM_CAVIUM drivers/char/hw_random/cavium-rng*.c || || HW Compressions offload || Yes (4.12+) || DEV_CAVIUM_ZIP drivers/crypto/cavium/zip.c || || Crypto || Yes (4.11+) || DEV_CAVIUM_CPT drivers/crypto/cavium || || [wiki:gsc#rtc RTC] || Yes || RTC_DRV_DS1672 drivers/rtc/rtc-ds1672.c || || [wiki:gpio LED/GPIO] || Yes (4.14+) || GPIO_THUNDERX drivers/gpio/gpio-thunderx.c || || [wiki:USB USB 3.0] || Yes || USB_XHCI_PCI || || [wiki:sata mSATA] || Yes || SATA_AHCI || The following kernel configs should be enabled for the OCTEON-TX CN80XX / CN81XX: * SERIAL_AMBA_PL011 - ARM SBSA UART * MMC_CAVIUM_THUNDERX - MMC * EDAC_THUNDERX - Error Detection and Correction (works with 'edac-util' app from 'edac-utils' package) * GPIO_THUNDERX - General Purpose I/O * SPI_THUNDERX - SPI Controller * I2C_THUNDERX - I2C Controller * THUNDERX_NIC_VF - NIC virtual function * THUNDERX_NIC_PF - NIC physical function * THUNDERX_NIC_BGX - Network Controller (selects MDIO_CAVIUM/MDIO_THUNDER) * THUNDERX_NIC_RGX - RGMII Network Controller (selects MDIO_CAVIUM/MDIO_THUNDER) * MDIO_THUNDER (selected automatically by THUNDERX_NIC*) * MDIO_CAVIUM (selected automatically by THUNDERX_NIC*) * PCI_HOST_THUNDER_PEM - PCI host controller * PCI_HOST_THUNDER_ECAM - Enhanced Configuration Access Mechanism for PCIe memory mapped I/O * ARM_SBSA_WATCHDOG - ARMv8 Watchdog * CRYPTO_DEV_CAVIUM_ZIP - Hardware Compression / Decompression off-load * HW_RANDOM_CAVIUM - Hardware accelerated random number generator Note that there are many kernel drivers using the name 'Octeon' but they typically refer to a different chipset and the CN80XX / CN81XX have more in common with the Cavium 'ThunderX' architecture as that is the SoC core. For details on building a Linux kernel see [wiki:linux/kernel here]