Add ipconfigEMAC_TASK_HOOK macro to STMH7xx network interface

[kzorer]

Add ipconfigEMAC_TASK_HOOK macro to allow for configurable watchdog timer for STMH7xx MCUs

Description

• Introduced the ipconfigEMAC_TASK_HOOK macro, which defaults to a no-op but can be overridden in FreeRTOSIPConfig.h.
• Added ipconfigEMAC_TASK_HOOK() call in the Ethernet status checking code to enable optional watchdog timer functionality.
• This change allows users to define ipconfigEMAC_TASK_HOOK in FreeRTOSIPConfig.h to enable or disable the watchdog timer, providing greater flexibility in managing Ethernet operations.
• The macro is safely defined as an empty statement if not previously defined, ensuring backward compatibility.

Test Steps

• Ensure that FreeRTOSIPConfig.h is properly configured to include or exclude the ipconfigEMAC_TASK_HOOK macro.
• Deploy the firmware to the target hardware.
• Test Ethernet link status changes by simulating link up and link down events.
• Confirm that if ipconfigEMAC_TASK_HOOK is defined, the corresponding watchdog timer functionality is correctly invoked.

Checklist:

• I have tested my changes. No regression in existing tests.
• I have modified and/or added unit-tests to cover the code changes in this Pull Request.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[aggarg]

Can we name it so that it does not seem specific to watchdog? The reason is that someone may want to use it for a different purpose too. How about something like iptraceEMAC_TASK_ITERATION or iptraceEMAC_TASK_HOOK?

[htibosch]

The above PR went too fast, I missed.
We already have a macro ipconfigWATCHDOG_TIMER() which could be used for this purpose.

[aggarg]

@htibosch If I understand correctly, ipconfigWATCHDOG_TIMER is called from the IP task and thereby enables the application to monitor the IP task. On the other hand, this change enables the application to monitor the EMAC task. Or did I miss something?

[htibosch]

About the other PR 1178, this is how you can obtain the task handle of the EMAC task:

TaskHandle_t xHandle = xTaskGetHandle( niEMAC_HANDLER_TASK_NAME );

It will return the handle of the EMAC handler task. There is no need for a new function FreeRTOS_GetEMACTaskHandle().

The existing application hook ipconfigWATCHDOG_TIMER is supposed to pet a watchdog. In my private projects, I have a watchdog per task. So it would call:

extern void watchdog_timer( TaskHandle_t pxTask );
#define ipconfigWATCHDOG_TIMER() \
    do{ \
          watchdog_timer( xTaskGetCurrentTaskHandle() ); \
    } while( 0 )