Por que a API Mailbox Client HAL está indisponível para dispositivos FPGA Agilex™ 5?

No Software Quartus® Prime Pro Edition versão 24.1, você pode observar que os drivers da interface de programação de aplicativos (API) HAL do Mailbox Client IP estão indisponíveis no BSP para projetos de Nios® V destinados a todos os dispositivos da família FPGA Agilex™ 5.

Outros dispositivos baseados em SDM não são afetados.

Para contornar esse problema no Software Quartus® Prime Pro Edition versão 24.1, faça o seguinte:

1. Inicie um sistema com um processador Nios® V com Mailbox Client IP na versão 24.1 do software Quartus® Prime Pro Edition.

2. Gere o BSP, você pode ver que o Nome do driver e a versão do driver para o Mailbox Client IP não são nenhum.

   

3. Navegue até a pasta <BSP>/drivers.

4. Navegue separadamente para o diretório <Quartus Prime>/24,1/ip/altera/pgm/altera_s10_mailbox_client/HAL.

5. Observe que os dois diretórios de pasta são os mesmos – inc e src.

6. Copie o conteúdo das pastas do Quartus® Prime HAL para as pastas de drivers BSP, respectivamente.

7. Navegue até < DiretórioQuartus Prime>/24,1/ip/altera/pgm/altera_s10_mailbox_client/inc.

8. Copie altera_s10_mailbox_client_regs.h na pasta BSP drivers/inc .

9. Verifique se o conteúdo da pasta BSP inc é o seguinte.

   • 

10. Verifique se o conteúdo da pasta src BSP está como abaixo.

    • 

11. Modifique a target_sources no CMakeLists.txt BSP.

    • Adicione os arquivos C na coluna PRIVATE .

      • drivers/src/altera_s10_mailbox_client.c

        drivers/src/altera_s10_mailbox_client_flash.c

        drivers/src/altera_s10_mailbox_client_flash_rsu.c

        drivers/src/altera_s10_mailbox_client_rsu.c

        drivers/src/librsu.c

        drivers/src/librsu_cb.c

        drivers/src/librsu_cfg.c

        drivers/src/librsu_ll_qspi.c

        drivers/src/librsu_misc.c

        drivers/src/rsu_client.c

        …

    • Adicione os arquivos de cabeçalho na coluna PUBLIC .

      • drivers/inc/altera_s10_mailbox_client.h

        drivers/inc/altera_s10_mailbox_client_flash.h

        drivers/inc/altera_s10_mailbox_client_flash_rsu.h

        drivers/inc/altera_s10_mailbox_client_regs.h

        drivers/inc/altera_s10_mailbox_client_rsu.h

        drivers/inc/librsu.h

        drivers/inc/librsu_cb.h

        drivers/inc/librsu_cfg.h

        drivers/inc/librsu_ll.h

        drivers/inc/librsu_misc.h

        drivers/inc/rsu_client.h

        …

12. Modifique o alt_sys_init.c nas seguintes seções.

• Cabeçalhos de dispositivo.

  • #include "altera_s10_mailbox_client.h"

• Atribua o armazenamento do dispositivo.

  • ALTERA_S10_MAILBOX_CLIENT_INSTANCE ( MAILBOX_CLIENT mailbox_client);

• Inicialize o dispositivo controlador não interrompido.

  • ALTERA_S10_MAILBOX_CLIENT_INIT ( MAILBOX_CLIENT mailbox_client);

Proceda para compilar o projeto de software.

Este problema está corrigido na versão 24.3 do Software Quartus® Prime Pro Edition.