*********************************************************
Release Notes:  Embedded Linux BSP V2.4ff for Colibri T20
*********************************************************

==> For newer images find the release details in the Toradex developer article:
http://developer.toradex.com/software/linux/linux-software/release-details

Contents:
- U-Boot 2016.11 boot loader
- Linux 3.1.10 kernel, based on NVIDIA's Linux for Tegra (L4T) release R16.5
- Angstrom 2016.12/OpenEmbedded morty/Yocto 2.2 based root file system, using
    LXDE desktop environment

==> Flashing instructions can be found in 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
  - add mem alloc for bmp colour conversion map
- Linux kernel:
  - fix unsupported HDMI screen crash
  - allow more HDMI aspect ratios
  - backport patches needed if compiling with GCC 6
- Linux user-space:
  - 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
  - download binary blobs for trdx-nv-binaries

- sources git.toradex.com tag Colibri_T20_LinuxImageV2.6.1Beta1_20160929
  - repository linux-toradex branch tegra
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- License texts do not get deployed to the root file system.

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

- U-Boot boot loader:
  - read kernel and device tree from static UBI volumes
  - net: increase maximum frame size to accommodate VLAN packets
  - update: make set<media>update self contained
- Linux kernel:
  - Epson S2D13P04 analogue multi-camera decoder integration
  - mmc: host: sdhci: fix suspend/resume issue
  - mmc: sdhci: handle command timeout after transfer complete interrupt
- Linux user-space:
  - trdx-extra.inc: add iperf3 to all images
  - florence: update to latest version 0.5.4, build without sound and drop
    gstreamer 0.10 dependency
  - gpioconfig: fix pkg_postrm
- OpenEmbedded build system:
  - further clean-up update.sh update script
  - angstrom-qt5-x11-image: add a recipe which deploys qt5 and starts a demo

- sources git.toradex.com tag Colibri_T20_LinuxImageV2.6Beta2_20160701
  - repository linux-toradex branch tegra
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- License texts do not get deployed to the root file system.

********************************************************************************
Linux Image V2.6 Beta 1 (March 31, 2016)

- U-Boot boot loader:
  - no Tegra specific changes
- Linux kernel:
  - synchronise USB serial options
  - kernel: add support for gcc 5
  - rtl8192cu: add new device IDs
- Linux user-space:
  - xserver-xorg: Fix build with GCC 5
  - bblayers.conf: angstrom now depends on meta-qt5
  - gstreamer: fix argument parsing when using Bison 3
- OpenEmbedded build system:
  - update OpenEmbedded from fido to jethro:
    - Firefox 38.2.1esr
    - gcc Linaro GCC 5.2-2015.11-2
    - glibc 2.22
    - systemd 226
    - Xorg 1.14.7 (not upgraded due to L4T dependency)

- sources git.toradex.com tag Colibri_T20_LinuxImageV2.6Beta1_20160331
  - repository linux-toradex branch tegra
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- License text do not get deployed to the root file system.

********************************************************************************
Linux Image V2.5 Beta 3 (December 15, 2015)
- U-Boot boot loader:
  - disable delete-null-pointer-checks compiler flag fixing memory test crashes
- Linux kernel:
  - enable RTL8192CU driver e.g. for LM006 USB Wi-Fi stick
  - add multitouch HID support
  - ADV7280 V4L2 integration e.g. for new Toradex ACA V2.x (formerly ACM)
- Linux user-space:
  - make sure USB RNDIS Gadget is started before networkd
  - use new Toradex feed server as default feed URI
- OpenEmbedded build system:
  - fix memcpy.patch to apply to Linaro layer and openembedded layer glibc
  - remove create_configblock.sh from deployment tarball
  - add rtl8192cu firmware for LM006 USB Wi-Fi adapter
  - add README with dependency and contribution information
  - backport rtl8192cx for latest available firmware

- sources git.toradex.com tag Colibri_T20_LinuxImageV2.5Beta3_20151215
  - repository linux-toradex branch tegra
  - repository u-boot-toradex branch 2015.04-toradex

Note:
- no SD boot integration yet but copying cbootimage to beginning of SD card
  will at least boot

Known Issues:
- LP1 suspend might fail due to pending USB interrupts
- LP1 suspend might hang due to display controller issue

********************************************************************************
Linux Image V2.5 Beta 2 (November 6, 2015)
- U-Boot boot loader:
  - add return code for cfgblock commands which allows scripting
  - increase TFTP blocksize for better performance
  - implement early pmic rail configuration
  - various UBI/Fastmap fixes
  - enabled zero bootdelay check (allows entering U-Boot when bootdelay is 0)
- Linux kernel:
  - improve PMIC RTC accuracy
  - integrate ASIX USB-to-Ethernet driver 4.17.0
  - prevent rare boot lock-up
  - changed Fusion multi touch event reporting to adhere to multitouch slot
  - fix HS UART HW buffer overrun issue
- Linux user-space:
  - updated to latest Angstrom 2015.06/OpenEmbedded fido:
    - glibc 2.22
    - systemd 219
    - Xorg 1.16.1
  - glibc: force memcpy_arm to improve memcpy performance
  - fix USB RNDIS operation
- OpenEmbedded build system:
  - change default tune to Thumb-2
  - local.conf: add Toradex source mirror as pre-mirror
- Update scripts:
  - update.sh: delete intermediate files after use
  - improved update.sh to use module type specific folders allowing update of
    different modules with just one update media

- sources git.toradex.com tag Colibri_T20_LinuxImageV2.5Beta2_20151106
  - repository linux-toradex branch tegra
  - repository u-boot-toradex branch 2015.04-toradex

Note:
- no SD boot integration yet but copying cbootimage to beginning of SD card
  will at least boot

Known Issues:
- LP1 suspend might fail due to pending USB interrupts
- LP1 suspend might hang due to display controller issue

********************************************************************************
Linux Image V2.4 Beta 1 (May 18, 2015)
- U-Boot:
  - update to U-Boot 2015.04
  - new partition layout
  - cbootimage/tegrarcm based update concept
  - new NAND BCH ECC configuration able to fix up to 16 errors per 512 bytes
  - enable ONFI detection, allows to retrieve more details about the NAND chip
  - adjust config block and U-Boot environment locations in flash
  - add generic Toradex config block handling, print exact product description,
    board revision and serial number to the console
  - add command to restore Toradex config block ("cfgblock create")
  - add parallel RGB display support, display the Toradex logo and debug
    console at VGA resolution by default
  - optionally create device-tree properties which make board information
    available from within Linux userspace through procfs (/proc/device-tree/
    serial-number, toradex,board-rev and toradex,product-id)
- Linux kernel:
  - enable module versioning support
  - fix/improve optional 1-wire driver
  - update MTD/UBI/UBIFS subsystem (infradead.org ubifs-v3.1 backport)
  - new NAND BCH ECC configuration able to fix up to 16 errors per 512 bytes
  - SPI driver fix number of words in transfer
  - cleaned-up module configuration/deployment
- Linux user-space:
  - migrate from YAFFS2 to UBIFS
  - update OpenEmbedded from daisy to dizzy:
    - glibc 2.20 (instead of eglibc)
    - systemd 2.18
    - Xorg 1.14.7
    - updated various LXDE packages to newer versions
  - build tegrarcm using static cryptopp library to avoid issues e.g. on 64-bit
    Fedora
  - replace full NTP daemon with systemd's NTP client only systemd-timesyncd
  - blacklist USB RNDIS for connman, use systemd-networkd to configure RDNIS
    network interface (new standard IP of the module is 192.168.11.1!)
  - enable BusyBox resize command to resize the terminal on serial console

- sources git.toradex.com tag Colibri_T20_LinuxImageV2.4Beta1_20150518
  - repository linux-toradex branch tegra
  - repository u-boot-toradex branch 2015.04-toradex

Note:
- mount point names changed from /media/<block device name> to /media<label>
- no SD boot integration yet but copying cbootimage to beginning of SD card
  will at least boot

Known Issues:
- LP1 suspend might fail due to pending USB interrupts
- LP1 suspend might hang due to display controller issue

********************************************************************************
Notes:
- 115200 baud serial debug console on UARTA aka FFUART (lower X25 on EvalBoards
  resp. X27 on V3.1a depending on JP17/19, X13 on Iris) without any handshake
- user account: root with empty password
- UBIFS flash root file system
- opkg package manager
- HDMI aka DVI-D: not all pixel clock frequencies allow for HDMI audio
- CRT: the T20 internal video DAC output is unsupported by NVIDIA's L4T Linux SW
       stack
- 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 NAND flash or on MMC/SD card
  - Ethernet
  - MMC/SD cards
  - NAND flash
  - RAM size auto detection
  - serial console debug UARTA
  - Toradex Colibri configuration block handling
  - USB storage as host on USB host port
  - USB device firmware upgrade (DFU) as device on USB OTG port
  - TFTLCD framebuffer support
- Linux kernel
  - GPIOlib /sys/class/gpio
  - temperature sensor /sys/bus/i2c/devices/4-004c
  - RTC (Tegra internal, PMIC and board level I2C RTC)
  - Ethernet eth0
  - NAND flash MTD/UBI/UBIFS with 16-bit hardware BCH ECC per 512 bytes
  - serial console debug UARTA ttyS0
  - high speed serial UARTB and UARTD ttyHSX
  - I2C via /dev/i2c-X
  - MMC/SD card, optional 8-bit SDHCI
  - PWM LEDs /sys/class/leds/
  - HDMI SPDIF audio
  - AC97 analogue audio capture, playback and resistive touch
  - SPI via /dev/spidev3.0
  - GMI with multiplexed nPWE and RDnWR
  - framebuffer console
  - custom Ethernet MAC address
  - serial number and board revision
  - watchdog
  - 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 detection aka OTG support
  - analogue inputs AD0, AD1 /sys/class/power_supply/colibri_t20-analog_inputs
  - suspend LP1
  - DVFS power management
  - optional parallel camera interface
- Linux user-space
  - graphics (LVDS-1 aka TFTLCD and HDMI-1 aka DVI-D)
  - tegrastats
  - Firefox browser
  - Gstreamer 0.10 video encode and playback, independent dual full HD video
    decode
  - GPIO config tool
  - LXDE
  - tegrastats-gtk, CPU information visible in graphical environment

Not working or not tested:
- U-Boot USB keyboard
- Linux kernel
  - IrDA
  - RS-485
- Linux user-space Adobe Flash not provided by L4T (and probably never will)

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

Toradex, April 19, 2017