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:
alindvall
Date:
Fri Feb 27 11:39:47 2015 +0000
Revision:
0:582739e02e4d
Child:
1:2847cc35a84f
First version

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
alindvall 0:582739e02e4d 3 emWin Graphical Library
alindvall 0:582739e02e4d 4 -----------------------
alindvall 0:582739e02e4d 5 According to http://www.lpcware.com/content/project/emwin-graphics-library:
alindvall 0:582739e02e4d 6
alindvall 0:582739e02e4d 7 "The high performance emWin embedded graphics library developed by SEGGER
alindvall 0:582739e02e4d 8 Microcontroller is now offered by NXP Semiconductors in library form for
alindvall 0:582739e02e4d 9 free commercial use with NXP microcontrollers."
alindvall 0:582739e02e4d 10
alindvall 0:582739e02e4d 11 Follow the link above to read more about the graphical library and available
alindvall 0:582739e02e4d 12 features.
alindvall 0:582739e02e4d 13
alindvall 0:582739e02e4d 14 NOTE: The emWin library cannot be used in the online compiler for legal
alindvall 0:582739e02e4d 15 reasons. You have to export the project and then follow the instructions
alindvall 0:582739e02e4d 16 below to download emWin and then modify your local project.
alindvall 0:582739e02e4d 17
alindvall 0:582739e02e4d 18 How to get it
alindvall 0:582739e02e4d 19 -------------
alindvall 0:582739e02e4d 20 The library must be downloaded from the page above and at the time this
alindvall 0:582739e02e4d 21 document was written the latest version was emWin 5.24h with the direct
alindvall 0:582739e02e4d 22 link: http://www.lpcware.com/system/files/NXP_emWin524h_libraries.exe
alindvall 0:582739e02e4d 23
alindvall 0:582739e02e4d 24 Download the executable, run it and have it extract the files to the emwin/
alindvall 0:582739e02e4d 25 folder. After extracting the archive, the emwin/ folder should contain the
alindvall 0:582739e02e4d 26 following:
alindvall 0:582739e02e4d 27
alindvall 0:582739e02e4d 28 emWin_Config\
alindvall 0:582739e02e4d 29 emWin_header\
alindvall 0:582739e02e4d 30 emWin_library\
alindvall 0:582739e02e4d 31 readme.txt
alindvall 0:582739e02e4d 32
alindvall 0:582739e02e4d 33 The the 5.24h version (and possibly other later versions as well) is missing
alindvall 0:582739e02e4d 34 PNG support but the manual (available on the linked page above) has instructions
alindvall 0:582739e02e4d 35 on how to add it. Download www.segger.com/link/emwin_png.zip and extract it
alindvall 0:582739e02e4d 36 into the png/ folder. After extracting the folder should contain one or more
alindvall 0:582739e02e4d 37 version folders. This is what the png/ folder may look like:
alindvall 0:582739e02e4d 38
alindvall 0:582739e02e4d 39 emWin_V5.18/
alindvall 0:582739e02e4d 40 emWin_V5.28/
alindvall 0:582739e02e4d 41
alindvall 0:582739e02e4d 42 Delete the version that you don't need (probably the oldest one).
alindvall 0:582739e02e4d 43
alindvall 0:582739e02e4d 44 Updating the project
alindvall 0:582739e02e4d 45 --------------------
alindvall 0:582739e02e4d 46 When this project was exported it did not have the correct paths and files
alindvall 0:582739e02e4d 47 needed by emWin (for lisence reasons). This is what you have to do in your
alindvall 0:582739e02e4d 48 IDE to get it to work:
alindvall 0:582739e02e4d 49
alindvall 0:582739e02e4d 50 Keil uVision 4:
alindvall 0:582739e02e4d 51 ==============
alindvall 0:582739e02e4d 52 1) Open the project
alindvall 0:582739e02e4d 53 2) Select the Project->Manage menu
alindvall 0:582739e02e4d 54 3) Add a new Group "emLib"
alindvall 0:582739e02e4d 55 4) Add all DMemWin/png/emWin_V5.28/GUI/PNG/*.c files "emLib" group
alindvall 0:582739e02e4d 56 5) Add DMemWinGUI/emwin/emWin_library/Keil/emWin_M4.lib to the "emLib" group
alindvall 0:582739e02e4d 57 6) Close the dialog
alindvall 0:582739e02e4d 58
alindvall 0:582739e02e4d 59 NXP LPCXpresso IDE:
alindvall 0:582739e02e4d 60 ==================
alindvall 0:582739e02e4d 61 1) Open the workspace
alindvall 0:582739e02e4d 62 2) Import the project from the exported zip file
alindvall 0:582739e02e4d 63 3) Right-click on the DMemWin folder in the Project Explorer and select Refresh...
alindvall 0:582739e02e4d 64
alindvall 0:582739e02e4d 65 Other IDEs:
alindvall 0:582739e02e4d 66 ==========
alindvall 0:582739e02e4d 67 Do the corresponding actions for your IDE but remember to use the correct
alindvall 0:582739e02e4d 68 library file.
alindvall 0:582739e02e4d 69
alindvall 0:582739e02e4d 70 If the IDE doesn't get the paths correct by the exporter then you might have
alindvall 0:582739e02e4d 71 to add the following to the include path:
alindvall 0:582739e02e4d 72
alindvall 0:582739e02e4d 73 DMemWin/emwin/emWin_header/
alindvall 0:582739e02e4d 74
alindvall 0:582739e02e4d 75 */