1.. SPDX-License-Identifier: GPL-2.0+
2
3ToC:
4- Introduction
5- Booting
6- Debugging
7- i2c
8
9
10Introduction
11============
12The Embedded Artists LPC3250 Developer's Kit v2 features the LPC3250 SoC
13which is based on the ARM926EJ-S CPU. The kit features a base board and
14a removable OEM board which features the SoC. Details, schematics, and
15documentation are available from the Embedded Artists product website:
16
17	https://www.embeddedartists.com/products/lpc3250-developers-kit-v2/
18
19The base board includes::
20- 200 pos, 0.6mm pitch SODIMM connector for OEM Board
21- LCD expansion connector with control signals for touch screen interface
22- Expansion connector with all OEM Board signals
23- Ethernet connector (RJ45)
24- CAN interface & connector (provision for second CAN interface, but not mounted)
25- MMC/SD interface & connector
26- USB1: OTG or Host interface & connector
27- USB2: Device or Host interface & connector
28- Provision for NXP JN5148 RF module (former Jennic) interface (RF module not included)
29- Full modem RS232 (cannot be fully used on 32-bit databus OEM boards)
30- RS422/485 interface & connector
31- Provision for IrDA transceiver interface (transceiver not mounted)
32- I2S audio codec (mic in, line in, line out, headphone out)
33- SWD/JTAG connector
34- Trace connector and pads for ETM connector
35- Serial Expansion Connector, 14-pos connector with UART/I2C/SPI/GPIO pins
36- Power supply, either via USB or external 5V DC
37- Optional coin cell battery for RTC and LED on ALARM output (coin cell not included)
38- OEM Board current measuring
39- Parallel NOR flash on external memory bus
40- 16-bit register and LEDs on external memory bus
41- 5-key joystick
42- LM75 temperature sensor (I2C connected)
43- 5 push-button keys (four via I2C and one on ISP-ENABLE)
44- 9 LEDs (8 via I2C and one on ISP-ENABLE)
45- Trimming potentiometer to analog input
46- USB-to-serial bridge on UART #0 (FT232R) and ISP functionality
47- Reset push-button and LED
48- Speaker output on analog output from OEM Board, or from I2S audio codec
49- 160x150 mm in size
50
51The OEM board::
52- ARMv5 ARM926EJ-S @ 266 MHz with hard-float VFPv2
53- 256 KByte IRAM, 64 MByte SDRAM
54- 128 MByte NAND flash
55- 4 MByte NOR Flash
56- Graphics Output: Parallel RGB
57- Hardware 2D/3D Graphic: No
58- Hardware Video: SW only
59- Graphics input: No
60- Audio: I2S
61- Ethernet: 10/100 Mbps
62- USB: 1x FS USB 2.0 OTG
63- Wi-Fi: No
64- FlexIO: No
65- Serial: 2x I2C, 2x SPI, 7x UART
66- ADC/PWM: 3 ch (10-bit) / 2 ch
67- SD: MCI
68- PCIe: No
69- Serial ATA: No
70- Size: 68 x 48 mm
71- Connector: 200 pos SODIMM
72
73
74Booting
75=======
76The processor will start its code execution from an internal ROM,
77containing the boot code. This boot loader can load code from one of four
78external sources to internal RAM (IRAM) at address 0x0::
79- UART5
80- SSP0 (in SPI mode)
81- EMC Static CS0 memory
82- NAND FLASH
83
84The ROM boot loader loads code as a single contiguous block at a maximum
85size of 56 kByte. Programs larger than this size must be loaded in more
86steps, for example, by a secondary boot loader.
87
88Kickstart Loader
89----------------
90By default the Embedded Artists LPC3250 OEM Board is programmed with the
91kickstart loader in block 0 of the NAND flash. The responsibility of this
92loader is to load an application stored in block 1 and onwards of the NAND
93flash. The kickstart loader will load the application into internal RAM
94(IRAM) at address 0x0.
95
96Stage 1 Loader (s1l)
97--------------------
98By default the Embedded Artists LPC3250 OEM Board is programmed with the
99stage 1 loader (s1l) in block 1 of the NAND flash. This application will be
100loaded by the kickstart loader when the LPC3250 OEM Board powers up. The
101S1L loader will initialize the board, such as clocks and external memory
102and then start a console where you can give input commands to the loader.
103S1L offers the following booting options::
104- MMC/SD card
105- UART5
106- NAND Flash
107
108U-Boot with kickstart+s1l
109-------------------------
110Out of the box, the easiest way to get U-Boot running on the EA LPC3250
111DevKit v2 board is to build the ea-lpc3250devkitv2_defconfig, copy the
112resulting u-boot.bin to a vfat-formatted MMC/SD card, insert the MMC/SD card
113into the MMC/SD card slot on the board, reset the board (SW1), and::
114
115	Embedded Artist 3250 Board (S1L 2.0)
116	Build date: Oct 31 2016 13:00:37
117
118	EA3250>load blk u-boot.bin raw 0x83000000
119	File loaded successfully
120
121	EA3250>exec 0x83000000
122
123
124Debugging
125=========
126JTAG debugging of the Embedded Artists LPC3250 Developer's Kit v2 board is
127easy thanks to the included/populated 20-pin JTAG port on the main board (J8).
128openocd 0.11 has been used with this board along with the ARM-USB-OCD-H JTAG
129dongle from Olimex successfully as follows:
130
131	# openocd \
132		-f interface/ftdi/olimex-arm-usb-ocd-h.cfg \
133		-f board/phytec_lpc3250.cfg
134
135
136i2c
137===
138Some of the LEDs on the board are connected via an I/O Expander (PCA9532) that
139is attached to the i2c1 bus. Here is a sample session of toggling some of
140these LEDs via i2c in U-Boot:
141
142show the existing i2c busses:
143	EA-LPC3250v2=> i2c bus
144	Bus 0:  i2c@300
145	Bus 1:  i2c@400a0000
146	Bus 2:  i2c@400a8000
147
148set i2c1 as the current bus:
149	EA-LPC3250v2=> i2c dev 1
150	Setting bus to 1
151
152see what potential devices are found with rudimentary probing on i2c1:
153	EA-LPC3250v2=> i2c probe
154	Valid chip addresses: 1A 1D 48 50 57 60 66 6E
155
156According to the schematics the i2c slave address of the PCA9532 is 0x60.
157
158dump all of the 10 registers from the I/O Expander; NOTE that the 0x10 in the
159command specifies the self-incrementing mode of the PCA9532; also NOTE that
160the values repeat themseves to fill out a full 16 bytes:
161	EA-LPC3250v2=> i2c md 0x60 0x10 10
162	0010: 00 ff 00 80 00 80 00 00 00 00 4f ff 00 80 00 80    ..........O.....
163
164turn on LEDs 23, 25, 27, and 29 (green):
165	EA-LPC3250v2=> i2c mw 0x60 9 0x55
166
167turn on LEDs 22, 24, 26, and 28 (red):
168	EA-LPC3250v2=> i2c mw 0x60 8 0x55
169
170dim the green LEDs (23, 25, 27, 29):
171	EA-LPC3250v2=> i2c mw 0x60 3 0x20
172	EA-LPC3250v2=> i2c mw 0x60 9 0xaa
173
174turn off all LEDs (23-29):
175	EA-LPC3250v2=> i2c mw 0x60 8 0
176	EA-LPC3250v2=> i2c mw 0x60 9 0
177
178read value of switches (input):
179	EA-LPC3250v2=> i2c md 0x60 0 1
180	0000: 4f    O
181[none are pressed]
182
183press and hold SW2 while running the following:
184	EA-LPC3250v2=> i2c md 0x60 0 1
185	0000: 4e    N
186[SW2 is pressed]
187