*************************************************
Release Notes:  Linux Image V2.x for Colibri iMX6
*************************************************

Contents:
- U-Boot 2015.04 boot loader
- Linux 3.14.28 kernel, based on Freescale's BSP release imx_3.14.28_1.0.0_ga
    and patches from Boundary Devices
- Angstrom 2015.06/OpenEmbedded fido/Yocto 1.8 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-imx6-modules

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

********************************************************************************
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
  - fix setup of I2C3
  - enable eMMC boot support commands (e.g. /dev/mmcblk0boot0)
  - enabled zero bootdelay check (allows entering U-Boot when bootdelay is 0)
  - move environment to the end of the eMMC boot area before the config block
  - enable crc32 verify support
- Linux kernel:
  - migrate to Linux 3.14.28 kernel, based on Freescale's BSP release imx_3.14.28_1.0.0_ga
  - automatic USB device/host detection using USBC_DET pin
  - changed Fusion multi touch event reporting to adhere to multitouch slot
- 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
  - fw_printenv/setenv: follow U-Boot environment move
  - updated Vivante binary graphics/multimedia drivers (some gstreamer plugins changed their names)
  - fix USB RNDIS operation (still racy due to networkd bug)
- OpenEmbedded build system:
  - local.conf: add Toradex source mirror as pre-mirror
- Update scripts:
  - Ethernet aka TFTP update: provide option to split rootfs output file
  - 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 Apalis_iMX6_LinuxImageV2.5Beta2_20151106
  - repository linux-toradex branch toradex_imx_3.14.28_1.0.0_ga
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- USB RNDIS is racy due to networkd bug
- some USB Thumb drivers don't work well in U-Boot
- 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
- on first boot the resizing process adversely affects system performance for
    the first few minutes until completed
- Display resolution can be set for some output configurations, set the U-Boot
    environment variable vidargs accordingly.
- X uses only the fb0 device
- Ethernet aka TFTP update requires manual splitting of the root.ext3 file
    which can be taken care of by the -c argument of our update.sh script.

********************************************************************************
Linux Image V2.4 Beta 1 (May 18, 2015)
- U-Boot:
  - update to U-Boot 2015.04
  - add generic Toradex config block handling, print exact product description,
    board revision and serial number to the console
  - 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)
  - add command to restore Toradex config block ("cfgblock create")
  - display the Toradex logo, output preference: env var 'panel' | HDMI | Parallel RGB
  - enabled gpio command line interface
  - enabled DFU and Mass Storage on USB client, currently slow performance
  - update procedure now searches for an image on SD card, USB Mass Storage, TFTP server
- Linux kernel:
  - added support for Analog Camera Module, requires dedicated device-tree
      imx6dl-colibri-cam-eval-v3
- Linux user-space:
  - 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
  - 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_iMX6_LinuxImageV2.4Beta1_20150518
  - repository linux-toradex branch toradex_imx_3.10.17_1.0.0_ga
  - repository u-boot-toradex branch 2015.04-toradex

Note:
- mount point names changed from /media/<block device name> to /media/<label>

Known Issues:
- some USB Thumb drivers don't work well in U-Boot
- 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
- on first boot the resizing process adversely affects system performance for
    the first few minutes until completed
- Display resolution can be set for some output configurations, set the U-Boot
    environment variable vidargs accordingly.
- X uses only the fb0 device
- flash_eth.img requires manual splitting of the root.ext3 file.
    see the colibri-imx6_bin/flash_eth.scr script
- Desktop integration of video playback uses wrong escaping, always plays
    fullscreen .local/share/applications/gst-launch.desktop

********************************************************************************
Linux Image V2.3 Beta 5 (December 19, 2014)
- U-Boot:
  - default to VGA on parallel RGB display (from full HD on DVI)
  - add additional version related environment variables to ease scripting
- Linux kernel:
  - remove some drivers unusable on Colibri iMX6
  - rename power-key to its correct function wake-up-key
- Linux user-space:
  - add eglinfo application
  - update X server to 1.14.7
  - /etc/machine-id: ensure it is saved non-volatile
- Update script
  - reduce rootfs partition size in the MBR to the available eMMC size
      to have a valid MBR

- sources git.toradex.com tag Colibri_iMX6_LinuxImageV2.3Beta5_20141219
  - repository linux-toradex branch toradex_imx_3.10.17_1.0.0_ga
  - repository u-boot-toradex branch 2014.04-toradex

Known Issues:
- 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
- on first boot the resizing process adversely affects system performance for
    the first few minutes until completed
- Display resolution can be set for some output configurations, set the U-Boot
    environment variable vidargs accordingly. Some vidargs_xx variables
    provided for reference.
- X uses only the fb0 device
- flash_eth.img requires manual splitting of the root.ext3 file.
    see the colibri-imx6_bin/flash_eth.scr script
- a serial getty is started on ttymxc1 in addition to ttymxc0
    to disable this permanently execute the following command on the module:
    systemctl disable serial-getty@ttymxc1.service

********************************************************************************
Linux Image V2.3 Beta 4 (November 13, 2014)
- U-Boot:
  - initial release
- Linux kernel:
  - initial release
- rootfs / oe-core:
  - initial release
  - uses ARMv7 hard-float Thumb2 builds (armv7at2hf-vfp-neon)
- sources git.toradex.com tag Colibri_iMX6_LinuxImageV2.3Beta4_20141113
  - repository linux-toradex branch toradex_imx_3.10.17_1.0.0_ga
  - repository u-boot-toradex branch 2014.04-toradex

Known Issues:
- 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
- on first boot the resizing process adversely affects system performance for
    the first few minutes until completed
- Display resolution can be set for some output configurations, set the U-Boot
    environment variable vidargs accordingly. Some vidargs_xx variables
    provided for reference.
- X uses only the fb0 device
- flash_eth.img requires manual splitting of the root.ext3 file.
    see the colibri-imx6_bin/flash_eth.scr script

********************************************************************************
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)
- 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) and awk (e.g. install
    gawk on Ubuntu)

Working on latest image:
- U-Boot boot loader
  - environment storage in eMMC
  - Ethernet
  - MMC/SD cards
  - eMMC flash
  - RAM size auto detection
  - serial console debug UARTA
  - Toradex Colibri configuration block handling
  - module type auto detection
  - USB storage as host on USB host port
  - framebuffer support
- Linux kernel
  - GPIOlib /sys/class/gpio
  - PWM LEDs /sys/class/leds/
  - temperature sensor CPU /sys/devices/virtual/thermal/thermal_zone0/temp
      board: /sys/devices/soc0/soc.1/2100000.aips-bus/21a4000.i2c/i2c-1/1-0041/stmpe-adc/iio:device0/in_temp8_raw
  - Ethernet
  - eMMC ext3
  - serial console debug UARTA
  - UARTB, UARTC
  - optional RS485
  - I2C via /dev/i2c-X
  - 4-bit SD card mmc1
  - framebuffer console
  - HDMI audio
  - analogue audio playback and capture, resistive touch
  - optional S/PDIF, disabled in device tree
  - SPI via /dev/spidev32766.0
  - CAN via flexcan can0 and can1, disabled in device tree
  - 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, disabled
  - analog input via IIO framework
  - optional parallel camera interface (imx6dl-colibri-cam-eval-v3.dtb)
  - DVFS power management
  - suspend LP1
  - watchdog
- Linux user-space
  - Firefox browser
  - Gstreamer playback
  - OpenGL
  - LXDE
  - resize rootfs partition to full eMMC capacity
- Display:
  - only first output used by X11
  - backlight PWM
  - dual output on HDMI and parallel RGB, HDMI 1920x1080, RGB 800x480
  - single output on EDT 7" Display
  - single output to analog RGB, aka VGA output
  - resolution setting through modedb string in kernel command line

Not working or not tested:
- U-Boot boot loader
  - USB device/host switching
- Linux kernel
  - automatic USB device/host detection aka OTG support
  - CAN via MCP2515
  - IrDA
  - RS-422

- Linux user-space
  - Gstreamer encoding (not tested)
  - GPIO config tool not available
- Display:
  - on some monitors HDMI EDID does not negotiate correct timings,
      adding/removing mxc_hdmi.only_cea=1 to the kernel command line may help
  - more than one framebuffer used as a X screen

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

Toradex, November 6, 2015