summaryrefslogtreecommitdiff
path: root/release-notes/Colibri_iMX6_LinuxReleaseNotesV2.x.txt
blob: d33a3ad9a45cb90ba89d79cb53bfa8d6e8cdbb95 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
*************************************************
Release Notes:  Linux Image V2.x for Colibri iMX6
*************************************************

Contents:
- U-Boot 2015.04 boot loader
- Linux 3.14.52 kernel, based on Freescale's BSP release imx_3.14.52_1.1.0_ga
- Angstrom 2015.12/OpenEmbedded jethro/Yocto 2.0 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.6.1 Beta 1 (September 29, 2016)

- U-Boot boot loader:
  - backport patches needed if compiling with GCC 6
  - add fdt_fixup environment variable as a hook to modify device tree
- Linux kernel:
  - backport patches needed if compiling with GCC 6
  - add support for RS-485 (#19323)
- Linux user-space:
  - deploy GPIOConfig V1.4 which corrects 'SODIMM Pin'/'EvalLoc' columns for
    pads DI0_PIN15, NANDF_D4, NANDF_D6 and SD1_CLK
  - improve fw_printenv/setenv concerning /etc/fw_env.config
- OpenEmbedded build system:
  - split meta-toradex into BSP layers meta-toradex-bsp-common and
    meta-toradex-nxp as well as the software layer meta-toradex-demos
  - rename the parent directory from stuff to layers
  - mv from build/out*/deploy to deploy
  - rename TMPDIR from out to tmp
  - deploy qt5 tools into the sdk as part of optional angstrom-qt5-x11-image.bb

- sources git.toradex.com tag Colibri_iMX6_LinuxImageV2.6.1Beta1_20160929
  - repository linux-toradex branch toradex_imx_3.14.52_1.1.0_ga
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- some USB Thumb drives 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.
- License texts do not get deployed to the root file system.

********************************************************************************
Linux Image V2.6 (August 26, 2016)
- none, this version is identical to the previous beta version V2.6 Beta 2

********************************************************************************
Linux Image V2.6 Beta 2 (June 30, 2016)

- U-Boot boot loader:
  - update do_patch_ddr_size to parse ivt and dcd
  - synchronize/improve memory options
  - net: increase maximum frame size to accommodate VLAN packets
  - update: make set<media>update self contained
  - increase maximum temperature for booting linux
- Linux kernel:
  - mxc_v4l2_capture: Allow clock setting for de-interlaced video input
  - media: Add support for ADV7280 decoder driver as found on ACA
  - add MCP2515 SPI CAN controller to device tree
  - can: mcp251x: fix resume when device is down
- Linux user-space:
  - trdx-extra.inc: add iperf3 to all images
  - florence: update to latest version 0.5.4, build without sound and drop
    gstreamer 0.10 dependency
  - images: i.mx 6 don't deploy gstreamer xvimagesink, xvinfo
  - gpioconfig: fix pkg_postrm
- OpenEmbedded build system:
  - linux-toradex-fsl-rt: Added a real-time kernel recipe for 3.14.52
  - further clean-up update.sh update script
  - angstrom-qt5-x11-image: add a recipe which deploys qt5 and starts a demo

- sources git.toradex.com tag Colibri_iMX6_LinuxImageV2.6Beta2_20160701
  - repository linux-toradex branch toradex_imx_3.14.52_1.1.0_ga
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- updating Colibri iMX6DL from V2.6 Beta 1 manually entering 'patch_ddr_size'
    from within U-Boot is required to gain access to full 512MB RAM
- some USB Thumb drives 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.
- License texts do not get deployed to the root file system.

********************************************************************************
Linux Image V2.6 Beta 1 (March 31, 2016)

- Booting:
  - using the eMMC fast boot feature.
      This requires fusing the bootmode irreversibly into the i.MX 6.
      It will be done as part of the flashing process, refer to the flashing
      instructions mentioned above.
      Fast boot mode addresses issue 15990
      http://developer.toradex.com/software/linux/linux-software/release-details?view=all&issue=15990
- U-Boot boot loader:
  - added updt_fuse command required for the change to fastboot mode
- Linux kernel:
  - updated to 3.14.52
  - disable not serviced DCD/RI UART interrupts
  - fixed bug preventing gpio-leds dtb configuration
  - limit SPI clock to datasheet maximum of 23MHz
- Linux user-space:
  - deploy GPIOconfig now available for Colibri iMX6
  - deploy rttest package
  - use gstreamer 1.0. Note that some plugin names changed
- OpenEmbedded build system:
  - update OpenEmbedded from fido to jethro:
    - Firefox 38.2.1esr
    - gcc Linaro GCC 5.2-2015.11-2
    - glibc 2.22
    - systemd 226
    - Xorg 1.17.2

- sources git.toradex.com tag Colibri_iMX6_LinuxImageV2.6Beta1_20160331
  - repository linux-toradex branch toradex_imx_3.14.52_1.1.0_ga
  - repository u-boot-toradex branch 2015.04-toradex

Known Issues:
- gstreamer freezes when generating its initial database on some modules:
    (gst-plugin-scanner:683): GLib-GObject-WARNING **: cannot register existing type 'GstImxCompositorPad'
    The following gets you around this:
      mv /usr/lib/libgstimxcompositor.so.0.12.0 /usr/lib/libgstimxcompositor.so.0.12.0.orig
      gst-inspect-1.0
      mv /usr/lib/libgstimxcompositor.so.0.12.0.orig /usr/lib/libgstimxcompositor.so.0.12.0
    Alternative one can uninstall libgstimxcompositor0
      opkg remove --force-depends libgstimxcompositor0
- On the Colibri iMX6DL the RAM configuration is not patched correctly, thus
    only 256MB are available. Fix in the 2015.04-toradex-next branch
    available.
- USB RNDIS is racy due to networkd bug and not started by default
- some USB Thumb drives 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 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.52_1.1.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.0/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 MMC/SD card mmc1
  - framebuffer console
  - HDMI audio
  - analogue audio playback and capture, resistive touch
  - optional S/PDIF, disabled in device tree
  - SPI via /dev/spidev3.0, disabled in device tree
  - CAN via MCP2515 on Evaluation Board
  - optional 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
  - GPIO config tool
- 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
  - IrDA
- Linux user-space
  - Gstreamer encoding (not tested)
- 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, October 5, 2016