************************************************
Release Notes:  Linux Image V1.0 for Colibri T20
************************************************

Contents:
- U-Boot 2011.06 boot loader
- Linux 2.6.36.2 kernel
- OpenEmbedded 2011.03 based root file system, using LXDE desktop environment

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

Recent Changes:
- none, this version is identical to the previous beta version V1.0 beta 6

Linux Image V1.0 Beta 6 (March 23, 2012)
- integrated new LM95245 driver with improved accuracy (e.g. reports in milli-degrees)
- integrated watchdog support
- I2C stack fixes/optimisations
- MMC stack fixes/optimisations
- USB stack fixes/optimisations
- optional full HD only display manager to work around nv_omx_lvdsoverlaysink bug
- generic nvflash (e.g. able to flash WinCE as well as Linux)
- support mass production V1.2a modules
- SD boot with proper U-Boot environment
- nvgstplayer from L4T integration/Gstreamer with decodebin2 and typefindfunction
- updated Adobe Flash player (now able to play youtube HD videos)
- T20 specific wallpaper
- true 50 MHz SPI communication
- tegrastats-gtk, CPU information visible in graphical environment
- automatic USB device/host detection aka OTG support
- HDMI SPDIF audio fix

Linux Image V1.0 Beta 5 (January 26, 2012)
- USB full speed limiting (see usb_high_speed kernel command line argument)
- spidev driver on default SPI pins (SPI4) without explicit pull-up/downs
- GMI with multiplexed nPWE and RDnWR
- note about certain conflicting GPIO/pin usage on other carrier boards (e.g. MECS Tellurium and Protea)
- improved display/video performance, now capable of doing dual full HD video decode
- Ethernet detection fault fix
- MMC/SD and NAND performance optimisation, optionally support 8-bit SDHCI on HSMMC controller
  (requires custom carrier board)
- framebuffer console support
- USB raw HID device support enabled in kernel configuration (for easy Toradex Oak connection)
- updated ASIX driver to version 4.2.0 (Sep. 19, 2011)
- custom Ethernet MAC Address handling (see asix_mac kernel command line argument)
- performance optimisations
- Tegra internal RTC support (in addition to PMIC plus board level I2C RTC)
- machine ID changed to official Colibri T20 one formerly called Tegra 2 (http://www.arm.linux.org.uk/developer/machines/list.php?id=3323)
- U-Boot supporting environment storage in NAND flash, Ethernet, MMC/SD cards, NAND flash,
  RAM size auto detection, serial console, Toradex Colibri configuration block and USB storage as host
- serial number and board revision handling (see /proc/cpuinfo)
- LXDE

Linux Image V1.0 Beta 4 (September 26, 2011)
- GPIOConfig Toradex GPIO configuration tool V1.0 Beta 1
- optimised NAND timings
- 18-bit AC97 audio capture
- optional 18-bit audio playback (see commented out TEGRA_AC97_32BIT_PLAYBACK define in sound/soc/tegra/tegra_soc.h)
- USB webcam support
- optional webcam OpenCV integration (see http://developer.toradex.com/software-resources/arm-family/linux/linux-(colibri-t20)-know-how#OpenCV)
- optional boot from MMC/SD card support (see further below)
- optional silent Fastboot (e.g. no serial debug output on UARTA, see bin/fastboot_silent.bin)
- optional MECS Tellurium display and USB hub support (see commented out MECS_TELLURIUM define in arch/arm/mach-tegra/board-colibri_t20.h)

Linux Image V1.0 Beta 3 (August 8, 2011)
- kernel support for paging of anonymous memory (swap)
- 16-bit colour support to be more memory conscious
- TFTLCD aka VGA defaults to 640x480 @ 60 Hz (see /usr/lib/libnvodm_disp.so)
- software EDID support (see EDIDUpdate.pl and generate_edid)

Linux Image V1.0 Beta 2 (July 22, 2011)
- gnome-mount now supported
- AC97 audio playback
- ALSA amixer
- PWM back light automatically set through /etc/init.d/gdm

Linux Image V1.0 Beta 1 (July 7, 2011)
- GPIO and PWM support
- graphics TFTLCD with more hard coded resolutions: 320x240, 480x272, 640x480,
  720x480, 800x480, 848x480, 720x576, 800x600, 1024x600, 1024x768, 1024x768,
  1280x720, 1280x768, 1152x864, 1360x768, 1366x768, 1280x960, 1440x900,
  1280x1024, 1400x1050, 1680x1050, 1600x1200, 1920x1080, 1920x1200
- tegrastats
- HDMI SPDIF audio
- USB audio driver
- AC97 touch
- USB device Ethernet RNDIS gadget
- fixed MMC/SD card detection
- released Linux kernel source code
- Firefox with Adobe flash
- Gstreamer video playback

Notes:
- 115200 baud serial debug console on UARTA aka FFUART (lower X25 on EvalBoard, X13 on Iris) without any handshake
- user account: root with empty password
- currently YAFFS2 flash root file system, later initial RAM disk
- opkg package manager
- HDMI aka DVI-D supports HD resolutions only (e.g. 480p, 576p, 720p or 1080p)

Working:
- 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
  - Toradex Colibri configuration block handling
  - USB storage as host
- 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 YAFFS2
  - serial console debug UARTA
  - high speed serial UARTB and UARTD
  - I2C via /dev/i2c-X
  - MMC/SD card, optional 8-bit SDHCI
  - PWM
  - HDMI SPDIF audio
  - AC97 audio capture, playback and 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 gadget
  - automatic USB device/host detection aka OTG support
- Linux user-space
  - graphics (TFTLCD and HDMI, optional CRT)
  - tegrastats
  - Firefox with Adobe Flash player
  - Gstreamer video playback, dual full HD video decode
  - GPIO config tool
  - LXDE
  - tegrastats-gtk, CPU information visible in graphical environment

Not working:
- suspend
- power management
- analog input


*************************************************************************************************************************************************************
NAND Boot: Colibri T20 256MB V1.1b (Sample), Colibri T20 512MB V1.1c (Sample), Colibri T20 256MB V1.2a, Colibri T20 512MB V1.2a or Colibri T20 512MB IT V1.2a
*************************************************************************************************************************************************************

Initial Preparation:
- download and extract T20_LinuxImageVx.yz.tar.bz2 package

Flash NAND:
- connect USB micro A/B (X12) to development workstation using regular micro USB cable
- short pin 1-2 of JP1 on Iris for RECOVERY (other carrier boards see http://developer.toradex.com/hardware-resources/arm-family/colibri-module/colibri-recovery-mode)
- apply power or reset
- run update.sh script
- use -r 512 option for 512 MB RAM modules
- use -v V1_1 option for V1.1b or V1.1c modules

Boot from NAND:
- do no more short any pins of JP1 on Iris
- power cycle or reset


*****************************************************************************************************************************************************************************************************
SD Card Boot: Colibri T20 256MB V1.1b (Sample), Colibri T20 512MB V1.1c (Sample), Colibri T20 256MB V1.2a, Colibri T20 512MB V1.2a or Colibri T20 512MB IT V1.2a on Iris Pico ITX Carrier Board V1.1a
*****************************************************************************************************************************************************************************************************

Initial Preparation:
- populate 100 ohm resistors R109, R111, R112 and R113 close to micro SD card holder (X10, see bottom assembly drawing fig.7 page 21 of Iris data sheet)
- populate boot mode header (JP1)
- insert micro SD card into micro SD card holder (X10)
- download and extract T20_LinuxImageVx.yz.tar.bz2 package

Flash SD Card:
- connect USB micro A/B (X12) to development workstation using regular micro USB cable
- short all 3 pins of JP1 for RECOVERY and SD_BOOT
- apply power or reset
- run update.sh script with -b hsmmc option
- use -r 512 option for 512 MB RAM modules
- use -v V1_1 option for V1.1b or V1.1c modules

Boot from SD Card:
- short pin 2-3 of JP1 for SD_BOOT
- power cycle or reset

Toradex, May 3, 2012