Embedded Peripherals IP User Guide

ID 683130
Date 10/24/2025
Public
Document Table of Contents
1. Introduction 2. Avalon® -ST Serial Peripheral Interface Core 3. SPI Core 4. SPI Agent/JTAG to Avalon® Host Bridge Cores 5. Intel eSPI Agent Core 6. eSPI to LPC Bridge Core 7. Ethernet MDIO Core 8. Intel FPGA 16550 Compatible UART Core 9. UART Core 10. Lightweight UART Core 11. JTAG UART Core 12. Intel FPGA Avalon® Mailbox Core 13. Intel FPGA Avalon® Mutex Core 14. Intel FPGA Avalon® I2C (Host) Core 15. Intel FPGA I2C Agent to Avalon® -MM Host Bridge Core 16. EPCS/EPCQA Serial Flash Controller Core 17. Intel FPGA Serial Flash Controller Core 18. Intel FPGA Serial Flash Controller II Core 19. Intel FPGA Generic QUAD SPI Controller Core 20. Intel FPGA Generic QUAD SPI Controller II Core 21. Interval Timer Core 22. Intel FPGA Avalon FIFO Memory Core 23. On-Chip Memory (RAM and ROM) Intel FPGA IP 24. On-Chip Memory II (RAM or ROM) Intel FPGA IP 25. PIO Core 26. PLL Cores 27. DMA Controller Core 28. Modular Scatter-Gather DMA Core 29. Scatter-Gather DMA Controller Core 30. Video Sync Generator and Pixel Converter Cores 31. Intel FPGA Interrupt Latency Counter Core 32. Performance Counter Unit Core 33. Vectored Interrupt Controller Core 34. System ID Peripheral Core 35. Intel FPGA GMII to RGMII Converter Core 36. HPS GMII to RGMII Adapter IP 37. Intel FPGA MII to RMII Converter Core 38. HPS GMII to TSE 1000BASE-X/SGMII PCS Bridge Core IP 39. Intel FPGA HPS EMAC to Multi-rate PHY GMII Adapter Core 40. Intel FPGA MSI to GIC Generator Core 41. Cache Coherency Translator IP 42. Altera ACE5-Lite Cache Coherency Translator

9.4.1.1.1. UART API

Table 80.  altera_avalon_uart_close altera_avalon_uart_close is not available for small driver.
Prototype int altera_avalon_uart_close(altera_avalon_uart_state* sp, int flags);
Include <altera_avalon_uart.h>
Parameters
  • sp - the UART device to close
  • flags - for indicating blocking/non-blocking access for single/multi-threaded
Returns None
Description Closes UART device
Table 81.  altera_avalon_uart_read
Prototype int altera_avalon_uart_read(altera_avalon_uart_state* sp, char* ptr, int len, int flags);
Include <altera_avalon_uart.h>
Parameters
  • sp - the UART device
  • ptr - destination address
  • len - maximum length of the data
  • flags - for indicating blocking/non-blocking access for single/multi-threaded
Returns Number of bytes read
Description Reads data to the UART receiver buffer
Table 82.  altera_avalon_uart_write
Prototype int altera_avalon_uart_write(altera_avalon_uart_state* sp, char* ptr, int len, int flags);
Include <altera_avalon_uart.h>
Parameters
  • sp - the UART device
  • ptr - source address
  • len - maximum length of the data
  • flags - for indicating blocking/non-blocking access for single/multi-threaded
Returns Number of bytes written
Description Writes data to the UART receiver buffer
Table 83.  altera_avalon_uart_irq altera_avalon_uart_irq is not available for small driver.
Prototype static void altera_avalon_uart_irq(void* context)
Include <altera_avalon_uart.h>
Parameters
  • context - the UART device
Returns None
Description Interrupt handler to process UART interrupts to process receiver/transmitter interrupts
Table 84.  altera_avalon_uart_rxirq altera_avalon_uart_rxirq is not available for small driver.
Prototype static void altera_avalon_uart_rxirq(altera_avalon_uart_state* sp, alt_u32 status)
Include <altera_avalon_uart.h>
Parameters
  • sp - the UART device
  • status - individual bits that indicate conditions inside the UART core
Returns None
Description Process a receive interrupt. It transfers the incoming character into the receiver circular buffer and sets the appropriate flags to indicate that there is data ready to be processed
Table 85.  altera_avalon_uart_txirq altera_avalon_uart_txirq is not available for small driver.
Prototype static void altera_avalon_uart_txirq(altera_avalon_uart_state* sp, alt_u32 status)
Include <altera_avalon_uart.h>
Parameters
  • sp - the UART device
  • status - individual bits that indicate conditions inside the UART core
Returns None
Description Process a transmit interrupt. It transfers data from the transmit buffer to the device and sets the appropriate flags to indicate that there is data ready to be processed