*************************************************
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 3 (December 15, 2015)
- U-Boot boot loader:
  - disable delete-null-pointer-checks compiler flag (needed on Tegras)
  - use is_cpu_type() to detect module type as relying on RAM size might fail on
    Colibri iMX6 if DCD is not yet updated to 64-bit DDR bus on Colibri iMX6DL
  - clear flags for special PHY modes on phy_reset() to fix Ethernet after
    rebooting from Linux
- Linux kernel:
  - enable RTL8192CU driver e.g. for LM006 USB Wi-Fi stick
  - fix power off by stop mode avoiding stack trace
- 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
- Update scripts:
  - move partconf setting to be done last to avoid any issues when migrating
      from V2.4

- sources git.toradex.com tag Colibri_iMX6_LinuxImageV2.5Beta3_20151215
  - 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.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
  - enabled zero bootdelay check (allows entering U-Boot when bootdelay is 0)
  - enable eMMC boot support commands (e.g. /dev/mmcblk0boot0)
  - boot U-Boot from the eMMC boot area (/dev/mmcblk0boot0)
  - 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
  - optional RS485 is not yet migrated
  - 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, notably mfw_v4lsink to imxv4l2sink)
  - 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 Colibri_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:
- When migrating from V2.4 sometimes the bootpartition gets not enabled
    resulting in the old bootloader being used. For a workaround see:
    http://developer.toradex.com/software-resources/arm-family/linux/linux/release-details?view=all&issue=14774
- 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
  - 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
  - automatic USB device/host detection aka OTG support
  - 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
  - CAN via MCP2515
  - IrDA
  - RS-422
  - optional RS485
- 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, December 17, 2015