rev. 0.1 2/12 copyright ? 2012 by silicon laboratories AN673 AN673 p recision 32? s oftware d evelopment k it o verview 1. introduction the precision32? software development kit (sdk) provi des a means for easy and rapid code development for silicon labs 32-bit mcus. th e sdk consists of three parts: the silic on labs hardware access layer (hal), code examples, and the si32library. each of these parts is discu ssed in more detail in the ap plication notes listed in ?2. relevant documentation?. the sdk is installed with the precision32 software packa ge available at www.silabs.com/32bit-software. the sdk sits in the si32-x.y folder in the installa tion directory, were x is the major sdk version and y is the minor sdk version. this enables newer versions of the sdk to resi de in parallel with older ve rsions and not overwrite any previously working project source. the sdk is part of the precision32 development suite. figure 1 shows the sdk system. figure 1. software development kit (sdk) system 2. relevant documentation precision32 application notes are listed on th e following website: www .silabs.com/32bit-mcu. ?? an664: precision32? cmsis and hal user?s guide ?? an668: precision32? software deve lopment kit code examples overview ?? an670: getting started wit h the silicon labs pr ecision32? appbuilder ?? an672: precision32? si32library overview ?? an675: precision32? de velopment suite overview callback cmsis rtos si32library application cmsis coresupport (from arm) cmsis devicesupport (from silicon labs) code examples hardware
AN673 2 rev. 0.1 3. hardware access layer cmsis is the cortex microcontroller software interfac e standard, and the hardware access layer (hal) is a defined part of this standard. the hal provides an access layer for the sim3xxxx device registers. the functions and macros are non-blocking and simple; they cannot return error codes, so they are de signed to never fail. the hal is designed to replace the individual bit field accesses of the module with a function name that describes the action the bit is controlling. note: hal functions and macros are not designed to be thread-s afe. these routines do not disable interrupts during non- monotonic register modifications. the hal sits one layer above the hardware and is the only code that accesses the regi sters directly. more complex firmware systems like a real time operating system (rto s) or code example call th e hal and cmsis routines. 4. code examples the code examples are simple and co mplete examples that illustrate a nd highlight the peripheral modes and features using the hal. they are also modular so code ca n be copied into an application base, making peripheral- specific code development easy. 5. si32library a 32-bit platform with large memory enables a big and complex firmware system on the device. this complexity can slow development, as firmware consists of more layers with interweaving tasks and threads that are more difficult to create and debug. the si32library is a set of flexible, reusable, and portable source modules enabling core application level functionality for silicon laboratories 32-bit precision32? mcus. it includes facilities for debug logging, memory allocation, data collections, data transfers, and coo perative multitasking. the si32library package provides working abstractions of the hardware layer, reduces coding effort, and provides structure to aid and speed up top- layer application development.
AN673 rev. 0.1 3 n otes :
AN673 4 rev. 0.1 c ontact i nformation silicon laboratories inc. 400 west cesar chavez austin, tx 78701 tel: 1+(512) 416-8500 fax: 1+(512) 416-9669 toll free: 1+(877) 444-3032 please visit the silicon labs technical support web page: https://www.silabs.com/support/pages/contacttechnicalsupport.aspx and register to submit a technical support request. silicon laboratories and silicon labs are trademarks of silicon laboratories inc. other products or brandnames mentioned herein are trademarks or registered trademarks of their respective holders. the information in this document is believed to be accurate in all respects at the time of publication but is subject to change without notice. silicon laboratories assumes no responsibility for errors and omissions, and disclaims responsib ility for any consequences resu lting from the use of information included herein. a dditionally, silicon laboratorie s assumes no responsibility for the functioning of und escribed features or parameters. silicon laboratories reserves the right to make changes without further notice . silicon laboratories makes no wa rranty, rep- resentation or guarantee regarding the suitability of its products for any particular purpose, nor does silicon laboratories as sume any liability arising out of the application or use of any product or circuit, and s pecifically disclaims any an d all liability, including wi thout limitation conse- quential or incidental damages. silicon laborat ories products are not designed, intended, or authorized for use in applications intended to support or sustain life, or for any other application in which the failure of the silicon laboratories product could create a s ituation where per- sonal injury or death may occur. should buyer purchase or us e silicon laboratories products for any such unintended or unauthor ized ap- plication, buyer shall indemnify and hold silicon laboratories harmless against all claims and damages.
|
