From 0fa0d34b8079f9e962d27d3e014da37997141863 Mon Sep 17 00:00:00 2001
From: Marcel Ziswiler <marcel.ziswiler@toradex.com>
Date: Tue, 19 May 2015 18:03:38 +0200
Subject: updated release notes

---
 release-notes/Colibri_VF_LinuxReleaseNotesV2.x.txt | 206 ++++++++-------------
 1 file changed, 80 insertions(+), 126 deletions(-)

(limited to 'release-notes/Colibri_VF_LinuxReleaseNotesV2.x.txt')

diff --git a/release-notes/Colibri_VF_LinuxReleaseNotesV2.x.txt b/release-notes/Colibri_VF_LinuxReleaseNotesV2.x.txt
index 8c34594..4085223 100644
--- a/release-notes/Colibri_VF_LinuxReleaseNotesV2.x.txt
+++ b/release-notes/Colibri_VF_LinuxReleaseNotesV2.x.txt
@@ -3,12 +3,83 @@ Release Notes:  Linux Image V2.x for Colibri VF50/VF61
 ******************************************************
 
 Contents:
-- U-Boot 2014.10 boot loader
-- Linux 3.18.5 kernel
-- Angstrom/OpenEmbedded/Yocto 2014.06/daisy/1.6 based root file system, using
+- U-Boot 2015.04 boot loader
+- Linux 4.0.2 kernel
+- Angstrom/OpenEmbedded/Yocto 2014.12/dizzy/1.7 based root file system, using
   LXDE desktop environment
 
-==> Flashing instructions can be found at the very bottom of this release notes
+==> Flashing instructions can be found on the Toradex developer article:
+http://developer.toradex.com/knowledge-base/flashing-linux-on-vybrid-modules
+
+********************************************************************************
+Linux Image V2.4 Beta 1 (May 18, 2015)
+- U-Boot:
+  - update to U-Boot 2015.04
+  - new standard NAND ECC format which is able to fix up to 32-errors per page
+  - enable ONFI detection, allows to retrieve more details about the NAND chip
+  - improve NAND read performance by supporting OOB only read
+  - improve NAND write performance by removing unnecessary page reads on write
+  - 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")
+  - add "bmode" command which allows to select a specific boot device
+  - add display (DCU) support along with some default modes, display the Toradex
+    logo at VGA resolution by default
+  - add GPIO support through "gpio" command
+  - enable USB power for host port explicitly (fixes USB host support on Iris
+    and Viola Carrier Board)
+- Linux kernel:
+  - update to 4.0.2 stable Linux kernel
+  - add audio capture support on Colibri VF61 (AC97)
+  - use configfs for USB Gadget configuration
+  - improve NAND read performance by supporting OOB only read
+  - improve NAND write performance by removing unnecessary page reads on write
+  - export Vybrid SoC information such as ROM revision and unique ID through
+    SoC bus (/sys/devices/soc0/machine, family, soc_id and revision)
+- 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
+  - use libusbg to configure USB Gadget through configfs, provides a default
+    configuration which configures a serial connection using CDC ACM protocol
+  - enable a serial console on the tty provided by USB Gadget CDC ACM (ttyGS0
+    on module side, typically ttyACM0 on host side)
+  - 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
+  - remove e2fsprogs for VF default image (image feature ext2)
+  - fix GPIOConfig CPU detection on Colibri VF50 (GPIOConfig V1.3)
+
+- sources git.toradex.com tag Colibri_VF_LinuxImageV2.4Beta1_20150518
+  - repository linux-toradex branch toradex_vf_4.0
+  - repository u-boot-toradex branch 2015.04-toradex
+
+Note:
+- mount point names changed from /media/<block device name> to /media<label>
+- The kernel requires now the device tree from within the root filesystem to
+  boot. Board customisation within code are for most use cases not necessary.
+  For custom carrier boards, it is recommended to create a customised
+  device tree file and deploy it in the root filesystems /boot directory.
+  U-Boot reads the device tree according to the following name scheme:
+  => ${soc}-colibri-${fdt_board}.dtb
+
+  Hence, a custom carrier board needs to set the fdt_board variable accordingly
+  and would name the device tree files using the SoC prefix depending on the
+  supported module type:
+  => vf500-colibri-mycarrier.dtb
+  => vf610-colibri-mycarrier.dtb
+
+Known Issues:
+- If the module does not boot, remove all displays connected to HSYNC, VSYNC and reset.
+  (This has been observed on an Evaluation Board V2.1C)
+- Downgrade is not possible through "run update" due to NAND ECC layout changes
+  refer to the flashing instruction article to flash the module from scratch
 
 ********************************************************************************
 Linux Image V2.3 Beta 7 (February 03, 2015)
@@ -379,7 +450,6 @@ Notes:
 - user account: root with empty password
 - UBIFS flash root file system
 - opkg package manager
-- 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
@@ -393,6 +463,7 @@ Working on latest image:
   - module type auto detection
   - USB storage as host on USB host port
   - USB device firmware upgrade (DFU) as device on USB OTG port
+  - framebuffer support
 - Linux kernel
   - GPIOlib /sys/class/gpio
   - temperature sensor /sys/bus/iio/devices/iio\:device0/in_temp_input
@@ -411,6 +482,7 @@ Working on latest image:
   - serial number and board revision
   - watchdog
   - USB host port
+  - USB webcam
   - USB raw HID device /dev/hidrawX
   - USB device Ethernet RNDIS
   - USB device CDCACM
@@ -429,134 +501,16 @@ Working on latest image:
 Not working or not tested:
 - U-Boot boot loader
   - USB keyboard
-  - framebuffer support
 - Linux kernel
   - Colibri VF61: AC97 analogue audio capture
   - USB audio driver
-  - USB webcam
   - automatic USB device/host detection aka OTG support
   - IrDA
   - RS-422/485
   - optional parallel camera interface
 
 ******************************************************************************
-NAND Boot: Colibri VF50 V1.0a and V1.1a, Colibri VF61 V1.0b and V1.1b (Sample)
-******************************************************************************
+Flashing instruction have been moved to the Toradex developer article:
+http://developer.toradex.com/knowledge-base/flashing-linux-on-vybrid-modules
 
-If the boot loader in NAND got corrupted UART/SD card boot as described further
-down can be used as a means of recovery.
-
-Initial Preparation:
-- download and extract Colibri_VF_LinuxImageVx.yz.tar.bz2 package with root
-  permissions
-- use any VFAT formatted SD, uSD card or USB flash drive with at least 100 MB
-  of free space
-- optionally format the SD or uSD card using the format_sd.sh script
-  (warning: everything on the SD card will be erased!)
-- run update.sh script with optional -o argument pointing to mount point of
-  above mentioned SD card or USB flash drive
-- insert prepared SD card into SD card/MMC SDIO-socket (X15/X10 on Iris)
-
-Flash NAND:
-- EvalBoard V3.1a
-  - 115200 baud serial debug console on UART_A
-    (lower X25 resp. X27 depending on JP17/19) without any handshake
-- Iris V1.1a
-  - 115200 baud serial debug console on UART_A
-    (X13) without any handshake
-- apply power or reset
-- hit any key to stop auto booting
-- use 'run setupdate' commands
-  (for old U-Boot versions 'mmc part 0 ; fatload mmc 0:1 $loadaddr flash_mmc.img ;source $loadaddr')
-- use 'run update' command
-
-Boot from NAND:
-- EvalBoard V3.1a/V3.2a or Iris V1.1a
-- above given update command should automatically perform a soft re-boot upon
-  successful completion
-- optionally power cycle
-- upon first boot post-install scripts are run which take some time
-
-********************************************************************
-UART Boot: Colibri VF50 V1.1a and Colibri VF61 V1.1b (Sample, fused)
-********************************************************************
-
-If the boot loader in NAND got corrupted this can be used as a means of recovery.
-
-For detailed description, see also:
-http://developer.toradex.com/knowledge-base/vfxx-recovery-mode
-
-For initial Preparation, refer to NAND Boot above.
-- If you have a 32-bit Linux host, replace vf_flash/imx_uart with its 32-bit
-  version vf_flash/imx_uart.m32 i.e. sudo mv vf_flash/imx_uart
-  vf_flash/imx_uart.m64; sudo ln -s vf_uart.m32 vf_flash/imx_uart
-- For config block recovery, run the ./create_configblock.sh script to
-  generate a configblock.bin file before creating the SD card
-
-Connect UART_A:
-- On EvalBoard V3.1a, use on-board FTDI (bridge RTS/CTS on module side, X11 5/6)
-- On EvalBoard V3.2a, use on-board FTDI (do not bridge RTS/CTS!)
-- On Iris, use RS232 adapter with RTS/CTS support
-
-Enter recovery mode:
-- Turn the module off
-- On EvalBoard V3.1a, press the recovery button
-- On Iris, short pin 1-2 of JP1 on Iris for recovery
-- Turn the module on
-
-Boot using UART:
-- Use update.sh -d /dev/ttyUSB0
-- When RTS/CTS is shortened on module side, disable RTS/CTS on PC side by using
-  argument -n
-
-Flash NAND:
-- EvalBoard V3.1a/V3.2a
-  - 115200 baud serial debug console on UART_A
-    (lower X25 resp. X27 depending on JP17/19) without any handshake
-- Iris V1.1a
-  - 115200 baud serial debug console on UART_A
-    (X13) without any handshake
-- hit enter to verify the U-Boot command prompt
-- Use 'run setupdate' command to load update commands from SD card
-  - Migrating from images before V2.2: use 'run migrate_v2.1b3' to migrate
-    config block to new flash layout.
-  - To re-create boot configuration block: use 'run create_bcb' to re-create
-    the boot configuration block. Then, use 'run update_configblock' to flash
-    the config block again.
-    Finally, use 'run update' command to update the boot loader, kernel and
-    root file system.
-
-Note: After UART recovery, the module is resetted automatically, however when
-resetting, the module enters recovery mode again. One need to power cycle the
-module to start the flashed image.
-
-Note: This also works for non-fused modules. However, the jumper X11-37 need to
-be removed. The reason is that non-fused modules determine the UART for serial
-loader from SO-DIMM 105 (X11-37) and SO-DIMM 101 (X22-9), which both need to
-be low in order to boot from UART0.
-
-***************************************************************************
-SD Card Boot: Colibri VF50 V1.0a and Colibri VF61 V1.0b (Sample, non-fused)
-***************************************************************************
-
-If the boot loader in NAND got corrupted this can also be used as a means of recovery.
-
-Initial Preparation:
-- EvalBoard V3.1a
-  - select SD boot bootstrap option
-    - pull the following X8 pins down aka to ground with 1 k ohm resistors: 23 and 33
-    - pull the following X8 pins up aka to 3.3 volt with 1 k ohm resistors: 21, 27, 34 and 44
-- download and extract Colibri_VF_LinuxImageVx.yz.tar.bz2 package with root permissions
-
-Flash SD Card:
-- use any SD resp. uSD card of at least 100 MB capacity
-- format and flash SD resp. uSD card using format_sd.sh script giving -d argument pointing to
-    device file of SD card and -f argument (warning everything will be erased)
-
-Boot from SD Card:
-- EvalBoard V3.1a
-  - insert SD card into SD card/MMC SDIO-socket (X15)
-- apply power
-- upon first boot post-install scripts are run which takes around 2 minutes, please be patient
-
-Toradex, March 25, 2015
+Toradex, May 19, 2015
-- 
cgit v1.2.3