Contents

Notice to Development Tools Customers

1.1. Conventions Used in This Guide

1.2. Recommended Reading

2. Libraries Overview

2.1. OMF-Specific Libraries and Startup Modules

2.2. Startup Code

2.3. DSP Library

2.4. 16-Bit Peripheral Libraries

2.5. Standard C Libraries with Math and Support Functions

2.6. Fixed-Point Math Functions

2.7. Compiler Built-in Functions

3. Standard C and Math Libraries

3.1. Using the Standard C and Math Libraries

3.2. List of Standard C and Math Library Functions

4. Support Libraries

4.1. Rebuilding the libpic30 Library

4.2. Standard C Library Helper Functions

4.3. Standard C Library Functions That Require Modification

4.4. Functions/Constants to Support A Simulated UART

4.4.1. __C30_UART Constant

4.4.2. __attach_input_file Function

4.4.3. __close_input_file Function

4.4.4. __delay32 Function

4.4.5. __delay_ms Function

4.4.6. __delay_us Function

4.5. Functions for Erasing and Writing EEDATA Memory

4.5.1. _erase_eedata Function

4.5.2. _erase_eedata_all Function

4.5.3. _wait_eedata Function

4.5.4. _write_eedata_row Function

4.5.5. _write_eedata_word Function

4.6. Functions for Erasing and Writing Flash Memory

4.6.1. _erase_flash Function

4.6.2. _erase_flash (PIC24FXXKA Only) Function

4.6.3. _write_flash16 Function

4.6.4. _write_flash24 Function

4.6.5. _write_flash_word16 Function

4.6.6. _write_flash_word24 Function

4.6.7. _write_flash_word32 Function

4.6.8. _write_flash_word48 Function

4.7. Functions for Specialized Copying and Initialization

4.7.1. _init_prog_address Macro

4.7.2. _memcpy_eds Function

4.7.3. _memcpy_p2d16 Function

4.7.4. _memcpy_p2d24 Function

4.7.5. _memcpy_packed Function

4.7.6. _strcpy_eds Function

4.7.7. _strcpy_packed Function

4.7.8. _strncpy_eds Function

4.7.9. _strncpy_p2d16 Function

4.7.10. _strncpy_p2d24 Function

4.7.11. _strncpy_packed Function

4.8. Functions to Support Secondary Core PRAM

4.8.1. _wipe_secondary Function

4.8.2. _program_secondary Function

4.8.3. _program_inactive_secondary Function

4.8.4. _start_secondary and _stop_secondary Functions

5. Fixed-Point Math Functions

5.1. Overview of Fixed-Point Data Formats

5.2. Using the Fixed-Point Libraries

5.3. <libq.h> Mathematical Functions

5.3.1. _Q15abs Function

5.3.2. _Q15acos Function

5.3.3. _Q15acosByPI Function

5.3.4. _Q15add Function

5.3.5. _Q15asin Function

5.3.6. _Q15asinByPI Function

5.3.7. _Q15atan Function

5.3.8. _Q15atanByPI Function

5.3.9. _Q15atanYByX Function

5.3.10. _Q15atanYByXByPI Function

5.3.11. _Q15atoi Function

5.3.12. _Q15cos Function

5.3.13. _Q15cosPI Function

5.3.14. _Q15exp Function

5.3.15. _Q15ftoi Function

5.3.16. _itoaQ15 Function

5.3.17. _itofQ15 Function

5.3.18. _Q15log Function

5.3.19. _Q15log10 Function

5.3.20. _Q15neg Function

5.3.21. _Q15norm Function

5.3.22. _Q15power Function

5.3.23. _Q15random Function

5.3.24. _Q15shl Function

5.3.25. _Q15shlNoSat Function

5.3.26. _Q15shr Function

5.3.27. _Q15shrNoSat Function

5.3.28. _Q15sin Function

5.3.29. _Q15sinPI Function

5.3.30. _Q15sinSeries Function

5.3.31. _Q15sqrt Function

5.3.32. _Q15sub Function

5.3.33. _Q15tan Function

5.3.34. _Q15tanPI Function

5.3.35. _Q16acos Function

5.3.36. _Q16acosByPI Function

5.3.37. _Q16asin Function

5.3.38. _Q16asinByPI Function

5.3.39. _Q16atan Function

5.3.40. _Q16atanByPI Function

5.3.41. _Q16atanYByX Function

5.3.42. _Q16atanYByXByPI Function

5.3.43. _Q16cos Function

5.3.44. _Q16cosPI Function

5.3.45. _Q16div Function

5.3.46. _Q16divmod Function

5.3.47. _Q16exp Function

5.3.48. _Q16ftoi Function

5.3.49. _itofQ16 Function

5.3.50. _Q16log Function

5.3.51. _Q16log10 Function

5.3.52. _Q16mac Function

5.3.53. _Q16macNoSat Function

5.3.54. _Q16mpy Function

5.3.55. _Q16neg Function

5.3.56. _Q16norm Function

5.3.57. _Q16power Function

5.3.58. _Q16random Function

5.3.59. _Q16reciprocalQ15 Function

5.3.60. _Q16reciprocalQ16 Function

5.3.61. _Q16shl Function

5.3.62. _Q16shlNoSat Function

5.3.63. _Q16shr Function

5.3.64. _Q16shrNoSat Function

5.3.65. _Q16sin Function

5.3.66. _Q16sinPI Function

5.3.67. _Q16sinSeries Function

5.3.68. _Q16tan Function

5.3.69. _Q16tanPI Function

6. Revision History

6.1. Revision P (January 2022)

6.2. Revision N (February 2021)

6.3. Revision M (July 2020)

6.4. Revision L (December 2019)

6.5. Revision K (February 2018)

6.6. Revision J (December 2014)

6.7. Revision H (September 2013)

6.8. Revision G (October 2010)

6.9. Revision F (March 2009)

6.10. Revision E (January 2008)

6.11. Revision D (December 2006)

6.12. Revision C (October 2005)

6.13. Revision B (September 2004)

6.14. Revision A (May 2004)

The Microchip Website

Product Change Notification Service

Customer Support

Microchip Devices Code Protection Feature

Quality Management System

Worldwide Sales and Service