Changes between Initial Version and Version 1 of venice


Ignore:
Timestamp:
06/11/2020 09:17:41 PM (2 years ago)
Author:
Tim Harvey
Comment:

initial page

Legend:

Unmodified
Added
Removed
Modified
  • venice

    v1 v1  
     1= Gateworks Venice Family Support
     2
     3{{{
     4#!html
     5<table style="border:1px solid black;border-collapse: collapse;height:0px;">
     6
     7<tr>
     8<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     9<a href="/wiki/gettingstarted"><img src="/raw-attachment/wiki/ventana/gettingstarted.png" style="height:100px;"><br>Getting Started</a>
     10</td>
     11
     12<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     13<a href="/wiki/venice#software"><img src="/raw-attachment/wiki/ventana/softwareicon2.png" style="height:100px;"><br>Venice Software</a>
     14</td>
     15
     16<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     17<a href="/wiki/venice#PeripheralSupport"><img src="/raw-attachment/wiki/ventana/customizationicon.png" style="height:100px;"><br>Peripherals</a>
     18</td>
     19
     20<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     21<a href="http://www.gateworks.com/usermanuals"><img src="/raw-attachment/wiki/ventana/usermanualicon.png" style="height:100px;"><br>User Manuals</a>
     22</td>
     23</tr>
     24<tr>
     25
     26<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     27<a href="/wiki/wireless"><img src="/raw-attachment/wiki/ventana/wirelessicon2.png" style="height:100px;"><br>Wireless / WiFi Radios</a>
     28</td>
     29
     30<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     31<a href="/wiki/wireless/modem"><img src="/raw-attachment/wiki/ventana/cellularicon.png" style="height:100px;"><br>Cellular Modems</a>
     32</td>
     33
     34<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     35<a href="/wiki/gps"><img src="/raw-attachment/wiki/WikiStart/gpsicon.png" style="height:100px;"><br>GPS</a>
     36</td>
     37
     38<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     39<a href="http://www.gateworks.com/3d"><img src="http://www.gateworks.com/images/products/gw51003d.gif" style="height:100px;"><br>3D Model</a>
     40</td>
     41<!--
     42<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     43<a href="http://shop.gateworks.com/index.php?route=product/category&path=70_83"><img src="/raw-attachment/wiki/ventana/shoppingcart.png" style="height:100px;"><br>Shop Venice Accessories</a>
     44</td>-->
     45
     46</tr>
     47</table>
     48}}}
     49
     50[[PageOutline]]
     51
     52The Gateworks Venice product family utilizes the NXP i.MX8MM SoC (System On Chip) family offering a large variety of peripherals with a focus on Networking, Security, and Media. See ​[http://www.gateworks.com/product#ventana here] for a product comparison matrix.
     53
     54= Links
     55'''Please note: This is a subset of information for Venice, however, please visit our [wiki:WikiStart Main Wiki] for all other information'''
     56
     57== Software
     58 * [#software Software Section] - Bootloader, Boot Firmware, Operating Systems, Kernel, etc
     59
     60== Peripheral Support
     61 * Connector Pinouts - see [http://www.gateworks.com/usermanuals Hardware User Manual]
     62 * [wiki:alternateconnectors Connector and Cable Information]
     63 * [wiki:gettingstarted Serial Console Access]
     64 * [wiki:USB USB Support]
     65 * [wiki:SPI SPI Support]
     66 * [wiki:I2C I2C Support]
     67 * [wiki:gpio/#gpiolib GPIO Control]
     68 * [wiki:gpio/#led_class LED Control]
     69 * [wiki:sata mSATA Information]
     70 * [wiki:gps GPS Support]
     71 * [wiki:canbus CAN Bus Support]
     72 * [wiki:minipciexpressmodules PCIe Accessory Cards]
     73 * [wiki:MMC MultiMediaCard (microSD/eMMC) Information]
     74 * [wiki:gsc Gateworks System Controller (GSC)] - Temperature, voltage, RTC, GPIO, Digital IO, I/O, pushbutton, etc
     75 * [wiki:ventana/expansion Gateworks Expansion Modules - GW16081, GW16082, GW16083]
     76
     77
     78== Other Info
     79 * [http://www.gateworks.com/product#venice Product Info]
     80 * [http://shop.gateworks.com Where to Buy]
     81 * [wiki:venice/orderoptions Venice Board Ordering Options]
     82 * [wiki:venice/errata Venice Board Errata]
     83 * [wiki:linux/devicetree Linux Kernel Device-Tree info]
     84 * [wiki:eol End of Life - EOL Dates ]
     85
     86== User Manuals
     87 * [http://www.gateworks.com/usermanuals All Gateworks User Manuals]
     88
     89== Entire Raw Index of Venice Wiki Pages
     90
     91[[TitleIndex(venice)]]
     92
     93[=#software]
     94= Venice Software
     95
     96Venice Software is comprised of many pieces, including the following:
     97 * GSC (Gateworks System Controller) Firmware
     98 * Boot Firmware (ARM Trusted Firmware, DDR controller Firmware, U-Boot Bootloader)
     99 * Operating System (including kernel / rootfs)
     100
     101Ubuntu is pre-installed on all Venice boards before they ship.
     102
     103Please view the following links for the appropriate software section:
     104 * [#choosingsoftware Choosing an OS]
     105 * [wiki:venice/bsp#images Pre-built Software Images]
     106 * [wiki:venice/bsp Building & Compiling BSP (Board Support Package) Images] - This includes all the boot firmware & operating System
     107 * [wiki:/venice/firmware Venice Software Installation page]
     108 * [wiki:venice/bootloader Venice U-Boot Bootloader]
     109 * [wiki:venice/boot Venice Boot Firmware (up to and including the Bootloader)]
     110 * [wiki:gsc#GSCVersionHistory GSC Firmware]
     111 * [#linux Venice Mainline Linux kernel support]
     112 * [#third_party_linux Booting Third Party Linux Distro's on Venice]
     113 * [#jtag Venice JTAG Programming]
     114 * [wiki:venice/nativecompile Venice Native Compile Hello World Example]
     115 * [wiki:buildroot Buildroot Linux]
     116
     117[=#choosingsoftware]
     118== Choosing a BSP
     119Gateworks offers several Board Support Packages for the Venice Product family. Which one we recommend depends a bit upon what your goal is and what your experience level is. ** Note: By default Venice boards are pre-programmed with and Ubuntu root filesystem and Gateworks kernel. **
     120
     121 * [#Ubuntu Ubuntu]
     122  - '''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.'''
     123  - Able to use mainline kernel.
     124  - Supports all Venice features.
     125  - Documentation provided to use Ubuntu pre-built packages and debootstrap to create a root filesystem in minutes
     126  - Native compilation: no SDK or cross-toolchain needed
     127
     128 * [#buidlroot Buildroot] - intended for custom applications (low flash and memory footprint)
     129  - Fairly up-to-date and/or vanilla kernel support
     130  - Wide variety of packages (including a fairly nice web-admin)
     131  - Console-based build system
     132  - Downloadable SDK and Toolchain available to build apps on a development host without building the entire BSP
     133
     134
     135[=#ubuntu]
     136== Ubuntu ==
     137Gateworks offers a pre-built Ubuntu distribution using the latest Gateworks kernel as well as instructions on how to build your own Ubuntu based distribution.
     138 * [wiki:venice/ubuntu Venice Ubuntu Wiki and Software]
     139
     140
     141[=#third_party_linux]
     142= Third Party Linux Distros =
     143While Gateworks cannot fully support all Linux distros, it is relatively simple to overlay a Gateworks Venice kernel onto any non-Gateworks third party Linux distro rootfs image.
     144
     145The following links will describe what is needed:
     146 1. Linux kernel supporting Venice: [wiki:linux/kernel]
     147 2. Root Filesystem: [#rootfs see below]
     148 3. Bootable media: [wiki:linux/blockdev]
     149
     150
     151[=#rootfs]
     152=== Root filesystem Sources
     153There are several sources of pre-built root filesystems that are compatible with Venice. As Venice 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 i.MX8MM SoC.
     154
     155Some popular third-party sources:
     156 * [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.
     157 * [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.
     158
     159Notes:
     160 * some root filesystems may require you to manually add a user before booting (ie Ubuntu Core)
     161
     162[=#linux]
     163[=#mainline-linux]
     164= Mainline Linux Kernel support
     165Gateworks actively participates in the development of the Linux kernel.
     166
     167
     168== Mainline Linux Kernel support
     169Gateworks actively participates in the development of the Linux kernel.
     170
     171The following table shows what i.MX8MM support is available in the mainline kernel:
     172||= item =||= DT compatible =||= driver =||= kconfig =||= kernel =||
     173|| audio card || simple-audio-card || sound/soc/generic/simple-card.c || CONFIG_SND_SIMPLE_CARD || ||
     174|| mmc || fsl,imx7d-usdhc || drivers/mmc/host/sdhci-esdhc-imx.c || CONFIG_MMC_SDHCI_ESDHC_IMX || ||
     175|| sdma || fsl,imx7d-sdma || drivers/dma/imx-sdma.c || CONFIG_IMX_SDMA || ||
     176|| uart || fsl,imx6q-uart || imx-uart: drivers/tty/serial/imx.c || CONFIG_SERIAL_IMX || ||
     177|| ethernet || fsl,imx6sx-fec || fec: drivers/net/ethernet/freescale/fec_main.c || CONFIG_FEC || ||
     178|| i2c || fsl,imx21-i2c || drivers/i2c/busses/i2c-imx.c || CONFIG_I2C_IMX || ||
     179|| spi || fsl,imx51-ecspi || drivers/spi/spi-imx.c || CONFIG_SPI_IMX || ||
     180|| gpio || fsl,imx35-gpio || drivers/gpio/gpio-mxc.c || CONFIG_GPIO_MXC || ||
     181|| wdog || fsl,imx21-wdt || drivers/watchdog/imx2_wdt.c || CONFIG_IMX2_WDT || ||
     182|| pwm || fsl,imx27-pwm || drivers/pwm/pwm-imx27.c || CONFIG_PWM_IMX27 || ||
     183|| audio dai || fsl,imx8mq-sai || fsl-sai: sound/soc/fsl/fsl_sai.c || CONFIG_SND_SOC_FSL_SAI || 5.4 ||
     184|| caam || fsl,sec-v4.0 || drivers/crypto/caam/* || CONFIG_CRYPTO_DEV_FSL_CAAM || 5.6 ||
     185|| ddrc (Dyanmic Scaling for DDR controller) || fsl,imx8m-ddrc || drivers/devfreq/imx8m-ddrc.c || ARM_IMX8M_DDRC_DEVFREQ || 5.6 ||
     186|| thermal || fsl,imx8mm-tmu || drivers/thermal/imx8mm_thermal.c || IMX8MM_THERMAL || 5.7 ||
     187|| fspi (Flex SPI) || nxp,imx8mm-fspi || drivers/spi/spi-nxp-fspi.c || SPI_NXP_FLEXSPI || 5.7 ||
     188|| ||
     189|| usb || not yet upstream as of v5.7 - should not be a driver change just need USB PM enabled ||
     190|| pci || not yet upstream as of v5.7 - needs minor driver support PCIE PM ||
     191|| mipi dsi bridge || not yet upstream as of v5.7 ||
     192|| mipi csi bridge || not yet upstream as of v5.7 ||
     193|| vpu/hantro-g1 || not yet upstream as of v5.7 ||
     194
     195See also:
     196 * Prebuilt Venice Kernel: [http://dev.gateworks.com/venice/kernel/]
     197 * Building the Venice Kernel as part of the BSP: [wiki:venice/bsp#kernel]
     198 * Building a Mainline Kernel Wiki: [wiki:linux/kernel]