Unable to register for wifi status updates with Realtek 8195

[michalpasztamobica]

Description

Target: RTL8195
Toolchain: GCC_ARM
Tools: mbed-cli 1.7.2 on Windows
mbed-os SHA: e942582
Steps to reproduce:

1. Try to use the interfaces defined in targets/TARGET_Realtek/TARGET_AMEBA/sdk/common/api/wifi/wifi_ind.h.
   For example, I modified the RTWInterface constructor to call the following:

init_event_callback_list();
wifi_reg_event_handler(WIFI_EVENT_STA_DISASSOC, myEventHandler, this);

2. run compilation:
   $ mbed compile --target REALTEK_RTL8195AM --toolchain GCC_ARM
3. Observe linker errors:

[ERROR] BUILD/REALTEK_RTL8195AM/GCC_ARM/targets/TARGET_Realtek/TARGET_AMEBA/RTWInterface.o: In function `RTWInterface':
C:\***\arm\mbed-os/.\targets\TARGET_Realtek\TARGET_AMEBA/RTWInterface.cpp:138: undefined reference to `init_event_callback_list()'
C:\***\arm\mbed-os/.\targets\TARGET_Realtek\TARGET_AMEBA/RTWInterface.cpp:139: undefined reference to `wifi_reg_event_handler(unsigned int, void (*)(char*, int, int, void*), void*)'
collect2.exe: error: ld returned 1 exit status

BACKGROUND:

Why I am doing this is because I want to be able to receive Wifi status update (disconnected, connecting, local_up, global_up) from Realtek HW. Currently, I am only getting them during connection and I assume they are actually triggered by the connect() procedure and not by events coming from Wifi. I do not get them when I lose connection (this works fine for ublox ODIN W2 board)

I downloaded the Realtek Ameba SDK and after extracting it I actually found the definitions of the functions. They are not provided with the mbed-os source code.
I also examined the provided binary lib (/mbed-os/targets/TARGET_Realtek/TARGET_AMEBA/TARGET_MCU_RTL8195A/device/TOOLCHAIN_GCC_ARM/lib_wlan_mbed_gcc.a) using nm and objdump on my Linux machine:

$ objdump --syms lib_wlan_mbed_gcc.a | grep init_event_callback_list
00000000         *UND*    00000000 init_event_callback_list
00000000 l    d  .text.init_event_callback_list    00000000 .text.init_event_callback_list
00000000 l       .text.init_event_callback_list    00000000 $t
0000000c l       .text.init_event_callback_list    00000000 $d
00000001 g     F .text.init_event_callback_list    00000010 init_event_callback_list

$ nm lib_wlan_mbed_gcc.a | grep init_event_callback_list
U init_event_callback_list
00000001 T init_event_callback_list

I am a bit worried about the fact that the function is reported as undefined.

Right now it seems to me that there is a problem with the provided lib_wlan_mbed_gcc.a library.
Please, correct me if I am not using the events API correctly.

Issue request type

[ ] Question
[ ] Enhancement
[x] Bug

[SeppoTakalo]

@ARMmbed/team-realtek Please review.

[ciarmcom]

Internal Jira reference: https://jira.arm.com/browse/MBOCUSTRIA-19

[samchuarm]

Hi @AdamZhang0124 , can you please confirm if the function reported is supported in Mbed OS with Realtek SDK?

[M-ichae-l]

@michalpasztamobica
the two functions defined in the lib. It is actually from a ".c" file. You are calling is from a ".cpp" file. You may want to add the following code to include the ".h"

#ifdef __cplusplus
extern "C" {
#endif
#include "wifi_ind.h"
#ifdef __cplusplus
} 
#endif

[M-ichae-l]

Please refer to #8750 for the fix.

[samchuarm]

Since the fix has been identified, can we close this issue? Thanks.

[SeppoTakalo]

Can be closed once the fix has been merged.

[samchuarm]

The fix has been merged. #8750