***********************************************
Release Notes:  Linux Image V2.x for Apalis TK1
***********************************************

Contents:
- U-Boot 2015.04 boot loader
- Linux 3.10.40 kernel, based on NVIDIA's Linux for Tegra (L4T) release R21.5
- Angstrom 2015.12/OpenEmbedded jethro/Yocto 2.0 based root file system, using
  LXDE desktop environment

==> Flashing instructions can be found on the Toradex developer article:
http://developer.toradex.com/knowledge-base/flashing-linux-on-tegra-modules

Licensing:
- proprietary multimedia codecs included for evaluation purpose only
- customer required to obtain proper re-distribution license

********************************************************************************
Linux Image V2.6.1 Beta 1 (September 29, 2016)

- U-Boot boot loader:
  - backport patches needed if compiling with GCC 6
  - add fdt_fixup environment variable as a hook to modify device tree
  - fix autoboot not prevented in recovery mode
  - add optional PCIe evalboard initialisation
- Linux kernel:
  - optimised RAM settings
  - allow easy integration of a custom Linux boot logo
  - backport patches needed if compiling with GCC 6
- Linux user-space:
  - use HDMI hotplug udev rule as well
  - deploy full mesa-demos in favour of segfaulting eglinfo-x11
  - configure LVDS in extended mode by default (#18669)
  - add udev rule to start an X output on HDMI hotplug
  - disable NVIDIA logo shown exlusively on LVDS
  - deploy additional gstreamer components namely for camera, vidconv and JPEG
    (#20394)
  - update OpenCV4Tegra to 2.4.12.3
  - improve fw_printenv/setenv concerning /etc/fw_env.config
- OpenEmbedded build system:
  - split meta-toradex into BSP layers meta-toradex-bsp-common and
    meta-toradex-tegra as well as the software layer meta-toradex-demos
  - rename the parent directory from stuff to layers
  - mv from build/out*/deploy to deploy
  - rename TMPDIR from out to tmp
  - deploy Qt5 tools into the sdk as part of optional angstrom-qt5-x11-image.bb
  - update to watatuki's meta-jetson-tk1 based on L4T R21.5

- sources git.toradex.com tag Apalis_TK1_LinuxImageV2.6.1Beta1_20160929
  - repository linux-toradex branch toradex_tk1_l4t_r21.5
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- power consumption under full load may exceed the carrier boards power budget
    see http://developer.toradex.com/products/apalis-tk1#errata for more infos
- License texts do not get deployed to the root file system.

********************************************************************************
Linux Image V2.6 Beta 2 (July 1, 2016)

- U-Boot boot loader:
  - first release
- Linux kernel:
  - first release
- Linux user-space:
  - first release
- OpenEmbedded build system:
  - integrate watatuki's meta-jetson-tk1 based on L4T R21.4
  - first release

- sources git.toradex.com tag Apalis_TK1_LinuxImageV2.6Beta2_20160701
  - repository linux-toradex branch toradex_tk1_l4t_r21.5
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- power consumption under full load may exceed the carrier boards power budget
    see http://developer.toradex.com/products/apalis-tk1#errata for more infos
- if no HDMI screen is connected pcmanfm will consume 100% CPU which can be
    worked around by removing '/usr/bin/xrandr --output LVDS-0 --off' line from
    /etc/xdg/lxsession/LXDE/autostart
- License texts do not get deployed to the root file system.

********************************************************************************
Notes:
- 115200 baud serial debug console on UARTA aka UART1 (EvalBoard lower X28 resp.
    X29 depending on JP10/12, X22 on Ixora) without any handshake
- user account: root with empty password
- eMMC: partition 1: vfat with kernel, partition 2 ext3 root file system
- opkg package manager
- HDMI aka DVI-D: not all pixel clock frequencies allow for HDMI audio
- Linux host used for update preparation requires proper 32-bit execution
    environment (e.g. install ia32-libs on 64-bit Ubuntu), awk and libusb
    (e.g. install gawk and libusb-1.0-0 on Ubuntu)

Working on latest image:
- U-Boot boot loader
  - environment storage in eMMC
  - Gigabit Ethernet
  - MMC/SD cards
  - eMMC flash
  - serial console debug UARTA aka UART1
  - Toradex Apalis configuration block handling
  - USB storage as host on USB host ports
  - USB device firmware upgrade (DFU) and USB mass storage (UMS) as device on USB OTG1 port
- Linux kernel
  - GPIOlib /sys/class/gpio
  - temperature sensor /sys/class/hwmon/hwmon{4|5}/temp1_input
  - RTC (Tegra internal and PMIC)
  - Gigabit Ethernet enpXs0, X being its PCIe bus number
  - eMMC ext3
  - serial console debug UARTA aka UART1 ttyS0
  - 4-bit MMC card mmc1 (full UHS-I support)
  - 4-bit SD card mmc2 (full UHS-I support, polled card detect)
  - PWM /sys/class/pwm/pwmchip0
  - HDMI HDA audio hw:1,3
  - analogue audio capture and playback hw:0,0
  - SPI via /dev/spidev0.0 aka SPI1 and /dev/spidev3.0 aka SPI2
  - framebuffer console
  - custom Ethernet MAC address
  - USB host port
  - USB audio driver
  - USB webcam
  - USB raw HID device /dev/hidrawX
  - USB device Ethernet RNDIS, provided by Android gadget
  - automatic USB device/host/suspend detection aka full OTG support
  - PCIe (regular ports and mini-PCIe slot)
  - SATA (regular port or mSATA slot)
  - DVFS power management including low-power core migration
  - single channel LVDS
- Linux user-space
  - graphics (HDMI-0 aka DVI-D and LVDS-0)
  - tegrastats
  - Firefox browser
  - Gstreamer 1.0 video encode and playback, independent dual 4K video decode
  - LXDE

Not working or not tested:
- U-Boot boot loader
  - U-Boot USB keyboard
- Linux kernel
  - RTC (board level I2C RTC)
  - high speed serial UARTB aka UART3, UARTC aka UART4 and UARTD aka UART2 ttyHSX
  - I2C via /dev/i2c-X
  - HDA audio (on Eval Board V1.0a: check datasheet/schematics for patch
      instructions)
  - resistive touch
  - serial number and board revision
  - watchdog
  - analogue inputs
  - CAN via can0 and can1
  - optional CSI2 camera interface
  - IrDA
  - RS-485
  - SIM card
  - suspend
  - USB 3.0 host on OTG port
- Linux user-space
  - GPIO config tool

******************************************************************************
Flashing instruction have been moved to the Toradex developer article:
http://developer.toradex.com/knowledge-base/flashing-linux-on-tegra-modules

Toradex, October 5, 2016