• State TI Thinks Resolved
  • Locked Locked
  • Replies 1 reply
  • Answers 1 answer
  • Subscribers 30 subscribers
  • Views 512 views
  • Users 0 members are here
Support feedback
Options
Options
Related

This thread has been locked.

If you have a related question, please click the "Ask a related question" button in the top right corner. The newly created question will be automatically linked to this question.

SW-TM4C: What is difference between MAP_Function name and Function name in standard library function

Hiroyuki Kanematu
Expert 2975 points
Part Number: SW-TM4C

When I look at the functions, there are some with MAPs and some without, but I would like to know when to use the ones with MAPs.

  • 0
    TI__Guru*** 135355 points

    Hello Kanematu-san,

    The MAP APIs can be used to minimize code space by leveraging ROM APIs in the device. Because the ROM has not been updated from the original TivaWare release, the MAP APIs are best to use as our team maintains a very careful record of any API that has been altered from the original ROM image. If an API is altered since then, the Flash version of the API from the current TivaWare version will be used. If the API has not been changed at all, then the ROM version is used.

    For applications that are extremely time sensitive (very rare, very user specific), the MAP APIs also add overhead of a few cycles. Aside from that, there is no inherit disadvantage to using them. One other potential reason to avoid use is if there is anticipation that edits will be made directly to the TivaWare driver libraries, but again this is rare and very user specific.

    In summary, it's optional to use the MAP APIs but for the majority of users, it offers no tangible drawbacks and has the benefit of reducing the Flash footprint for a program.

    Best Regards,

    Ralph Jacobi