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

Contents:
- U-Boot 2011.06 boot loader
- Linux 3.1.10 kernel, based on NVIDIA's Linux for Tegra (L4T) release 16-r3
- OpenEmbedded oe-core 2012.10 based root file system, using LXDE desktop environment

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

********************************************************************************
Linux Image V2.0 Beta 2 (August 19, 2013)
This updates u-boot and kernel to cope with the increased eMMC and changed T30
CPU SKU on Apalis T30 - 2GB V1.0c, Apalis T30 - 1GB V1.0a
- U-Boot:
  - eMMC and RAM size / offset detection
  - rename shell prompt to Apalis T30
- Linux kernel:
  - workaround limited CPU clock
  - provision for the Analogue Camera Module
  - v4l kernel drivers configured as kernel modules
- rootfs / oe-core:
  - update to latest git revision for kernel and u-boot
  - image added relevant v4l kernel modules plus v4l-utils

- sources git.toradex.com tag Apalis_T30_LinuxImageV2.0Beta2_20130816

Known Issues:
- We are in an early Beta state, not all functions are tested.
- If a a monitor is connected to DVI, the kernel sometime hangs when the 
  display controller DC1 is initialised. -> reboot required. 
- LVDS aka TFTLCD resolution hard-coded in kernel to full HD resolution, 
  comments with timings for other resolutions provided
- lxappearance is segfaulting upon start
- connecting an analogue mic to the on module codec resets the codec, so that 
  neither headphone out nor mic in works anymore. Workaround: Have mic 
  connected before boot or change the output source between DAC/LineIn
- certain low-speed USB devices might not get detected
- on first boot the resizing process adversely affects system performance for 
  the first few minutes until completed

********************************************************************************
Linux Image V2.0 Beta 1 (June 26, 2013)
- U-Boot:
  - initial integration
  - integrate NVIDIA partition table parsing incl. Toradex Apalis configuration block
  - adjust available amount of memory
  - activate DVI-D framebuffer console
  - increase CPU frequency at boot
  - decrease boot delay
  - fix overflow in HCD conversion
- Linux kernel:
  - hack to make newer SD cards work by adding a quirk for lack of 1.8v support
  - revise Ethernet MAC address assignment
  - fix PCIe AXI response decoding errors
  - fix PCIe reset issue
  - remove spurious tegra_aes_device
  - video4linux adv7180 and max9526 integration
  - fix PCIe by forcing GEN1 speed
  - set board local critical temperature to 95°C
  - hack to avoid 24 Hz mode in X resulting in no display at all
  - silence extensive HDMI HDA audio messages
- rootfs / oe-core:
  - update to latest git revision for kernel and u-boot
  - extend rootfs partition on eMMC to its full partition size on first boot
  - unified update procedure for all T20/T30
  - limit journal size
  - nv-binaries: update to L4T R16.3
  - added packages: gstreamer deinterlacer, scrot
  - lxterminal, florence: fix garbled titlebar

- sources git.toradex.com tag Apalis_T30_LinuxImageV2.0Beta1_20130626

Known Issues:
- We are in an early Beta state, not all functions are tested.
- If a a monitor is connected to DVI, the kernel sometime hangs when the 
  display controller DC1 is initialised. -> reboot required. 
- LVDS aka TFTLCD resolution hard-coded in kernel to full HD resolution, 
  comments with timings for other resolutions provided
- lxappearance is segfaulting upon start
- connecting an analogue mic to the on module codec resets the codec, so that 
  neither headphone out nor mic in works anymore. Workaround: Have mic 
  connected before boot or change the output source between DAC/LineIn
- certain low-speed USB devices might not get detected
- on first boot the resizing process adversely affects system performance for 
  the first few minutes until completed

********************************************************************************
Linux Image V2.0 Alpha 1 (March 15, 2013)
(ported form the Linux Image V2.0 Beta1 for Colibri T30)
- U-Boot:
  - first release
- Linux kernel:
  - first release
- oe-core:
  - first release
- sources git.toradex.com tag Apalis_T30_LinuxImageV2.0Alpha1_20130315

Known Issues:
- We are in an early Alpha state, not all functions are tested.
- If a a monitor is connected to DVI, the kernel sometime hangs when the 
  display controller DC1 is initialised. -> reboot required. 
- LVDS aka TFTLCD resolution hard-coded in kernel to full HD resolution, 
  comments with timings for other resolutions provided
- some windows have garbled titlebar, e.g. lxterminal
- lxappearance is segfaulting upon start
- Gigabit Ethernet MAC address hard-coded to 00:0e:c6:87:72:01
- stability issues on concurrent PCIe and SATA stress testing
- connecting an analog mic to the on module codec resets the codec, so that 
  neither headphone out nor mic in works anymore. Workaround: Have mic 
  connected before boot or change the output source between DAC/LineIn

********************************************************************************
Notes:
- 115200 baud serial debug console on UARTA aka UART1 (EvalBoard lower X28 resp. X29 depending on JP10/12) without any handshake
- user account: root with empty password
- ext3 root file system
- opkg package manager
- HDMI: not all pixel clock frequencies allow for HDMI audio
- CRT: the T30 internal video DAC output is unsupported by NVIDIA's L4T Linux SW stack
- Linux host used for recovery mode flashing requires proper 32-bit execution environment (e.g. install ia32-libs on 64-bit Ubuntu) and awk (e.g. install gawk on Ubuntu)

Working on latest image:
- U-Boot boot loader
  - environment storage in eMMC
  - ASIX based USB to Ethernet adapters
  - MMC/SD cards (only GPT partitioned)
  - eMMC flash with NVIDIA partition table parsing
  - serial console debug UARTA aka UART1
  - Toradex Apalis configuration block handling
  - USB storage as host
- Linux kernel
  - GPIOlib /sys/class/gpio (LVDS transmitter configuration)
  - temperature sensor /sys/bus/i2c/devices/4-004c
  - RTC (Tegra internal, PMIC and board level I2C RTC)
  - Gigabit Ethernet eth0
  - serial console debug UARTA aka UART1
  - high speed serial UARTB aka UART3, UARTC aka UART4 and UARTD aka UART2
  - I2C via /dev/i2c-X
  - 8-bit MMC card mmc1
  - 4-bit SD card mmc2
  - PWM LEDs /sys/class/leds/
  - HDMI 
 audio
  - HDA audio (on Eval Board V1.0a: check datasheet/schematics for patch instructions)
  - analog audio capture, playback and touch
    - audio noise is high, workaround is to set headphone volume to maximum and use the DAC volume
    - touch has some jitter
  - SPI via /dev/spidev0.0 aka SPI1 and /dev/spidev4.2 aka SPI2
  - framebuffer console
  - custom Ethernet MAC Address
  - serial number and board revision
  - 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
  - suspend LP1
  - CAN via can0 and can1
  - PCIe (regular ports and mini-PCIe slot)
  - SATA (regular port or mSATA slot
  - DVFS power management
  - parallel camera interface
- Linux user-space
  - graphics (LVDS-1 aka TFTLCD and HDMI-1 aka DVI-D)
  - tegrastats
  - Firefox
  - Gstreamer video encode and playback, dual full HD video decode
  - LXDE
  - tegrastats-gtk, CPU information visible in graphical environment
  - LVDS transmitter configuration (see lvds-dual-channel.sh resp. lvds-single-channel.sh)

Not working or not tested:
- U-Boot boot loader
  - U-Boot USB keyboard
  - Gigabit Ethernet
- Linux kernel
  - analog input AD0 .. AD3 not implemented
  - watchdog
  - IrDA
  - RS-422/485
  - SIM card
- Linux user-space
  - Adobe Flash not provided by L4T (and probably never will)
  - opkg package feeds don't seem to be usable
  - GPIO config tool missing Apalis MXM3 pin description integration

*********************************************************
eMMC Boot: Apalis T30 2GB V1.0a, V1.0b and V1.0c (Sample)
eMMC Boot: Apalis T30 1GB V1.0a (Sample)
*********************************************************

Initial Preparation:
- download and extract T30_LinuxImageVx.yz.tar.bz2 package with root permissions

Flash eMMC:
- EvalBoard V1.0a
  - connect USB micro A/B (X49) or USB B (X50) to development workstation using micro or regular USB cable
  - connect serial debug console to lower X28 or X29 using null modem RS-232 or regular USB cable
  - enter recovery mode:
    - Eboot (e.g. transitioning from WEC):
      - 115200 baud without any handshake
      - hold space key while applying power or resetting
      - press x to enter command mode
      - use 'reboot rcm' command
    - U-Boot (e.g. updating Embedded Linux):
      - 115200 baud without any handshake
      - apply power or reset
      - hit any key to stop auto booting
      - use 'enterrcm' command
  - for more information about recovery mode please consult Apalis T30 datasheet chapter 6
- run update.sh script

Boot from eMMC:
- EvalBoard V1.0a
- power cycle
- upon first boot post-install scripts are run which takes around 2 minutes, please be patient

Toradex, August 30, 2013