This function gets the signal level.

Syntax

int SysGetWLANSignalLevel(
  int *level
);

Parameters

level
[out] A pointer to a variable that gets the wireless LAN signal level (0 〜 100).
※RSSI value is +100 offset value
Signal level = 0 (RSSI = -100) or less is 0 (-100).

Return value

Returns TRUE if the function succeeds, FALSE otherwise.

Remarks

In the following cases, FALSE is returned.
  • When not connected to a wireless access point.
  • When signal level is not acquired.
  • When level is NULL.

Requirements

Header file:
lib.h
Library file:
libSTARTUPOPH5000.a

Sample

#include <stdio.h>
#include <stdlib.h>
#include "lib.h"

void main(void)
{
    int errorcode, level;
    printf("\fSysGetWLANSignalLevel\r\n\n");

    errorcode = SysSetWLANPower(SYS_WLAN_POWER_AUTO);
    SysWLANInit(NULL);
    printf("Power ON\r\n");
    printf("Please any key\r\n");
    ResetKey();
    while(!kbhit())
        Idle();

    while(1)
    {
        errorcode = SysGetWLANSignalLevel (&level);
        printf("error = %d\r\n", errorcode);
        printf("power = %d\r\n", level);
        printf("Please any key\r\n");
        ResetKey();
        while(!kbhit())
            Idle();
    }
}

Last updated: 2020/11/26