NXP Semiconductors AN10815 Installation and operating instructions

AN10815
SWIM: NXP's basic graphics library for LPC products
Rev. 3 — 15 June 2011 Application note
ocument information
Info Content
Keywords SWIM, Graphics Library for LPC178x, LPC18xx, LPC24xx and LPC32x0,
LCD, TFT, STN, IRD, Phytec, Embedded Artists, Keil MDK, IAR EWARM,
Rowley Crossworks.
Abstract This document describes example projects created to demonstrate the
LPC SWIM Graphics library. Toolchains used are Keil MDK, IAR EWARM
and Rowley Crossworks. The development platforms were from
Embedded Artists, NXP, and Phytec.

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
AN10815 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 2 of 20
Contact information
For more information, please visit: http://www.nxp.com
For sales office addresses, please send an email to: [email protected]
Revision history
Rev Date Description
3 20110615 Added support for EA LPC1788 OEM board.
2 20110501 Added support for Hitex LPC1850.
1 20090501 Initial revision.

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
1. Introduction
Simple Window Interface Manager (SWIM) is a basic graphics library developed for the
NXP LPC products. It can be also be used with LPC controllers that do not have a
dedicated LCD interface. The SWIM graphics library allows developers to quickly and
easily implement a system with basic graphics support.
Project examples for IAR EWARM, KEIL MDK, and Rowley Crossworks toolchains are
provided as part of the package. These projects are directed at the following target
platforms:
LPC3250 from Phytec: http://www.phytec.com
LPC2478 from EA: http://www.embeddedartists.com
IRD Platform from NXP: http://ics.nxp.com/support/boards/ird/
LPC1850 from Hitex: http://www.hitex.com/index.php?id=3212
LPC1788 from EA http://www.embeddedartists.com
The example projects demonstrate how to use the library and will help users get familiar
with the library calls quickly and efficiently.
2. SWIM features
The following section describes the main features and functionality of the SWIM library.
In addition, the library code is well commented and an associated API document for the
software calls - SWIM v1.0.pdf – is also available. Some of the main SWIM functions are
briefly summarized in the following subsections.
2.1 Graphic primitives
swim_put_pixel – places a pixel of specified color at a specified location on the LCD
swim_put_line – draws a colored line for positions x to y
swim_put_diamond – draws a diamond shape of specified color and position
swim_put_box – put box at specified location. Pen color for edges and fill color for
center
swim_set_pen_color – sets the pen color
swim_clear_screen – fills the draw area of the display with the selected color
2.2 Image support
swim_put_image – puts a raw image into a window
swim_put_scale_image – puts and scales a raw image into a window
swim_put_invert_image – puts a raw image into a window inverted
2.3 Font support
Helvetica 10-point proportional font
8x16 proportional font
8x8 proportional font
Fixed 5x7 proportional font
Windows FreeSystem 14x16 Font
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 3 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
3. IRD platform
The Industrial Reference Design (IRD) v2.0 is a platform targeted at RTOS based
embedded systems. Designed around a flexible Core and Base printed circuit board
(PCB) concept, it features many of the system functions and wired communications
protocols found in today's embedded applications. The examples provided with this
SWIM library are developed for use with the LPC2478 core board module.
Fig 1. IRD platform
3.1 Description of IRD board setup
The IRD 2.0 platform should come preassembled with the LPC2478 core board installed
and the Toshiba LCD module attached. If not, refer to the IRD User’s Manual to
assemble them properly. There are no jumpers to configure that affect the example code
for this platform.
The IRD 2.0 2478 board has either 8 MB, 16 MB, or 32 MB external SDRAM using a
64 Mbit, 128 Mbit, or 256 Mbit x 32 SDRAM device in U6 respectively:
MT48LC2M32B2 (64 Mbit SDRAM, 32-bit databus) from Micron (default)
MT48LC4M32B2 (128 Mbit SDRAM, 32-bit databus) from Micron (option)
MT48LC8M32B2 (256 Mbit SDRAM, 32-bit databus) from Micron (option)
The supplied example is setup for the 64 Mbit (8 MB) Micron SDRAM configuration.
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 4 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
For other versions of the core board it will be necessary to modify the SDRAM
initialization code in the "ex_sdram.c" file. This SDRAM memory will be used as the LCD
frame buffer memory for this example. The SDRAM memory resides at address:
0xA000 0000 - 0xA07F FFFFF using DYNCS0 (8 MB, 2Mx32)
Using the 240x320 16bpp RGB1:5:5:5 mode, the frame buffer uses 150 kB of SDRAM
starting at address 0xA0000000.
The parameters for the Toshiba LCD panel are configured in lcd_params.c; this panel is
configured for operation in 1:5:5:5 mode.
3.2 Rowley project description
3.2.1 Description
Draws color bars and text on the LCD using the SWIM library with LCD in RGB1:5:5:5
mode.
3.2.2 Required hardware
IRD 2.0 2478 Evaluation board w/Toshiba LTA057A347F 5.7" 320x240 LCD module.
3.2.3 Required software
Rowley CrossStudio for ARM v1.5 or newer.
Rowley CrossConnect for ARM or other supported debugger.
3.2.4 Usage
1. Start Rowley CrossStudio for ARM and open the example solution file.
Select File->Open Solution->
Open the following solution: LPC2478_SWIM_Example.hzp
2. Build the solution.
Build->Build Solution
3. Attach your CrossConnect debugger to the IRD 2.0 board and PC, then connect to it.
Targets->Connect USB CrossConnect for ARM
4. Download the program into flash.
Debug->Start Debugging (F5)
5. Run the program!
Debug->Go (F5)
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 5 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
3.3 IAR EWARM project description
3.3.1 Description
Draws color bars and text on the LCD using the SWIM library with LCD in RGB1:5:5:5
mode.
3.3.2 Required hardware
IRD 2.0 2478 Evaluation board w/Toshiba LTA057A347F 5.7" 320x240 LCD module
3.3.3 Required software
IAR Embedded Workbench for ARM (EWARM) v5.x or newer
3.3.4 Usage
1. Start IAR Embedded Workbench for ARM and open the example workspace space.
File->Open->Workspace...
Open the following workspace: 2478_swim_example.eww
2. Build the project.
Project->Rebuild All
3. Attach your JLink JTAG unit to the EA-2478 board and PC.
4. Download the program into flash.
Project->Download and Debug (Ctrl+D)
5. Run the program!
Debug->Go (F5)
3.4 Keil MDK project description
3.4.1 Description
Draws color bars and text on the LCD using the SWIM library with LCD in RGB1:5:5:5
mode.
3.4.2 Required hardware
IRD 2.0 2478 Evaluation board w/Toshiba LTA057A347F 5.7" 320x240 LCD module.
3.4.3 Required software
Keil uVision v3.x or newer. Code should compile on evaluation version.
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 6 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
3.4.4 Usage
1. Start Keil uVision3 for ARM and open the example project file.
Project->Open Project...
Open the following project: ea_lcd.Uv2
2. Build the project.
Project->Build Target
3. Attach your ULink2 JTAG unit to the IRD 2.0 board and PC.
4. Download the program into flash.
Debug->Start/Stop Debug Session (Ctrl+F5)
5. Run the program!
Debug->Run (F5)
4. LPC2478 EA board
Embedded Artists' LPC2478 OEM Board (mounted on the QVGA OEM Base Board with
touch panel) lets you get up-and-running quickly with NXP's ARM7TDMI LPC24xx
microcontroller series.
The OEM board has SODIMM format and is only 66x48 mm. All processor signals are
available on the 200-pin connector for easy expansion. The board can be used in OEM
applications, as well as for educational purposes, experiments, and prototype projects.
Fig 2. EA LPC2478 platform
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 7 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
4.1 Description of EA LPC2478 board setup
The EA-2478 board should come preassembled with the LPC2478 core board installed
and the Truly LCD module attached. If not, refer to the EA-2478 User’s Manual to
assemble them properly.
The jumpers can be left in the default position when shipped from the factory. The
jumpers on this board are not labeled with the standard “J1” labels but only descriptive
labels. The ones that matter for the example projects are:
Int/Ext display – set to internal display
Enable LCD – installed
16 bit / 24 bit RGB data – set to 16 bit
Backlight shutdown – removed
Enable JTAG – installed
The EA-2478 board has either 32 MB or 16 MB of external SDRAM using a x16 or a x32
SDRAM device in U9 or U13 respectively:
K4S561632H-UC75 (256 Mbit SDRAM, 16-bit databus) from Samsung
(LPC2478-16 OEM Board)
K4M563233G-HN75 (256 Mbit Mobile SDRAM, 32-bit databus) from Samsung
(v1.0 of LPC2478-32 OEM Board)
MT48LC8M32B2B5-7 (256 Mbit SDRAM, 32-bit databus) from Micron
(v1.1a of LPC2478-32 OEM Board)
This example is setup for the x32 Micron SDRAM configuration, v1.1a of the LPC2478-
32 core board. For other versions of the core board it may be necessary to modify the
SDRAM initialization code in the "ex_sdram.c" file. The SDRAM memory will be used as
the LCD frame buffer memory for this example. The SDRAM memory resides at address:
0xA0000000 - 0xA1FFFFFF using DYNCS0 (32 MB, 8Mx32)
In 240x320 16bpp RGB1:5:5:5 mode, the frame buffer uses 150 kB starting at:
0xA0000000 within the SDRAM.
The Truly LCD module on the EA-2478 board contains a complete LCD controller
module with its own frame buffer as well as a hardware touchscreen controller. The
example presented disables the LCD controller and frame buffer on the Truly module and
places the LCD module into a dumb RGB1:5:5:5 mode. The SPI interface to the module
is used to program the module into this mode. The parameters for the Truly LCD panel
are configured in lcd_params.c.
4.2 Rowley project description
4.2.1 Description
Draws color bars on the LCD using the SWIM library with LCD in RGB1:5:5:5 mode.
4.2.2 Required hardware
EA-2478 Evaluation board w/Truly LCD module in RGB1:5:5:5 mode
Rowley CrossConnect for ARM or other supported debugger
4.2.3 Required software
Rowley Crossworks for ARM v1.5 or newer
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 8 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
4.2.4 Usage
1. Start Rowley CrossStudio for ARM and open the example solution file.
Select File->Open Solution
Open the following solution: EAC2478_SWIM_Example.hzp
2. Build the solution.
Build->Build Solution
3. Attach your CrossConnect debugger to the EA-2478 board and PC, then connect to
it.
Targets->Connect USB CrossConnect for ARM
4. Download the program into flash.
Debug->Start Debugging (F5)
5. Run the program!
Debug->Go (F5)
4.3 IAR EWARM project description
4.3.1 Description
Draws color bars on the LCD using the SWIM library with LCD in RGB1:5:5:5 mode.
4.3.2 Required hardware
EA-2478 Evaluation board w/Truly LCD module
4.3.3 Required software
IAR Embedded Workbench for ARM (EWARM) v5.x or newer
4.3.4 Usage
1. Start IAR Embedded Workbench for ARM and open the example workspace space.
File->Open->Workspace...
Open the following workspace: ea2478_swim_example.eww
2. Build the project
Project->Rebuild All
3. Attach JLink JTAG unit to the EA-2478 board and PC
4. Download the program into flash
Project->Download and Debug (Ctrl+D)
5. Run the program!
Debug->Go (F5)
4.4 Keil MDK project description
4.4.1 Description
Draws color bars and text on the LCD using the SWIM library with LCD in RGB1:5:5:5
mode.
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 9 of 20

NXP Semiconductors AN10815
SWIM: NXP's basic graphics library for LPC products
4.4.2 Required hardware
EA-2478 Evaluation board w/Truly LCD module.
4.4.3 Required software
Keil uVision v3.x or newer. Tested with Evaluation version of MDK.
4.4.4 Usage
1. Start Keil uVision3 for ARM and open the example project file.
Project->Open Project...
Open the following project: ea_lcd.Uv2
2. Build the project.
Project->Build Target
3. Attach ULink2 JTAG unit to the EA-2478 board and PC.
4. Download the program into flash.
Debug->Start/Stop Debug Session (Ctrl+F5)
5. Run the program!
Debug->Run (F5)
5. LPC3250 Phytec
The LPC3250 Phytec system is made up from three boards: the phyCORE-
ARM9/LPC3250 System on Module (PCM-040), the phyCORE-ARM9/LPC3250 Carrier
Board (PCM-967), and a optional add-on LCD - Hitachi 3.5" QVGA TFT-LCD with
integrated touch on adapter board (KLCD-011). The complete system is shown in Fig 3.
Fig 3. Phytec LPC3250 Platform
The phyCORE-LPC3250 module is populated with the NXP LPC3250. State-of-the-art
power management, Vector Floating Point Unit (VFP), and rich peripherals such as USB
OTG, Ethernet, and integrated LCD controller make this device the ideal candidate for
embedded applications requiring high performance and low power consumption. The on-
board MMU supports major operating systems, including Linux and Windows Embedded
CE. Other chip-level features include 7 UARTs, SPI, I2C, a real-time clock with a
AN10815 © NXP B.V. 2011. All rights reserved.
Application note Rev. 3 — 15 June 2011 10 of 20