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

Contents:
- U-Boot 2011.06 boot loader
- Linux 3.1.10 kernel, based on NVIDIA's Linux for Tegra (L4T) release 16-r3
- 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 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 SATA suspend/resume by adding avdd_plle regulator.
  - Fix HDMI suspend/resume by avoiding division by zero oops.
  - Add GPIO keyboard configuration.
  - Use integer for root_bus_nr in Tegra PCIe driver.
  - 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 Apalis_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).
  - Fix Linux USB OTG1 behaviour by not enabling USBO1_EN during
      boot as USB host functionality on OTG1 port is anyway broken under U-Boot.
- Linux kernel:
  - Fix several HDMI hang issues.
  - Exported Apalis GPIOs via SYSFS (see /sys/class/gpio).
  - 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.
  - 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: add sanity checks

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

Known Issues:
- LVDS aka TFTLCD resolution hard-coded in kernel to full HD 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 2 (August 19, 2013)
This updates u-boot and kernel to cope with the increased eMMC and changed T30
CPU SKU on Apalis T30 - 2GB V1.0c, Apalis T30 - 1GB V1.0a
- U-Boot:
  - eMMC and RAM size / offset detection
  - rename shell prompt to Apalis 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 relevant v4l kernel modules plus v4l-utils

- sources git.toradex.com tag Apalis_T30_LinuxImageV2.0Beta2_20130816

Known Issues:
- We are in an early Beta 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 full HD 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 (June 26, 2013)
- U-Boot:
  - initial integration
  - integrate NVIDIA partition table parsing incl. Toradex Apalis configuration block
  - adjust available amount of memory
  - activate DVI-D framebuffer console
  - increase CPU frequency at boot
  - decrease boot delay
  - fix overflow in HCD conversion
- Linux kernel:
  - hack to make newer SD cards work by adding a quirk for lack of 1.8v support
  - revise Ethernet MAC address assignment
  - fix PCIe AXI response decoding errors
  - fix PCIe reset issue
  - remove spurious tegra_aes_device
  - video4linux adv7180 and max9526 integration
  - fix PCIe by forcing GEN1 speed
  - set board local critical temperature to 95°C
  - hack to avoid 24 Hz mode in X resulting in no display at all
  - silence extensive HDMI HDA audio messages
- 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 Apalis_T30_LinuxImageV2.0Beta1_20130626

Known Issues:
- We are in an early Beta 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 full HD 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 Alpha 1 (March 15, 2013)
(ported form the Linux Image V2.0 Beta1 for Colibri T30)
- U-Boot:
  - first release
- Linux kernel:
  - first release
- oe-core:
  - first release
- sources git.toradex.com tag Apalis_T30_LinuxImageV2.0Alpha1_20130315

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 full HD resolution, 
  comments with timings for other resolutions provided
- some windows have garbled titlebar, e.g. lxterminal
- lxappearance is segfaulting upon start
- Gigabit Ethernet MAC address hard-coded to 00:0e:c6:87:72:01
- stability issues on concurrent PCIe and SATA stress testing
- connecting an analog 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

********************************************************************************
Notes:
- 115200 baud serial debug console on UARTA aka UART1 (EvalBoard lower X28 resp. X29 depending on JP10/12, X22 on Ixora) without any handshake
- user account: root with empty password
- ext3 root file system
- opkg package manager
- HDMI: 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
  - ASIX based USB to Ethernet adapters on USBH3
  - MMC/SD cards (only GPT partitioned)
  - eMMC flash with NVIDIA partition table parsing
  - serial console debug UARTA aka UART1
  - Toradex Apalis configuration block handling
  - USB storage as host on USBH3
- Linux kernel
  - GPIOlib /sys/class/gpio
  - temperature sensor /sys/bus/i2c/devices/4-004c
  - RTC (Tegra internal, PMIC and board level I2C RTC)
  - Gigabit Ethernet eth0
  - serial console debug UARTA aka UART1
  - high speed serial UARTB aka UART3, UARTC aka UART4 and UARTD aka UART2
  - I2C via /dev/i2c-X
  - 8-bit MMC card mmc1
  - 4-bit SD card mmc2
  - PWM LEDs /sys/class/leds/
  - HDMI HDA audio
  - HDA audio (on Eval Board V1.0a: check datasheet/schematics for patch instructions)
  - analog audio capture, playback and 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 aka SPI1 and /dev/spidev4.2 aka SPI2
  - 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/suspend detection aka full OTG support
  - analog input
 - suspend LP1
  - CAN via can0 and can1
  - PCIe (regular ports and mini-PCIe slot)
  - SATA (regular port or mSATA slot)
  - DVFS power management
  - parallel camera interface
- Linux user-space
  - graphics (LVDS-1 aka TFTLCD and HDMI-1 aka DVI-D)
  - tegrastats
  - Firefox
  - Gstreamer video encode and playback, dual full HD video decode
  - LXDE
  - tegrastats-gtk, CPU information visible in graphical environment
  - LVDS transmitter configuration (see lvds-dual-channel.sh resp. lvds-single-channel.sh)

Not working or not tested:
- U-Boot boot loader
  - U-Boot USB keyboard
  - Gigabit Ethernet
  - framebuffer support
  - USB OTG1 and USBH2
- Linux kernel
  - IrDA
  - RS-422/485
  - SIM card
- Linux user-space
  - Adobe Flash not provided by L4T (and probably never will)
  - opkg package feeds don't seem to be usable
  - GPIO config tool missing Apalis MXM3 pin description integration

*********************************************************
eMMC Boot: Apalis T30 1GB V1.0a (Sample)
eMMC Boot: Apalis T30 2GB V1.0a, V1.0b and V1.0c (Sample)
*********************************************************

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

Flash eMMC:
- EvalBoard V1.0a
  - connect USB micro A/B (X49) or USB B (X50) to development workstation using micro or regular USB cable
  - connect serial debug console to lower X28 or X29 using null modem RS-232 or regular USB cable
- Ixora V1.0a
  - connect USB micro A/B (X9) to development workstation using regular micro USB cable
  - make sure JP2 is removed and nothing is connected to the lower USB host port X8
  - optionally assemble resistor R90 instead of R91 so SW3 can be used as recovery mode switch
  - for more information please consult Ixora datasheet section 3.3 and chapter 4
- enter recovery mode:
  - EvalBoard with Mezzanine press recovery mode SW2 while applying power
  - Ixora press SW3 while applying power (requires R90 assembly option noted above)
  - Eboot (e.g. transitioning from WEC):
    - 115200 baud without any handshake
    - hold space key while applying power or resetting
    - press x to enter command mode
    - use 'reboot rcm' command
  - U-Boot (e.g. updating Embedded Linux):
    - 115200 baud without any handshake
    - apply power or reset
    - hit any key to stop auto booting
    - use 'enterrcm' command
  - for more information about recovery mode please consult Apalis T30 datasheet chapter 6
- run update.sh script

Boot from eMMC:
- EvalBoard V1.0a or Ixora V1.0a
- power cycle
- upon first boot post-install scripts are run which takes around 2 minutes, please be patient

Toradex, February 10, 2014