User manual

678
mikoC PRO for PIC32
MikroElektronika
Creating New Library
mikroC PRO for PIC32 allows you to create your own libraries. In order to create a library in mikroC PRO for PIC32
follow the steps bellow:
1. Create a new source le, see Managing Source Files
2. Save the le in one of the subfolders of the compiler’s Uses folder:
DriveName:\Program Files\Mikroelektronika\mikroC PRO for PIC32\Uses\
3. Write a code for your library and save it.
4. Add __Lib_Example le in some project, see Project Manager. Recompile the project.
If you wish to use this library for all MCUs, then you should go to Tools › Options › Output settings, and check
Build all les as library box.
This will build libraries in a common form which will work with all MCUs. If this box is not checked, then library will
be built for selected MCU.
Bear in mind that compiler will report an error if a library built for specic MCU is used for another one.
5. Compiled le __Lib_Example.emcl should appear in ...\mikroC PRO for PIC32\Uses\ folder.
6. Open the denition le for the MCU that you want to use. This le is placed in the compiler’s Defs folder:
DriveName:\Program Files\Mikroelektronika\mikroC PRO for PIC32\Defs\
and it is named MCU_NAME.mlk, for example P32MX460F512L.mlk
7. Add the the following segment of code to <LIBRARIES> node of the denition le (denition le is in XML format):
<LIB>
<ALIAS>Example_Library</ALIAS>
<FILE>__Lib_Example</FILE>
<TYPE>REGULAR</TYPE>
</LIB>
8. Add Library to mlk le for each MCU that you want to use with your library.
9. Click Refresh button in Library Manager
10. Example_Library should appear in the Library manager window.
Multiple Library Versions
Library Alias represents unique name that is linked to corresponding Library .emcl le. For example UART library
for P32MX460F512L is different from UART library for P32MX675F512L MCU. Therefore, two different UART Library
versions were made, see mlk les for these two MCUs. Note that these two libraries have the same Library Alias
(UART) in both mlk les. This approach enables you to have identical representation of UART library for both MCUs
in Library Manager.
Related topics: Library Manager, Project Manager, Managing Source Files