Support for the emWin GUI library from Segger.

Dependents:   lpc4088_displaymodule_emwin

This library contains the porting layer needed to start working with emWin from Segger. Details about emWin can be found both segger.com as well as lpcware.com.

The high performance emWin embedded graphics library developed by SEGGER Microcontroller is now offered by NXP Semiconductors in library form for free commercial use with NXP microcontrollers.

For a better description of what is included and the limitations, see emWin Graphics Library.

Note

The emWin library and PNG support files must be downloaded as the downloaders contains the license info. The steps are described in the readme.h file.

Committer:
embeddedartists
Date:
Fri Mar 27 15:27:47 2015 +0100
Revision:
1:2847cc35a84f
Parent:
0:582739e02e4d
- Updated the readme.txt file with links to the wiki and added some information
regarding LPCXpresso

Who changed what in which revision?

UserRevisionLine numberNew contents of line
alindvall 0:582739e02e4d 1 /* (Had to make this README file .h to get it exportable in mbed)
alindvall 0:582739e02e4d 2
embeddedartists 1:2847cc35a84f 3
embeddedartists 1:2847cc35a84f 4 There is a better formatted version of this guide with better explanations:
embeddedartists 1:2847cc35a84f 5
embeddedartists 1:2847cc35a84f 6 http://developer.mbed.org/teams/Embedded-Artists/wiki/LPC4088DM-Guide-to-Working-with-emWin
embeddedartists 1:2847cc35a84f 7
embeddedartists 1:2847cc35a84f 8
alindvall 0:582739e02e4d 9 emWin Graphical Library
alindvall 0:582739e02e4d 10 -----------------------
alindvall 0:582739e02e4d 11 According to http://www.lpcware.com/content/project/emwin-graphics-library:
alindvall 0:582739e02e4d 12
alindvall 0:582739e02e4d 13 "The high performance emWin embedded graphics library developed by SEGGER
alindvall 0:582739e02e4d 14 Microcontroller is now offered by NXP Semiconductors in library form for
alindvall 0:582739e02e4d 15 free commercial use with NXP microcontrollers."
alindvall 0:582739e02e4d 16
alindvall 0:582739e02e4d 17 Follow the link above to read more about the graphical library and available
alindvall 0:582739e02e4d 18 features.
alindvall 0:582739e02e4d 19
alindvall 0:582739e02e4d 20 NOTE: The emWin library cannot be used in the online compiler for legal
alindvall 0:582739e02e4d 21 reasons. You have to export the project and then follow the instructions
alindvall 0:582739e02e4d 22 below to download emWin and then modify your local project.
alindvall 0:582739e02e4d 23
alindvall 0:582739e02e4d 24 How to get it
alindvall 0:582739e02e4d 25 -------------
alindvall 0:582739e02e4d 26 The library must be downloaded from the page above and at the time this
alindvall 0:582739e02e4d 27 document was written the latest version was emWin 5.24h with the direct
alindvall 0:582739e02e4d 28 link: http://www.lpcware.com/system/files/NXP_emWin524h_libraries.exe
alindvall 0:582739e02e4d 29
alindvall 0:582739e02e4d 30 Download the executable, run it and have it extract the files to the emwin/
alindvall 0:582739e02e4d 31 folder. After extracting the archive, the emwin/ folder should contain the
alindvall 0:582739e02e4d 32 following:
alindvall 0:582739e02e4d 33
alindvall 0:582739e02e4d 34 emWin_Config\
alindvall 0:582739e02e4d 35 emWin_header\
alindvall 0:582739e02e4d 36 emWin_library\
alindvall 0:582739e02e4d 37 readme.txt
embeddedartists 1:2847cc35a84f 38
embeddedartists 1:2847cc35a84f 39 Delete the emWin_Config\ folder as it is not needed
embeddedartists 1:2847cc35a84f 40
alindvall 0:582739e02e4d 41 The the 5.24h version (and possibly other later versions as well) is missing
alindvall 0:582739e02e4d 42 PNG support but the manual (available on the linked page above) has instructions
alindvall 0:582739e02e4d 43 on how to add it. Download www.segger.com/link/emwin_png.zip and extract it
alindvall 0:582739e02e4d 44 into the png/ folder. After extracting the folder should contain one or more
alindvall 0:582739e02e4d 45 version folders. This is what the png/ folder may look like:
alindvall 0:582739e02e4d 46
alindvall 0:582739e02e4d 47 emWin_V5.18/
alindvall 0:582739e02e4d 48 emWin_V5.28/
alindvall 0:582739e02e4d 49
alindvall 0:582739e02e4d 50 Delete the version that you don't need (probably the oldest one).
alindvall 0:582739e02e4d 51
alindvall 0:582739e02e4d 52 Updating the project
alindvall 0:582739e02e4d 53 --------------------
alindvall 0:582739e02e4d 54 When this project was exported it did not have the correct paths and files
embeddedartists 1:2847cc35a84f 55 needed by emWin (for licence reasons). This is what you have to do in your
alindvall 0:582739e02e4d 56 IDE to get it to work:
alindvall 0:582739e02e4d 57
alindvall 0:582739e02e4d 58 Keil uVision 4:
alindvall 0:582739e02e4d 59 ==============
alindvall 0:582739e02e4d 60 1) Open the project
alindvall 0:582739e02e4d 61 2) Select the Project->Manage menu
alindvall 0:582739e02e4d 62 3) Add a new Group "emLib"
alindvall 0:582739e02e4d 63 4) Add all DMemWin/png/emWin_V5.28/GUI/PNG/*.c files "emLib" group
alindvall 0:582739e02e4d 64 5) Add DMemWinGUI/emwin/emWin_library/Keil/emWin_M4.lib to the "emLib" group
alindvall 0:582739e02e4d 65 6) Close the dialog
alindvall 0:582739e02e4d 66
alindvall 0:582739e02e4d 67 NXP LPCXpresso IDE:
alindvall 0:582739e02e4d 68 ==================
alindvall 0:582739e02e4d 69 1) Open the workspace
alindvall 0:582739e02e4d 70 2) Import the project from the exported zip file
alindvall 0:582739e02e4d 71 3) Right-click on the DMemWin folder in the Project Explorer and select Refresh...
embeddedartists 1:2847cc35a84f 72 4) Right-click on the project name and select Properties...
embeddedartists 1:2847cc35a84f 73 a) "C/C++ General" -> "Paths and Symbols" and select the "Library Paths" tab.
embeddedartists 1:2847cc35a84f 74 b) Click the Add button
embeddedartists 1:2847cc35a84f 75 c) Copy-paste the following into the dialog box:
embeddedartists 1:2847cc35a84f 76
embeddedartists 1:2847cc35a84f 77 /${ProjName}/DMemWin/emwin/emWin_library/LPCXpresso
embeddedartists 1:2847cc35a84f 78
embeddedartists 1:2847cc35a84f 79 d) Make sure that the "Is a workspace path" option is selected and click OK
embeddedartists 1:2847cc35a84f 80 e) Switch to the Libraries tab
embeddedartists 1:2847cc35a84f 81 f) Click the Add button
embeddedartists 1:2847cc35a84f 82 g) Copy-paste the following into the dialog box:
embeddedartists 1:2847cc35a84f 83
embeddedartists 1:2847cc35a84f 84 emWin_M4
embeddedartists 1:2847cc35a84f 85
embeddedartists 1:2847cc35a84f 86 h) Click the OK button until all dialogs are closed.
embeddedartists 1:2847cc35a84f 87
alindvall 0:582739e02e4d 88 Other IDEs:
alindvall 0:582739e02e4d 89 ==========
alindvall 0:582739e02e4d 90 Do the corresponding actions for your IDE but remember to use the correct
alindvall 0:582739e02e4d 91 library file.
alindvall 0:582739e02e4d 92
alindvall 0:582739e02e4d 93 If the IDE doesn't get the paths correct by the exporter then you might have
alindvall 0:582739e02e4d 94 to add the following to the include path:
alindvall 0:582739e02e4d 95
alindvall 0:582739e02e4d 96 DMemWin/emwin/emWin_header/
alindvall 0:582739e02e4d 97
alindvall 0:582739e02e4d 98 */