MSP430 IAR C/C++ Compiler reference guide - Rice University

The DLIB runtime environmentThis will use your version of library_module.r43, instead of the one in the library.For information about the XLINK options, see the IAR Linker and Library ToolsReference Guide.Building and using a customized libraryIn some situations, see Situations that require library building, page 47, it is necessaryto rebuild the library. In those cases you need to:● Set up a library project● Make the required library modifications● Build your customized library● Finally, make sure your application project will use the customized library.Information about the build process is described in the MSP430 IAR EmbeddedWorkbench® IDE User Guide.Note: It is possible to build IAR Embedded Workbench projects from the commandline by using the IAR Command Line Build Utility (iarbuild.exe). However, nomake or batch files for building the library from the command line are provided.SETTING UP A LIBRARY PROJECTThe IAR Embedded Workbench IDE provides a library project template which can beused for customizing the runtime environment configuration. This library template hasfull library configuration, see Table 9, Library configurations, page 47.In the IAR Embedded Workbench IDE, modify the generic options in the created libraryproject to suit your application, see Basic settings for project configuration, page 5.Note: There is one important restriction on setting options. If you set an option on filelevel (file level override), no options on higher levels that operate on files will affect thatfile.MODIFYING THE LIBRARY FUNCTIONALITYYou must modify the library configuration file and build your own library if you wantto modify support for, for example, locale, file descriptors, and multibyte characters.This will include or exclude certain parts of the runtime environment.The library functionality is determined by a set of configuration symbols. The defaultvalues of these symbols are defined in the file Dlib_defaults.h. This read-only filedescribes the configuration possibilities. In addition, your library has its own libraryconfiguration file dl430libraryname.h, which sets up that specific library with fulllibrary configuration. For more information, see Table 12, Customizable items, page 50.Part 1. Using the compiler55