Embedded Artists
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.
readme.h@1:2847cc35a84f, 2015-03-27 (annotated)
- 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?
| User | Revision | Line number | New 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 | */ |