Changes between Initial Version and Version 1 of ventana


Ignore:
Timestamp:
10/22/2017 05:28:45 AM (2 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ventana

    v1 v1  
     1= Gateworks Ventana 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/ventana#BoardSupportPackagesBSPSoftware"><img src="/raw-attachment/wiki/ventana/softwareicon.png" style="height:100px;"><br>Ventana 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/ventana#VideoAudioSupport"><img src="/raw-attachment/wiki/ventana/videoicon.png" style="height:100px;"><br>Video and Audio</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="/wiki/ventana#Peripherals"><img src="/raw-attachment/wiki/ventana/customizationicon.png" style="height:100px;"><br>Peripherals</a>
     22</td>
     23
     24<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     25<a href="http://www.gateworks.com/usermanuals"><img src="/raw-attachment/wiki/ventana/usermanualicon.png" style="height:100px;"><br>User Manuals</a>
     26</td>
     27</tr>
     28<tr>
     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"><img src="/raw-attachment/wiki/ventana/wirelessicon.png" style="height:100px;"><br>Wireless / WiFi Radios</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/wireless/modem"><img src="/raw-attachment/wiki/ventana/cellularicon.png" style="height:100px;"><br>Cellular Modems</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="/wiki/gps"><img src="/raw-attachment/wiki/WikiStart/gpsicon.png" style="height:100px;"><br>GPS</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://www.gateworks.com/3d"><img src="http://www.gateworks.com/images/products/gw51003d.gif" style="height:100px;"><br>3D Model</a>
     44</td>
     45
     46<td style="height:150px;padding:15px;border:0px solid black;border-collapse: collapse;horizontal-align:center;text-align:center;">
     47<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 Ventana Accessories</a>
     48</td>
     49
     50</tr>
     51</table>
     52}}}
     53
     54[[PageOutline]]
     55
     56The Gateworks Ventana product family utilizes the Freescale / NXP i.MX6 CPU offering a large variety of peripherals, especially focused on video and audio.  See [http://www.gateworks.com/product#ventana here] for a product comparison matrix.
     57
     58= Links =
     59'''Please note: This is a subset of information for Ventana, however, please visit our [wiki: Main Wiki] for all other information'''
     60
     61
     62== Software ==
     63 * [#BoardSupportPackagesBSPSoftware Ventana Board Support Packages and Operating Systems]
     64 * [wiki:ventana/bootloader Ventana Bootloader]
     65 * [wiki:ventana#MainlineLinuxKernelsupport Mainline Linux kernel support]
     66 * [wiki:ventana/encryption Ventana i.MX6 Encryption / Crypto (CAAM) Support]
     67 * [wiki:ventana#third_party_linux Booting Third Party Linux Distro's on Ventana]
     68 * [wiki:ventana/freescaleunittests Freescale Unit Tests]
     69 * [#jtag Ventana JTAG Programming]
     70 * Third Party Software
     71  * [wiki:eblast/intelligent-access-point Intelligent Access Points]
     72  * [wiki:eblast/androidsecuritycamera Security Camera Management]
     73  * [wiki:eblast/access-point-cloud-management Access Point Cloud Management]
     74
     75
     76== Video / Audio Support ==
     77Video is currently primarily supported in the Yocto BSP.
     78
     79==== Software ====
     80 This section is recommended for getting started with example commands for video and audio.
     81
     82 * [wiki:Yocto/gstreamer Ventana GStreamer Wiki ( Pipelines, etc )] - Software commands to use !Video/Audio, streaming, compositing and more.
     83
     84
     85==== Hardware ====
     86
     87 * [wiki:ventana/LVDS Ventana LVDS LCD Touchscreen Displays]
     88
     89 * [wiki:ventana/graphics Ventana Graphics Capabilities] - Resolution and HW acceleration, IPU, GPU, VPU
     90 * [wiki:ventana/codec Ventana Codecs] - Codec Licensing information
     91
     92 * [wiki:Yocto/Video_Out Ventana Video Output Wiki] - Hardware capabilities for Video Output
     93 * [wiki:Yocto/Video_In Ventana Video Input Wiki] - Hardware capabilities for Video Input
     94 * [wiki:ventana/audio Ventana Audio Wiki] - Hardware capabilities for Video Input
     95
     96 * [wiki:Yocto/gstreamer/latency Streaming Video Latency] - Measuring Latency while streaming
     97 * [wiki:ventana/hdmicamera HDMI Microscope Camera and LVDS LCD Demo]
     98
     99 * [wiki:ventana/breakoutadapters Audio / Video breakout Adapters]
     100
     101
     102
     103== Peripheral Support ==
     104 * [wiki:ventana/expansion Gateworks Expansion Modules - GW16081, GW16082, GW16083]
     105 * [wiki:ventana/DigitalIO Ventana off-board Digital IO Mappings]
     106 * [wiki:ventana/DigitalIO#I2Csupport I2C Support]
     107 * [wiki:SPI SPI Support]
     108 * [wiki:gpio#gpiolib GPIO Control]
     109 * [wiki:gpio#led_class LED Control]
     110 * [wiki:alternateconnectors Ventana Connector and Cable Information ]
     111 * [wiki:ventana/breakoutadapters Ventana Development Breakout Adapters for Video / Audio / GPIO]
     112 * [wiki:ventana/breakoutadapters Audio / Video breakout Adapters]
     113 * [wiki:ventana/ethernet Ventana Ethernet Performance]
     114 * [wiki:ventana/LVDS Ventana LVDS LCD Touchscreen Display]
     115 * [wiki:USB_OTG USB OTG Documentation]
     116 * [wiki:ventana/gw5200usb GW5200 USB]
     117 * [wiki:sata mSATA Information]
     118 * [wiki:gps GPS Support]
     119 * [wiki:canbus CAN Bus Support]
     120 * [wiki:wireless/bluetooth Bluetooth Support]
     121 * [wiki:ventana/PCIe PCI/PCIe information]
     122 * [wiki:minipciexpressmodules PCIe Accessory Cards]
     123 * [wiki:ventana/accelerometer Accelerometer and Magnetometer Information]
     124 * [wiki:ventana/simsd SIM and microSD Card Information]
     125 * [wiki:gsc Gateworks System Controller (GSC)] - Temperature, voltage, RTC, GPIO, Digital IO, I/O, pushbutton, etc
     126 * [wiki:enclosures Gateworks Ventana Enclosures]
     127
     128
     129== Performance / Processor / Memory / Power / Thermal ==
     130 * [wiki:DVFS Dynamic Voltage and Frequency Scaling]
     131 * [wiki:multicoreprocessing Multi Core Processing]
     132 * [wiki:ventana/devmem Ventana Memory Access]
     133 * [wiki:ventana/power Ventana Power (including Consumption, Protection, etc)]
     134 * [wiki:ventana/powerrails Ventana 3.3 and 5V rails]
     135 * [wiki:ventana/thermal Thermal and Temperature Information about Ventana]
     136 * [wiki:floatingpoint Ventana Floating Point]
     137 * [wiki:Yocto/gstreamer/latency Streaming Video Latency]
     138 * [wiki:ventana/memory Memory Information]
     139 * [wiki:boot_speed Increasing Boot Speeds]
     140
     141
     142== Other Info ==
     143 * [http://www.gateworks.com/product#ventana Product Info]
     144 * [http://shop.gateworks.com Where to Buy]
     145 * [wiki:ventana/errata Ventana Board Errata]
     146 * [wiki:ventana/withoutpcieswitch The GW5220]
     147 * [wiki:ventana/blockdiagram Ventana Functional Block Diagram]
     148 * [wiki:ventana5400demo Youtube Video w/Video Demonstration]
     149 * [wiki:linux/devicetree Linux Kernel Device-Tree info]
     150 * [wiki:ventana/devmem Direct Memory Access]
     151 * [wiki:ventana/orderoptions Ordering Options]
     152
     153
     154[=#jtag]
     155== JTAG Programming ==
     156The Gateworks JTAG dongle (GW16099) is available in the Ventana Dev Kit as well as on the Gateworks web store [http://shop.gateworks.com/index.php?route=product/category&path=70_80 here]
     157
     158All Ventana boards have a 10-pin JTAG header which provides:
     159 * JTAG Programming for NAND FLASH - see [wiki:jtag_instructions here] for instructions
     160 * Serial Console access via UART2 (/dev/ttymxc1)
     161
     162''' Please note, the Linux software is supported for programming Ventana (jtag_usbv4 required). Windows is not supported at this time.''' (serial console through Windows does work).
     163
     164
     165== User Manual ==
     166 * [http://www.gateworks.com/usermanuals All Ventana User Manuals]
     167
     168
     169== Processor Reference Manual / Datasheet / Errata ==
     170The [http://www.freescale.com/webapp/sps/site/taxonomy.jsp?nodeId=018rH3ZrDRB24A IMX6 product family] includes several System On Chip (SoC) designs. You can find the Technical Reference Manual (TRM) as well as the datasheets and other Freescale documenation at Freescales site:
     171 * Reference Manuals:
     172  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6DQRM.pdf IMX6 Dual/Quad Reference Manual (IMX6DQRM)]
     173  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6SDLRM.pdf IMX6 Solo/DualLite Reference Manual (IMX6DQRM)]
     174 * Datasheets:
     175  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6DQAEC.pdf IMX6 Dual/Quad Automotive Datasheet (IMX6DQAEC)]
     176  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6DQIEC.pdf IMX6 Dual/Quad Industrial Datasheet (IMX6DQIEC)]
     177  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6DQCEC.pdf IMX6 Dual/Quad Commercial Datasheet (IMX6DQCEC)]
     178  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6SDLAEC.pdf IMX6 Solo/DualLite Automotive Datasheet (IMX6SDLIEC)]
     179  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6SDLIEC.pdf IMX6 Solo/DualLite Industrial Datasheet (IMX6SDLIEC)]
     180  - [http://cache.freescale.com/files/32bit/doc/data_sheet/IMX6SDLCEC.pdf IMX6 Solo/DualLite Consumer Datasheet (IMX6SDLIEC)]
     181 * Errata:
     182  - [http://cache.freescale.com/files/32bit/doc/errata/IMX6DQCE.pdf IMX6 Dual/Quad Chip Errata]
     183  - [http://cache.freescale.com/files/32bit/doc/errata/IMX6SDLCE.pdf IMX6 Solo/DualLite Chip Errata]
     184
     185
     186----
     187----
     188[=#bsp]
     189= Board Support Packages (BSP) Software =
     190{{{
     191#!html
     192<img src="https://openwrt.org/.styles/img/openwrt-logo.png" style="height:50px;"><br>
     193<img src="http://www.yoctoproject.org/docs/current/yocto-project-qs/figures/yocto-project-transp.png" style="height:50px;">&nbsp;&nbsp;&nbsp;
     194<a href="http://trac.gateworks.com/wiki/ventana#AndroidBoardSupportPackageBSP"><img src="http://dev.gateworks.com/logos/android_vector.jpg" style="height:50px;"></a>
     195
     196<a href="http://trac.gateworks.com/wiki/ventana#BoardSupportPackagesBSPSoftware"><img src="http://dev.gateworks.com/logos/debianlogo.png" style="height:50px;"></a>
     197
     198<a href="http://trac.gateworks.com/wiki/ventana#BoardSupportPackagesBSPSoftware"><img src="http://dev.gateworks.com/logos/ubuntulogo.png" style="height:50px;"></a>
     199}}}
     200
     201
     202== Choosing a BSP ==
     203Gateworks offers several Board Support Packages for the Ventana Product family. Which one we recommend depends a bit upon what your goal is and what your experience level is
     204 * [#OpenWrtBoardSupportPackageBSP OpenWrt] - intended for wireless routers and access points (low flash and memory footprint)
     205  - '''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'''
     206  - Fairly up-to-date and/or vanilla kernel support
     207  - Latest wireless drivers (via linux-backports)
     208  - Custom application config and init system (nice for small footprint, but can make adding support for additional packages more work)
     209  - Wide variety of packages (including a fairly nice web-admin)
     210  - Console-based build system (expect 60mins to build BSP for a specific board family)
     211  - Downloadable SDK and Toolchain available to build apps on a development host without building the entire BSP
     212  - Pre-built images available '''(this is what ships by default on all Ventana boards except for the GW551x)'''
     213
     214 * [#YoctoBoardSupportPackageBSP Yocto] - Full-featured, recommended for video applications using gstreamer
     215  - '''Recommended for users needing graphics output (either GUI or raw Video) or Video encode/decode/transcode and streaming. Produces the most tailored install (conserving filesystem space) while still using standard Linux distro config and init system. Users new to Embedded Linux or !OpenEmbedded will have a bit of a learning curve'''
     216  - Uses downstream vendor kernel consisting of Freescale patches on top of an older 'long term support' (LTS) kernel plus Gateworks patches for Ventana support
     217  - Supports all Ventana features including those not available in mainline linux such as Video input and IMX6 VPU, GPU support
     218  - Latest wireless drivers (via linux-backports)
     219  - Wide variety of packages
     220  - More 'desktop-like' environment with sysvinit and optional X11, Qt, or Qte
     221  - Console-based build system ([wiki:ventana/OpenEmbedded OpenEmbedded]) (expect 2hours to build BSP for a specific board family)
     222  - Downloadable SDK and Toolchain available to build apps on a development host without building the entire BSP
     223  - Pre-built images available (via web-download with EULA)
     224
     225 * [#AndroidBoardSupportPackageBSP Android]
     226  - '''Recommended for users with existing Android application code/experience or starting from scratch and needing high-end GUI display and/or network framework to take advantage of Android's vast collection of APIs and frameworks. Users new to Android or Java will have a learning curve.'''
     227  - Uses downstream vendor kernel consisting of Freescale patches on top of an older 'long term support' (LTS) kernel plus Gateworks patches for Ventana support
     228  - Supports all Ventana features including those not available in mainline linux such as Video input and IMX6 VPU, GPU support
     229  - Console-based build system (expect 3hours to build BSP for a specific board family)
     230  - Downloadable IDE to build apps on a development host without building the entire BSP
     231  - Pre-built images available (via web-download with EULA)
     232 
     233 * [#Ubuntu Ubuntu] / [#Debian Debian]
     234  - '''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.'''
     235  - Uses downstream vendor kernel consisting of Freescale patches on top of an older 'long term support' (LTS) kernel plus Gateworks patches for Ventana support
     236  - Supports all Ventana features including those not available in mainline linux such as Video input and IMX6 VPU, GPU support
     237  - Documentation provided to use Ubuntu and Debian pre-built packages and debootstrap to create a root filesystem in minutes
     238  - Native compilation: no SDK or cross-toolchain needed
     239 
     240 * [wiki:windows/wec7 Windows Embedded Compact 7 (WEC7)]
     241   - For users who have an existing WEC app/program and they are not able to migrate to a Linux based OS above.
     242   - Provided by third-party: Adeneo
     243   - Support for GW54xx
     244
     245The following table may also help in choosing what BSP is right for you:
     246||= Feature            =||= [#yocto Yocto] =||= [#android Android] =||= [#openwrt OpenWrt] =||= [#ubuntu Ubuntu] =||= [#debian Debian] =||= WEC7  =||= Notes =||
     247|| Pre-built images     || Yes              || Yes                  || Yes                  || No                 || No                 || Yes     ||         ||
     248|| NAND supported       || Yes              || Yes                  || Yes                  || Yes                || Yes                || No      ||         ||
     249|| Storage Needed       || <256MB           || 2GB or larger        || <256MB               || 1GB or larger      || 1GB or larger      ||         || 1       ||
     250|| Build-System         || Yes              || Yes                  || Yes                  || No                 || No                 || No      || 2       ||               
     251|| Toolchain            || SDK/Native              || No                   || SDK                  || Native             || Native             ||         || 3       ||
     252|| GUI                  || X11/Qt/Qte       || Yes                  || No                   || Future             || Future             ||         || 4       ||
     253|| VPU/GPU              || Yes              || Yes                  || No                   || Yes                || Yes                ||         || 5       ||
     254|| Web-Admin            || No               || No                   || Yes                  || No                 || No                 ||         || 6       ||
     255Notes:
     256 1. Two pre-built images are available for Yocto (console which will fit on 256MB or larger and GUI which typically requires 1GB or larger). OpenWrt fits easily in 256MB. Ubuntu and Debian can technically fit in 256MB but once anything useful is added you will need additional storage. NAND flash images are available for Yocto, OpenWrt, and Android (requires 2GB FLASH).
     257 2. The Yocto, OpenWrt, and Android BSP's contain an integrated build-system. Debian and Ubuntu have step-by-step instructions on how to build an bootable system in 10 or so steps.
     258 3. The Yocto, and OpenWrt BSP's provide a downloadable SDK for cross-compiling applications on a development hosts. The Android SDK for building applications on a development host is provided by Google. For Debian and Ubuntu native development and compilation is supported.
     259 4. Details can be found on the Internet on how to build Xserver with hardware acceleration support for IMX6 although its a bit technical.
     260 5. For Yocto, Ubuntu and Debian GStreamer support with IMX6 IPU, GPU and VPU support is provided via gstreamer-imx plugins. Android has its own API's for video.
     261 6. OpenWrt is designed to be a wireless router and has an integrated web-admin for configuration and control.
     262
     263
     264== Ventana BSP Software Support Comparison ==
     265The following table shows details on device support per BSP:
     266||=Feature                         =||= [#yocto Yocto] =||= [#android Android] =||= [#android Android] =||= [#openwrt OpenWrt] =||= [#ubuntu Ubuntu] =||= [#debian Debian] =||= [=#wec7 Windows Embedded] =||= Notes =||
     267||Version                           || 1.8 (fido) / 2.3 (pyro)    || 5.1.1 (Lollipop) || 4.3 (Kitkat)           || r48868 2016-02-17  || 14.04 (trusty)     ||                    || WEC7                   || ||           
     268||Kernel                                              || 3.14.48 || 3.14|| 3.10.53   || 4.4.0 || 3.14.48 || 3.14.48 || -      ||   ||
     269||SMP                                                 || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || Yes       ||   ||
     270||Eth0 (fec)                                          || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || Yes       ||   ||
     271||Eth1 (igb/sky2)                                     || Yes     || Yes^^^6^^^ ||Yes^^^6^^^ || Yes     || Yes     || Yes     || No        ||   ||
     272||PCIe                                                || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     273||[wiki:wireless/wifi WiFi]                           || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        || 4 ||
     274||[wiki:wireless/modem Cellular]                      || Yes     || Future || Future    || Yes     || Yes     || Yes     || No        ||  ||
     275||[wiki:wireless/bluetooth Bluetooth (USB HCI)]       || Yes     || Yes || No        || Yes     || Yes     || Yes     || Yes       ||   ||
     276||[wiki:serial#uart RS232]                            || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     277||[wiki:serial#RS485 RS485]                           || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     278||[wiki:gps GPS ]                                     || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     279||[wiki:gps#pps GPS PPS time sync]                    || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     280||[wiki:ventana/accelerometer Accelerometer]          || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     281||[wiki:ventana/accelerometer Magnetometer]           || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     282||[wiki:ventana/simsd uSD]                            || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || Yes       ||   ||
     283||[wiki:gsc#rtc RTC]                                  || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        || 1 ||
     284||[wiki:gsc#hwmon HWMON]                              || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        || 1 ||
     285||[wiki:gpio LED/GPIO]                                || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     286||[wiki:canbus CAN bus]                               || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     287||USB 2.0                                             || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || Yes       ||   ||
     288||[wiki:USB_OTG USB OTG]                              || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || Yes (Host) ||   ||
     289||[wiki:DVFS]                                         || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     290||[wiki:sata mSATA]                                   || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        || 1 ||
     291||[wiki:ventana/encryption Crypto]                    || Yes     || Yes || Yes       || Yes  || Yes     || Yes     || No        || 3 ||
     292||[wiki:ventana/LVDS] Video Out                       || Yes     || Yes || Yes       || Yes  || Yes     || Yes     || Yes       ||   ||
     293||[wiki:ventana/audio Analog Audio In/Out]            || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     294||[wiki:Yocto/Video_In Analog Video In]               || Yes     || Yes || Yes       || Future  || Yes     || Yes     || No        || 2 ||
     295||[wiki:Yocto/Video_Out Analog Video Out]             || Yes     || Future || Future    || Future  || Yes     || Yes     || No        ||   ||
     296||[wiki:Yocto/Video_In Digital Video (HDMI) In]       || Yes     || Future || Future    || Future  || Yes     || Yes     || No        || 1 ||
     297||[wiki:Yocto/Video_Out Digital Video (HDMI) Out]     || Yes     || Yes || Yes       || Yes  || Yes     || Yes     || Yes       || 1 ||
     298||[wiki:ventana/audio Digital Audio (HDMI) In]        || Yes     || Future  || Future    || Future  || Yes     || Yes     || No        || 1 ||
     299||[wiki:ventana/audio Digital Audio (HDMI) Out]       || Yes     || Yes || Yes       || Yes  || Yes     || Yes     || No        || 1 ||
     300||[wiki:ventana/graphics#vpu Video Processing Unit]   || Yes     || Yes || Yes       || No      || Yes     || Yes     || No        ||   ||
     301||[wiki:ventana/graphics#gpu Graphics Processing Unit]|| Yes     || Yes || Yes       || No      || Yes     || Yes     || No        || 7 ||
     302||[wiki:ventana/expansion GW16082 (MiniPCIe Exp)]     || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     303||[wiki:ventana/expansion GW16083 (Ethernet Exp)]     || Yes     || Yes || Yes       || Yes     || Yes     || Yes     || No        ||   ||
     304
     305 1. If using a GW54xx, it requires GW54XX-B or later
     306 2. If using a GW54xx, it requires GW5400-C or later
     307 3. Requires binary Firmware module from Freescale
     308 4. !WiFi supported through Mini-PCIe radios purchased separately. ath10k driver and AP mode not supported on Android.
     309 5. Bluetooth supported through separately purchased modules. For example, see [http://shop.gateworks.com/index.php?route=product/product&path=70_74&product_id=172 here]
     310 6. eth1 on Android needs to be configured manually
     311 7. Vivante GPU support is fully supported in the Yocto and Android BSP's and partially supported in the Ubuntu and Debian BSP's when used with gstreamer-imx
     312
     313
     314[=#android]
     315== Android Board Support Package (BSP) ==
     316Gateworks supports Android 4.4.3 (aka 'Kitkat') and Android 4.3 (aka 'Jelly Bean'):
     317 * [wiki:Android Android OS Wiki]
     318
     319
     320[=#openwrt]
     321== OpenWrt Board Support Package (BSP) ==
     322Ventana OpenWrt BSP:
     323 * [wiki:ventana/openwrt#Step2.InstallingFirmware Pre-Built Binaries]
     324 * [wiki:ventana/openwrt Building/Installing OpenWrt w/ Gateworks Patches for the Ventana Family]
     325 * [wiki:OpenWrt Main OpenWrt Wiki Page]
     326 * [wiki:OpenWrt/SDK#VentanaNotes OpenWrt SDK Toolchain]
     327 * join the [http://www.gateworks.com/mailman/listinfo maillist] to follow activity
     328 * [wiki:OpenWrt/gpio GPIO and LED Configuration]
     329 * Trunk Revision Log: [http://trac.gateworks.com/log/openwrt/trunk]
     330 * Source Code: [source:openwrt http://trac.gateworks.com/browser/openwrt/trunk]
     331
     332The Ventana OpenWrt BSP provides the following differences from the Yocto BSP:
     333 * Linux 3.14.5 kernel (fairly vanilla)
     334 * latest wireless drivers (compat-wireless)
     335 * tuned for minimal FLASH/memory footprint (entire distro fits on embedded 16MB FLASH)
     336 * no driver support currently exists for the following Ventana devices:
     337  * Video In (requires vendor driver(s) to be ported up)
     338  * Video Out (Support for this is pending)
     339
     340
     341[=#yocto]
     342== Yocto Board Support Package (BSP) ==
     343Yocto Information:
     344 * [wiki:Yocto Yocto Wiki Page with more information]
     345
     346The Ventana Yocto BSP provides the following differences from the OpenWrt BSP:
     347 * Linux 3.14 kernel (Based on Freescale's Kernel)
     348 * more like standard linux 'desktop' distros (larger package support and community)
     349 * USB OTG driver support
     350 * mSATA driver support
     351 * Video Out driver support
     352 * Video Capture driver support
     353 * [wiki:ventana/bootloader#DIOconfiguration  hwconfig/GPIO/LED Configuration]
     354
     355
     356[=#ubuntu]
     357== Ubuntu ==
     358Gateworks offers a pre-built Ubuntu distribution using the latest Gateworks kernel with Freescale patches as well as instructions on how to build your own Ubuntu based distribution.
     359 * [wiki:ventana/ubuntu Ubuntu Wiki and Software]
     360
     361
     362[=#debian]
     363== Debian ==
     364Gateworks offers a Debian distribution using the latest Gateworks kernel with Freescale patches as well as instructions on how to build your own Debian based distribution.
     365 * [wiki:ventana/debian Debian Wiki and Software]
     366
     367
     368[=#wec7]
     369== Windows Embedded Compact 7 ( WEC7 ) ==
     370Gateworks offers a pre-built Windows Embedded Compact 7 (WEC7) disk image that supports the GW5400:
     371 * [wiki:windows/wec7 WEC7]
     372
     373
     374[=#third_party_linux]
     375= Third Party Linux Distros =
     376While Gateworks cannot fully support all Linux distros, it is relatively simple to overlay a Gateworks Ventana kernel onto any non-Gateworks third party Linux distro rootfs image.
     377
     378The following links will describe what is needed:
     379 1. Linux kernel supporting Ventana: [wiki:linux/kernel]
     380 2. Root Filesystem: [#rootfs see below]
     381 3. Bootable media: [wiki:linux/blockdev]
     382
     383[=#rootfs]
     384=== Root filesystem Sources ===
     385There are several sources of pre-built root filesystems that are compatible with Ventana. As Ventana uses an i.MX6 SoC, you need to use something that is compatible with an ARMv7 instruction set. Many pre-built distributions will reference 'armhf' which means 'ARM hard-float' which is appropriate for the i.MX6 as it has hardware floating-point.
     386
     387Some popular third-party sources:
     388 * [http://cdimage.ubuntu.com/ubuntu-core/releases/ Ubuntu Core] - this is a minimal filesystem that you can build off of at runtime by adding packages from various repositories.
     389 * [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.
     390
     391Notes:
     392 * some root filesystems may require you to manually add a user before booting (ie Ubuntu Core)
     393 * the default Ventana bootloader expects to find the uImage and dtbs in the /boot directory on the first partition of type ext2/3/4
     394
     395
     396[=#mainline-linux]
     397= Mainline Linux Kernel support =
     398Gateworks actively participates in the development of the Linux kernel and has been submitting support for Ventana and device support since the 3.15 kernel.
     399
     400The following table shows what Ventana/IMX6 peripherals support is available in the mainline kernel starting from its original merge in 3.15 up into of 4.6:
     401||= Feature                                          =||= Support =||= Notes =||
     402||[wiki:ventana Ventana] (GW51xx/GW52xx/GW53xx/GW54xx) || Yes (3.15) || ||
     403||[wiki:ventana Ventana] (GW551x)                      || Yes (4.2)  || ||
     404||[wiki:ventana Ventana] (GW552x)                      || Yes (3.18) || ||
     405||[wiki:ventana Ventana] (GW553x)                      || Yes (4.9)  || ||
     406||[wiki:ventana/expansion Ventana GW16081] (MiniPCIe Expansion)|| Yes       ||   ||
     407||[wiki:ventana/expansion Ventana GW16082] (MiniPCI Expansion)|| Yes       ||   ||
     408||[wiki:multicoreprocessing SMP]                      || Yes       ||         ||
     409||eth0 (fec)                                          || Yes       ||   ||
     410||eth1 (igb/sky2)                                     || Yes       ||   ||
     411||[wiki:serial] (RS232 / RS485 / GPS)                 || Yes       ||   ||
     412||[wiki:ventana/simsd microSD]                        || Yes       ||   ||
     413||[wiki:linux/ubi NAND]                               || Yes       ||   ||
     414||[wiki:gsc#rtc RTC]                                  || Yes       ||   ||
     415||[wiki:gpio LED/GPIO]                                || Yes       ||   ||
     416||[wiki:canbus CAN bus] (flexcan)                     || Yes       ||   ||
     417||USB 2.0                                             || Yes       ||   ||
     418||[wiki:USB_OTG USB OTG]                              || Yes       ||   ||
     419||[wiki:DVFS]                                         || Yes       ||   ||
     420||[wiki:ventana/PCIe PCIe]                            || Yes       ||   ||
     421||[wiki:sata mSATA]                                   || Yes       ||   ||
     422||[wiki:ventana/LVDS LVDS Video Out]                  || Yes       ||   ||
     423||[wiki:ventana/audio Analog Audio In/Out] (sgtl5000) || Yes       ||   ||
     424||[wiki:ventana/graphics#vpu Video Processing Unit] (coda)|| Yes (3.16)||   ||
     425||[wiki:Yocto/Video_Out HDMI Audio/Video Out]         || Yes (3.16)||   ||
     426||[wiki:ventana/encryption Crypto]                    || Yes (4.3) ||   ||
     427||[wiki:Yocto/Video_Out LVDS Video Out]               || Yes (4.4) ||   ||
     428||[wiki:ventana/graphics#gpu Graphics Processing Unit] (etnaviv)|| Yes (4.5) || ||
     429||[wiki:ventana/accelerometer FXOS8700 Acc / Mag]     || No        || 1 ||
     430||[wiki:gsc GSC] HWMON / Watchdog / Input             || No        || 1 ||
     431||[wiki:ventana/expansion GW16083 (Ethernet Exp)]     || No        || 1 ||
     432||[wiki:Yocto/Video_In IMX6 Video Capture] (ipu-csi)  || Yes (4.13) || 2 ||
     433||[wiki:Yocto/Video_In Analog Video In]               || Yes (4.13) || 2 ||
     434||[wiki:Yocto/Video_Out Analog Video Out (GW54xx)]    || No        ||   ||
     435||[wiki:Yocto/Video_In HDMI Audio / Video In]         || No        ||   ||
     436
     437Notes:
     438 1. Gateworks has mainline patches available that add this support (contact support@gateworks.com for info)
     439 2. IMX6 capture requires use of the media-ctl API
     440
     441Note-able IMX6 mainline support history:
     442 * 4.13:
     443  - added: IMX6 Video Capture support. Currently the ADV7180 (analog capture) is supported through the media-ctl API
     444 * 4.11:
     445  - '''fixed:''' occasional failure with UHS-I capable boards with DDR50 capable microSD cards showing 'mmc0: ddr50 tuning failed' ([https://git.kernel.org/pub/scm/linux/kernel/git/ulfh/mmc.git/commit/?h=fixes&id=9f327845358d3dd0d8a5a7a5436b0aa5c432e757 commit]). This was backported to stable kernels 4.10.13+, 4.9.25+, 4.4.64+
     446 * 4.9:
     447  - Gateworks Ventana support added: GW553x
     448 * 4.7:
     449  - '''Errata:''' MSI is no longer able to be disabled for IMX6 PCIe host controller which will cause any card/driver requiring legacy PCI interrupts (ie ath9k) to fail if enabled
     450 * 4.5:
     451  - IMX6 GPU support added (etnaviv) driver
     452  - '''fixed:''' GW54xx front panel USB VBUS Not enabled on power-up ([https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=70b6b438cc365d8d269339986e63ceb943e8d423 commit])
     453  - '''Errata:''' MSI is enabled for IMX6 PCIe host controller in imx_v6_v7_defconfig which will cause any card/driver requiring legacy PCI interrupts (ie ath9k) to fail if enabled
     454 * 4.4:
     455  - IMX6 LVDS support added
     456  - '''fixed:''' FEC Ethernet Device Tree Fix applied to resolve no ethernet on eth1 (Marvell sky2) on GW54xx/GW53xx when using Marvell PHY Driver (CONFIG_MARVELL_PHY/marvell.ko) ([https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/arch/arm/boot/dts/?id=3a35e470bc6bc4ce34c19c410ebbe4e3bbf0bafe commit]). This issue dates back to 3.15 when Ventana support was added. As a workaround you can also unload/blacklist the Marvell PHY driver (marvell.ko).
     457  - '''Errata:''' occasional failure with UHS-I capable boards with DDR50 capable microSD cards showing 'mmc0: ddr50 tuning failed'. This was fixed in the 4.11 kernel and was backported to stable kernels 4.10.13+, 4.9.25+, 4.4.64+
     458  - '''Errata:''' GW54xx front panel USB VBUS Not enabled on power-up. This requires a [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=70b6b438cc365d8d269339986e63ceb943e8d423 device-tree fixup] that went into 4.5
     459 * 4.3:
     460  - IMX6 crypto support added to caam driver
     461  - '''Errata:''' GW54xx front panel USB VBUS Not enabled on power-up. This requires a [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=70b6b438cc365d8d269339986e63ceb943e8d423 device-tree fixup] that went into 4.5
     462 * 4.2:
     463  - Gateworks Ventana support added: GW551x
     464  - '''Errata:''' GW54xx front panel USB VBUS Not enabled on power-up. This requires a [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=70b6b438cc365d8d269339986e63ceb943e8d423 device-tree fixup] that went into 4.5
     465 * 4.1:
     466  - '''Errata:''' GW54xx front panel USB VBUS Not enabled on power-up. This requires a [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=70b6b438cc365d8d269339986e63ceb943e8d423 device-tree fixup] that went into 4.5
     467 * 4.0:
     468  - '''Errata:''' GW54xx front panel USB VBUS Not enabled on power-up. This requires a [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=70b6b438cc365d8d269339986e63ceb943e8d423 device-tree fixup] that went into 4.5
     469 * 3.18:
     470  - Gateworks Ventana support added: GW552x
     471  - ipu_v3 Camera Sensor Interface (CSI) base framework added
     472 * 3.17:
     473  - IMX6 HDMI support added
     474 * 3.16:
     475  - hardware acceleration offload added (TSO, scatter/gather) to FEC driver providing large performance boost
     476  - Ventana LVDS support added
     477  - ipu_v3 driver moved from staging to drivers/gpu/ipu_v3 offering base IPU support
     478  - coda driver support for IMX6 VPU added to staging
     479 * 3.15:
     480  - Gateworks Ventana support added: GW51xx, GW52xx, GW53xx, GW54xx
     481
     482Note that the bulk of Ventana support was merged into mainline linux at 3.15 so patches for 3.15+ are typically fewer and smaller consisting of new boards or work-in-progress that has not been merged yet.
     483
     484For details on building a Ventana kernel see [wiki:linux/kernel here]