CanMV 新增 RTL8733BS 模块支持,5G 功能正式点亮~

Viewed 84

问题描述


K230 CanMV 生态再添实用新技能!新增 rtl8733bs 无线模块支持,轻松实现 WiFi 高速连接,不管是接入现有无线网络(STA 模式),还是自建热点供设备接入(AP 模式),用MicroPython 就能简单搞定~ 下面这份超详细使用指南,帮你快速上手无线功能!

image.png

一、rtl8733bs 模块亮点速览

rtl8733bs 模块的加入,让 K230 CanMV 摆脱有线束缚,解锁更多无线场景:

  • 支持 2.4G/5G WiFi 连接,覆盖日常办公、智能家居、物联网等主流使用场景;
  • 兼容 MicroPython 原生 network 模块,接口简洁易调用,无需复杂配置;
  • 双模式灵活切换:既能作为站点(STA)连接路由器,也能化身访问点(AP)供其他设备连接;
  • 适配 K230 CanMV 硬件特性,运行稳定,满足轻量级数据传输、远程控制等需求。

二、使用指南

1. 硬件准备:

  1. K230开发板

  2. rtl8733bs模块,替换板子上原来的wifi模块(这里我们替换的是01Studio板子)

2. 软件准备

  1. 获取K230最新的SDK
    参考文档:https://www.kendryte.com/k230_canmv/zh/main/zh/userguide/how_to_build.html
  2. 打开配置,在SDK下运行make rtsmart-menuconfig

image.png

  1. 重新编译固件并烧录

模式一:STA 模式

适合场景:让 K230 CanMV 接入家庭、办公环境的路由器,实现联网通信。

核心接口说明

  • network.WLAN(network.STA_IF):初始化 STA 模式的 WLAN 对象;

  • sta.connect(ssid, password):连接指定 SSID 和密码的无线网络;

  • sta.isconnected():判断是否连接成功(返回 True/False);

  • sta.ifconfig():查看 IP 配置(IP 地址、子网掩码、网关、DNS);

  • sta.disconnect():断开当前网络连接。

完整例程

import network
import time
# 替换为你的WiFi名称(SSID)和密码
SSID = "你的WiFi名称"
PASSWORD = "你的WiFi密码"


# 初始化STA模式
sta = network.WLAN(network.STA_IF)

# 连接目标WiFi
sta.connect(SSID, PASSWORD)

# 等待连接,设置10秒超时
timeout = 10  # 超时时间(秒)

start_time = time.time()

while not sta.isconnected():
    if time.time() - start_time > timeout:
        print("连接超时!请检查SSID和密码是否正确")
        break
        print("正在连接...")
        time.sleep(1)

# 连接成功,打印网络配置
if sta.isconnected():
    print("连接成功!网络配置如下:")
     ip_config = sta.ifconfig()
    print(f"IP地址:{ip_config[0]}")
    print(f"子网掩码:{ip_config[1]}")
    print(f"网关:{ip_config[2]}")
    print(f"DNS:{ip_config[3]}")

# 按需断开连接(实际应用中可保留连接)
# sta.disconnect()
# print("已断开网络连接")

模式二:AP 模式

适合场景:让 K230 CanMV 作为热点,其他设备(手机、电脑、另一块开发板)直接连接,实现设备间本地通信。

核心接口说明

  • network.WLAN(network.AP_IF):初始化 AP 模式的 WLAN 对象;

  • ap.config(ssid, key):配置热点参数(SSID=热点名称,key=密码,channel=信道);

  • ap.info():查看 AP 模式详细信息;

  • ap.status():查看 AP 运行状态。

完整例程

import network

def ap_test():
    ap=network.WLAN(network.AP_IF)
    #配置并创建ap
    ap.config(ssid='PDCN_5G', key='1234567890')
    #查看ap信息
    print(ap.info())
    #查看ap的状态
    print(ap.status())

ap_test()

82e8f8bd5438371cc172ba1750fe8b44.png

三、使用注意事项

  1. 密码要求:AP 模式下密码长度需≥8位,否则可能导致热点创建失败;

  2. 连接超时:STA 模式下建议设置超时逻辑,避免因密码错误或信号不佳导致程序卡死;

  3. 信号稳定性:尽量让 K230 CanMV 远离金属遮挡物,确保无线信号稳定;

  4. 功耗提示:开启无线功能后功耗会略有上升,电池供电场景建议合理规划使用时长。

四、应用场景拓展

  • 物联网数据上传:连接 WiFi 后,将传感器采集的数据(温度、湿度、图像等)上传至云平台;

  • 远程控制:通过网络接收指令,控制 K230 CanMV 实现电机驱动、LED 控制等操作;

  • 设备间通信:多块 K230 CanMV 通过 AP 模式组网,实现数据互传、协同工作;

  • 无线调试:无需串口线,通过网络远程查看设备运行日志、修改程序参数。

rtl8733bs 模块的加入,让 K230 CanMV 的无线应用场景全面落地!按照上面的例程,几分钟就能搞定无线连接,赶紧拿起你的开发板,解锁更多联网玩法~

K230 CanMV 官方文档:https://www.kendryte.com/k230_canmv/zh/main/zh/example/network/wlan.html

1 Answers