summaryrefslogtreecommitdiff
path: root/release-notes/Colibri_T30_LinuxReleaseNotesV2.x.txt
blob: d1987dcf6b2c31fa6f5c51617bdffe1ed30cfe47 (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
************************************************
Release Notes:  Linux Image V2.x for Colibri T30
************************************************

Contents:
- U-Boot 2011.06 boot loader
- Linux 3.1.10 kernel, based on NVIDIA's Linux for Tegra (L4T) release R16.4
- OpenEmbedded oe-core 2013.06 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.1 Beta 3 (March 18, 2014)
- U-Boot:
  - Enable hardware boot partition support (via 'mmc dev [dev] [part]' command).
  - Get rid of the spurious 'video=tegrafb' kernel boot argument and add
    'noatime' to the usbargs.
- Linux kernel:
  - Initialise high speed UART with lower default baudrate to avoid issues.
  - Merge with NVIDIA's latest L4T R16.4 kernel.
  - Added OmniVision OV7670 and Texas Instruments TVP5150 V4L2 drivers.
  - Added initial Aptina AS0260 V4L2 driver.
  - Solved low framerate issue with analogue cameras.
- rootfs / oe-core:
  - nv-binaries: update to L4T R16.4
  - Added gst-plugins-good-jpeg
- sources git.toradex.com tag Colibri_T30_LinuxImageV2.1Beta3_20140318

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
- 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.1 Beta 2 (February 6, 2014)
- U-Boot:
  - Add more UART configurations to the device trees allowing easy switching of
    the console UART port by changing the UART base address of the console node
    within the device tree.
  - Fix EHCI periodic list handling.
  - Add default VESA VGA vidargs for our now modedb enabled kernel. This allows
    easy specifying an alternate parallel RGB resolution.
  - Fix usbboot option to be more in-line with how we do optional MMC/SD card
    boot on Colibri VF50/VF61. Loads the uimage kernel from the first partition
    being formatted as VFAT and instructs the kernel to mount the second
    partition formatted as ext3 as root file system.
- Linux kernel:
  - Use TPS6591X IRQ base define to calculate correct IRQ number.
  - Remove vdd_hdmi_con regulator from dc1 since we don't have a dedicated
    regulator for this connector on our baseboards.
  - Fix HDMI suspend/resume by avoiding division by zero oops.
  - Don't register KEY_BACK for wakeup.
  - Add STMPE ADC driver using IIO framework
    (see http://developer.toradex.com/knowledge-base/adc-(linux)).
  - Use modedb to specify framebuffer resolution (see
    http://developer.toradex.com/knowledge-base/framebuffer-(linux) and
    http://developer.toradex.com/knowledge-base/x-server-(linux)).
  - Check null pointers for sysfs calls.
  - Hack to avoid 24 Hz mode in X resulting in no display at all. This has been
    encountered using e.g. a Samsung SyncMaster F2380 if connected by HDMI.
  - Add kernel parameters to change RGB clock polarity.
  - Re-work Fusion multi-touch touchscreen driver.
  - Before updating modes on HDMI hotplug, check if framebuffer is registered
    at all. This allows to disable framebuffers completely.
- rootfs / oe-core:
  - Fix build and texinfo errors for stress.
  - Add sections for both monitor outputs to xorg.conf. Add example
    configuration to disable an output as well as select preferred mode.
  - Add entry for fusion touchscreen driver to xorg.conf.
  - Add fstrim from util-linux.
  - Add kernel module for fusion touch screens (see
    http://developer.toradex.com/knowledge-base/capacitive-multi-touch-display-(linux)).
  - burnflash: Account for fs overhead and many files.
- sources git.toradex.com tag Colibri_T30_LinuxImageV2.1Beta2_20140206

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
- 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.1 Beta 1 (October 22, 2013)
- U-Boot:
  - Fix possible uninitialised array member issue in serial number to
      hexadecimal coded decimal conversion routine (e.g. as used for
      /proc/cpuinfo in Linux).
- Linux kernel:
  - Fix several HDMI hang issues.
  - Support default watchdog API (see
      http://developer.toradex.com/knowledge-base/watchdog-(linux)).
  - Disable magic SysRq key configuration as this is not only a potential
       security thread but can cause serious trouble if for some reason UART pins
       are left floating and therefore cause unexpected break conditions.
  - Add DDR speed definition for 400 and 800 MHz.
  - HDMI: Retry EDID reads up to 4 times until failing.

- rootfs / oe-core:
  - OpenEmbedded: layers updated to dylan
      xserver update to version 1.14
      gtk+ updated to 2.24.15
      firefox update to 10.0.11esr
      connman now has a command line tool, connmanctl
      split the meta-lxde layer from oe-tworaz and serve it from
        git.toradex.com
  - NEON enabled build
  - hdmi: add udev rule to start an X output on hotplug
  - feed-config: use the new feed armv7ahf-vfp-neon
  - evdev: backport V2.8.1 from dora to get a fix for multitouch events
  - burnflash: script for configblock generation
  - added packages: ethtool
  - burnflash: change the Colibri image names to start with Colibri
  - burnflash: add sanity checks

- sources git.toradex.com tag Colibri_T30_LinuxImageV2.1Beta1_20131022

Known Issues:
- LVDS aka TFTLCD resolution hard-coded in kernel to VESA VGA resolution, 
    comments with timings for other resolutions provided
- 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 3 (August 20, 2013)
This updates u-boot and kernel to cope with the increased eMMC and changed T30
CPU SKU on Colibri T30
- U-Boot:
  - eMMC and RAM size / offset detection
  - rename shell prompt to Colibri 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 v4l-utils
  - removed warning output from commandline tegrastats

- sources git.toradex.com tag T30_LinuxImageV2.0Beta3_20130820

Known Issues:
- 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 VESA VGA 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 2 (June 26, 2013)
- U-Boot:
  - integrate NVIDIA partition table parsing incl. Toradex Colibri configuration block
  - increase CPU frequency at boot
  - decrease boot delay
  - fix overflow in HCD conversion
- Linux kernel:
  - allow easy integration of a custom Linux boot logo
  - add TouchRev Fusion 10 aka CPT CLAA101NC05 display timings
  - integrate TouchRev Fusion 7 and 10 multi-touch driver
  - fix gpio-key pull-ups
  - enable back key wake-up
  - rename UARTs and PWM LEDs
  - explicitly configure for 4-bit MMC/SD cards by default
  - integrate MCP251x and SJA1000 CAN support
  - fix Ethernet MAC address assignment after suspend
  - hack to make newer SD cards work by adding a quirk for lack of 1.8v support
  - export some GPIOs via /sys/class/gpio
  - add comment about GMI_ADV_N usage
  - remove spurious tegra_aes_device
  - video4linux adv7180 and max9526 integration
  - set board local critical temperature to 95°C
  - hack to avoid 24 Hz mode in X resulting in no display at all
- 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 T30_LinuxImageV2.0Beta2_20130626

Known Issues:
- 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 VESA VGA 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 (March 28, 2013)
- U-Boot:
  - no changes
- Linux kernel:
  - fbcon: logo: allow easy integration of a custom Linux boot logo
- rootfs / oe-core:
  - use newer Linux kernel
  - use latest GPIOConfig, fixed SODIMM numbers
  - use a unified recipe for the Linux kernel
  - UBOOT_MACHINE variable definition moved to machine .conf file
  - add setxkbmap package
  - add florence package, virtual keyboard application
  - burnflash: fix race condition in genext3fs.sh and use -F option for mount
  - xorg framebuffer depth 16bit
  - use new Toradex CI

- sources git.toradex.com tag T30_LinuxImageV2.0Beta1_20130314

Known Issues:
- 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 VESA VGA resolution, 
  comments with timings for other resolutions provided
- some windows have garbled titlebar, e.g. lxterminal
- 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


********************************************************************************
Linux Image V2.0 Alpha 1 (January 22, 2013)
- U-Boot:
  - moved to proper machine type
- Linux kernel:
  - added one wire platform data (conditional, CONFIG_W1_MASTER_TEGRA must be enabled)
  - fix USB hang on device insertion
  - added correct spidev platform data (/dev/spidev0.0)
  - PWM B, PWM C, PWM D now accessible from userspace, /sys/class/leds/
  - refined pin muxing
  - added thermal throttling, i.e. CPU freq. is reduced when CPU gets hot
  - updated audio codec driver, audio input now working
  - GPIO keys implementation
  - LP1 suspend support
  - moved to proper machine type
  - fix PMIC regulator platform data
- oe-core:
  - use latest u-boot and Linux kernel
  - use latest GPIOConfig, fixes issues with tristated pins and GPIO with num >222
  
- sources git.toradex.com tag T30_LinuxImageV2.0Alpha1_20130122

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 VESA VGA resolution, 
  comments with timings for other resolutions provided
- some windows have garbled titlebar, e.g. lxterminal
- lxappearance is segfaulting upon start
- issues with the genext3.sh scripts: if your language settings expect 
  something different to 'y' to a question, the script failes.
  The rootfs is empty resulting in a kernel panic during boot.
  Workaround: edit line 38 of bin/genext3.sh as follows:
  old: echo y | mkfs.ext3 $@ -L arm 
  new: mkfs.ext3 -F -L arm $@

********************************************************************************
Linux Image V2.0 Alpha 0 (December 27, 2012)
(ported form the Linux Image V2.0 Beta1 for Colibri T20)
- U-Boot:
  - first release
- Linux kernel:
  - first release
- oe-core:
  - first release
- sources git.toradex.com tag T30_LinuxImageV2.0Alpha0_20121227

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. 
- When no device was attached to the USB host port during boot, the 
  system crashes when one is attached when the system is up.
- LVDS aka TFTLCD resolution hard-coded in kernel to VESA VGA resolution, 
  comments with timings for other resolutions provided
- some windows have garbled titlebar, e.g. lxterminal
- lxappearance is segfaulting upon start

********************************************************************************
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) without any handshake
- user account: root with empty password
- ext3 root file system
- opkg package manager
- HDMI aka DVI-D: 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
  - Ethernet
  - MMC/SD cards (only GPT partitioned)
  - eMMC flash with NVIDIA partition table parsing
  - serial console debug UARTA
  - Toradex Colibri configuration block handling
  - USB storage as host
- Linux kernel
  - GPIOlib /sys/class/gpio
  - temperature sensor /sys/bus/i2c/devices/4-004c
  - RTC (Tegra internal, PMIC and board level I2C RTC)
  - Ethernet eth0
  - eMMC ext3
  - serial console debug UARTA
  - high speed serial UARTB and UARTD
  - I2C via /dev/i2c-X
  - MMC/SD card, optional 8-bit SDHCI
  - PWM LEDs /sys/class/leds/
  - analogue audio capture, playback and resistive 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
  - GMI with multiplexed nPWE and RDnWR
  - framebuffer console
  - custom Ethernet MAC Address
  - serial number and board revision
  - watchdog
  - 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 detection aka OTG support
  - analogue input
  - suspend LP1
  - DVFS power management
  - optional parallel camera interface
- Linux user-space
  - graphics (LVDS-1 aka TFTLCD and HDMI-1 aka DVI-D)
  - tegrastats
  - Firefox
  - Gstreamer video encode and playback, independent dual full HD video decode
  - GPIO config tool
  - LXDE
  - tegrastats-gtk, CPU information visible in graphical environment

Not working or not tested:
- U-Boot boot loader
  - U-Boot USB keyboard
  - TFTLCD framebuffer support
- Linux kernel
  - HDMI SPDIF audio broken
  - IrDA
  - RS-422/485
- Linux user-space
  - Adobe Flash not provided by L4T (and probably never will)

*****************************************************
eMMC Boot: Colibri T30 V1.1b, V1.1c or V1.1d (Sample)
*****************************************************

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

Flash eMMC:
- EvalBoard V3.1a
  - connect USB B (X29) or USB micro A/B (X30) to development workstation using regular or micro USB cable
  - the jumper JP2 must be open
  - press and hold recovery mode switch (SW9) during power up
- Iris V1.1a
  - connect USB micro A/B (X12) to development workstation using regular micro USB cable
  - short pin 1-2 of JP1 on Iris for RECOVERY
(other carrier boards see http://developer.toradex.com/knowledge-base/colibri-recovery-mode)
- make sure that the carrier board supports USB high speed
  - Iris & EvalBoard V3.1a OK, for other carrier boards see http://developer.toradex.com/knowledge-base/usb-2.0-high-speed-%28480mbps%29 )
- apply power or reset
- run update.sh script

Boot from eMMC:
- EvalBoard V3.1a
  - do no longer press SW9
- Iris V1.1a
  - do no longer short any pins of JP1
- power cycle
- upon first boot post-install scripts are run which takes around 2 minutes, please be patient

Toradex, March 18, 2014