Nios® II Software Developer Handbook

ID 683525
Date 8/28/2023
Public
Document Table of Contents

9.2.8. Upgrading to the Enhanced HAL Interrupt API

If you have custom device drivers, Intel FPGA recommends that you upgrade them to use the enhanced HAL interrupt API. The enhanced API maintains compatibility with the IIC, while supporting external interrupt controllers. The legacy HAL interrupt API is deprecated.

If you plan to use an EIC, you must upgrade your custom driver to the enhanced HAL interrupt API.

Upgrading your device driver is very simple, requiring only minor changes to some function calls.

For more information and details of the API functions, refer to the "HAL API Reference" chapter.

Table 43.  HAL Interrupt Legacy and Enhanced API Functions to
Legacy API Function Enhanced API Function
alt_irq_register() alt_ic_isr_register()
alt_irq_disable() alt_ic_irq_disable()
alt_irq_enable() alt_ic_irq_enable()

If your upgraded driver might need to function in a BSP with legacy drivers, code it to support both APIs.

For more information, refer to the “Supporting Multiple Interrupt APIs” chapter.