Xilinx Standalone Library Documentation OS and Libraries Document Collection UG643 (2019.2) December 9, 2019 Table of Contents Chapter 1: Xilinx OS and Libraries Overview About the Libraries .................................... 19 Library Organization.................................... 19 Xilinx Standard C Libraries Chapter 2: Xilinx Standard C Libraries Overview .......................................... 21 Standard C Library (libc.a) ................................ 21 Xilinx C Library (libxil.a).................................. 22 Memory Management Functions............................. 22 Arithmetic Operations................................... 22 MicroBlaze Processor ................................. 22 Thread Safety ..................................... 23 Input/Output Functions .................................. 23 Overview ........................................ 23 Function Documentation................................ 24 Standalone Library (v7.1 ) Chapter 3: Xilinx Hardware Abstraction Layer API Overview .......................................... 27 Assert APIs......................................... 27 Overview ........................................ 27 Macro Definition Documentation............................ 28 Typedef Documentation ................................ 29 Function Documentation................................ 29 Variable Documentation ................................ 30 IO interfacing APIs..................................... 31 Overview ........................................ 31 OS and Libraries Document Collection www.xilinx.com 2 UG643 (2019.2) December 9, 2019 Send Feedback Function Documentation . 31 Definitions for available xilinx platforms . 38 Overview . 38 Function Documentation . 38 Data types for Xilinx Software IP Cores . 39 Overview . 39 Macro Definition Documentation . 40 Typedef Documentation . 41 Customized APIs for memory operations . 42 Overview . 42 Function Documentation . 42 Xilinx software status codes . 43 Overview . 43 Test utilities for memory and caches . 43 Overview . 43 Macro Definition Documentation . 44 Function Documentation . 45 Chapter 4: Microblaze Processor API Overview . 49 Microblaze Pseudo-asm Macros and Interrupt handling APIs . 49 Overview . 49 Macro Definition Documentation . 50 Function Documentation . 51 Microblaze exception APIs . 52 Overview . 52 Data Structure Documentation . 52 Typedef Documentation . 52 Function Documentation . 53 Microblaze Processor Cache APIs . 54 Overview . 54 Macro Definition Documentation . 55 Function Documentation . 59 MicroBlaze Processor FSL Macros . 60 Overview . 60 Macro Definition Documentation . 60 Microblaze PVR access routines and macros . 63 Overview . 63 Macro Definition Documentation . 64 OS and Libraries Document Collection www.xilinx.com 3 UG643 (2019.2) December 9, 2019 Send Feedback Function Documentation . 73 Sleep Routines for Microblaze . 74 Overview . 74 Function Documentation . 74 Chapter 5: Cortex R5 Processor API Overview . 75 Cortex R5 Processor Boot Code . 75 Overview . 75 Cortex R5 Processor MPU specific APIs . 76 Overview . 76 Function Documentation . 77 Cortex R5 Processor Cache Functions . 78 Overview . 78 Function Documentation . 79 Cortex R5 Time Functions . 84 Overview . 84 Function Documentation . 84 Cortex R5 Event Counters Functions . 85 Overview . 85 Function Documentation . 86 Cortex R5 Processor Specific Include Files . 86 Overview . 86 Chapter 6: ARM Processor Common API Overview . 87 ARM Processor Exception Handling . 87 Overview . 87 Macro Definition Documentation . 88 Typedef Documentation . 89 Function Documentation . 90 Chapter 7: Cortex A9 Processor API Overview . 93 Cortex A9 Processor Boot Code . 93 Overview . 93 Cortex A9 Processor Cache Functions . 95 Overview . 95 Function Documentation . 96 Cortex A9 Processor MMU Functions . 110 OS and Libraries Document Collection www.xilinx.com 4 UG643 (2019.2) December 9, 2019 Send Feedback Overview . 110 Function Documentation . 110 Cortex A9 Time Functions . 111 Overview . 111 Function Documentation . 111 Cortex A9 Event Counter Function . 112 Overview . 112 Function Documentation . 113 PL310 L2 Event Counters Functions . 113 Overview . 113 Function Documentation . 114 Cortex A9 Processor and pl310 Errata Support . 115 Overview . 115 Macro Definition Documentation . 115 Cortex A9 Processor Specific Include Files . 116 Chapter 8: Cortex A53 32-bit Processor API Overview . 117 Cortex A53 32-bit Processor Boot Code . 117 Overview . 117 Cortex A53 32-bit Processor Cache Functions . 119 Overview . 119 Function Documentation . 119 Cortex A53 32-bit Processor MMU Handling . 124 Overview . ..