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

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

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.

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)

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.

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

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

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.

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

Application note Rev. 3 — 15 June 2011 10 of 20

Table of contents

Other NXP Semiconductors Microcontroller manuals

NXP Semiconductors

NXP Semiconductors LPC1768 User manual

NXP Semiconductors

NXP Semiconductors MC68HC16Z1 User manual

NXP Semiconductors

NXP Semiconductors i.MX 8M User manual

NXP Semiconductors

NXP Semiconductors MPC5748G Low Cost EVB User manual

NXP Semiconductors

NXP Semiconductors MPC5777C User manual

NXP Semiconductors

NXP Semiconductors A71CLARD-BA User manual

NXP Semiconductors

NXP Semiconductors SLN-LOCAL2-IOT User manual

NXP Semiconductors

NXP Semiconductors MKL04Z8VFK4 User manual

NXP Semiconductors

NXP Semiconductors LPC43 Series User manual

NXP Semiconductors

NXP Semiconductors MPC574 P Series User manual

NXP Semiconductors

NXP Semiconductors UM10574 User manual

NXP Semiconductors

NXP Semiconductors Harpoon User manual

NXP Semiconductors

NXP Semiconductors LPC1102 User manual

NXP Semiconductors

NXP Semiconductors UM11483 User manual

NXP Semiconductors

NXP Semiconductors S32K324 User manual

NXP Semiconductors

NXP Semiconductors S12VR32EVB User manual

NXP Semiconductors

NXP Semiconductors LPC18xx series User manual

NXP Semiconductors

NXP Semiconductors IOTZTB-DK006 User manual

NXP Semiconductors

NXP Semiconductors FRDM-KW24D512 User manual

NXP Semiconductors

NXP Semiconductors S12ZVML-MINIKIT User manual

NXP Semiconductors

NXP Semiconductors LPC800 User manual

NXP Semiconductors

NXP Semiconductors freescale semiconductor CSM12D User manual

NXP Semiconductors

NXP Semiconductors UM11579 User manual

NXP Semiconductors

NXP Semiconductors UG10068 User manual

Popular Microcontroller manuals by other brands

AMS

AMS AS7261 Demo Kit user guide

Novatek

Novatek NT6861 manual

Espressif Systems

Espressif Systems ESP8266 SDK AT Instruction Set

Nuvoton

Nuvoton ISD61S00 ChipCorder Design guide

STMicrolectronics

STMicrolectronics ST7 Assembler Linker user manual

Texas Instruments

Texas Instruments Chipcon CC2420DK user manual

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM user guide

NEC

NEC 78GK0S/K 1+ Series Application note

Mikroe

Mikroe SEMITECH N-PLC Click Application note

Intel

Intel Agilex user guide

Cypress

Cypress CY4607 HX2VL quick start guide

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE manual

Texas Instruments

Texas Instruments TMS320F2837 D Series Workshop Guide and Lab Manual

CYPRES

CYPRES CY14NVSRAMKIT-001 user guide

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM user guide

Espressif Systems

Espressif Systems ESP8266EX Programming guide

Abov

Abov AC33M8128L user manual

Laird

Laird BL654PA user guide