RT-Thread API参考手册  3.1.1
嵌入式实时操作系统
WLAN框架

WLAN框架接口 更多...

函数

rt_err_t rt_wlan_set_mode (const char *dev_name, rt_wlan_mode_t mode)
 注册WLAN设备到WLAN设备框架 更多...
 
rt_err_t rt_wlan_connect (const char *ssid, const char *password)
 同步连接热点 更多...
 
rt_err_t rt_wlan_disconnect (void)
 同步断开热点 更多...
 
struct rt_wlan_scan_result * rt_wlan_scan_sync (void)
 同步扫描热点 更多...
 
void rt_wlan_config_autoreconnect (rt_bool_t enable)
 配置自动重连模式 更多...
 
rt_err_t rt_wlan_prot_attach (const char *dev_name, const char *prot_name)
 指定WLAN设备使用的协议 更多...
 

详细描述

WLAN框架接口

WLAN框架是RT-Thread开发的一套用于管理WIFI的中间件。对下连接具体的WIFI驱动,控制WIFI的连接断开, 扫描等操作。对上承载不同的应用,为应用提供WIFI控制,事件,数据导流等操作,为上层应用提供统一 的WIFI控制接口。WLAN框架主要由三个部分组成。DEV驱动接口层,为WLAN框架提供统一的调用接口。Manage 管理层为用户提供WIFI扫描,连接,断线重连等具体功能。Protocol协议负责处理WIFI上产生的数据流, 可根据不同的使用场景挂载不同通讯协议,如LWIP等。具有使用简单,功能齐全,对接方便,兼容性强等特点。

函数说明

rt_err_t rt_wlan_set_mode ( const char *  dev_name,
rt_wlan_mode_t  mode 
)

注册WLAN设备到WLAN设备框架

参数
dev_nameWLAN设备名
modeWLAN设备工作模式
返回
返回值 描述
-RT_EINVAL 参数错误
-RT_EIO 设备未找到
-RT_ERROR 执行失败
RT_EOK 执行成功
rt_err_t rt_wlan_connect ( const char *  ssid,
const char *  password 
)

同步连接热点

参数
ssidWIFI名字
passwordWIFI密码
返回
返回值 描述
-RT_EINVAL 参数错误
-RT_EIO 未注册设备
-RT_ERROR 连接失败
RT_EOK 连接成功
rt_err_t rt_wlan_disconnect ( void  )

同步断开热点

返回
返回值 描述
-RT_EIO 未注册设备
-RT_ENOMEM 内存不足
-RT_ERROR 断开失败
RT_EOK 断开成功
struct rt_wlan_scan_result* rt_wlan_scan_sync ( void  )

同步扫描热点

返回
扫描结果
void rt_wlan_config_autoreconnect ( rt_bool_t  enable)

配置自动重连模式

参数
enableenanle/disable自动重连
rt_err_t rt_wlan_prot_attach ( const char *  dev_name,
const char *  prot_name 
)

指定WLAN设备使用的协议

参数
dev_nameWLAN设备名
prot_name端口名
返回
-RT_ERROR 执行失败;RT_EOK 执行成功。