Core API 文档

发布时间: Fri Oct 20 17:32:19 2023

提示：查找某个函数时，可使用Ctrl+F搜索相应的函数名称

常用外部设备

LED灯

LIB_LedConfig(p1,p2,p3,p4,p5)

函数描述: LED(LED1~LED4)工作模式配置。注意:LED1~LED4是可以分配在任意D0~D11上的，由开发者自己定义 注意: 该函数只能调用一次

应用示例:

--设置LED2(占用D2端口)以0.2秒亮、0.2秒灭的节奏闪烁，另外假设Led灯是低电平驱动点亮
LIB_LedConfig("LED2","D2","L",200,200)
--LED2开始闪烁
LIB_LedStartWork("LED2")

LIB_LedStartWork(p1)

函数描述: Led开始闪烁

应用示例:

xxxxxxxxxx
--设置LED2(占用D2端口)以0.2秒亮、0.2秒灭的节奏闪烁，另外假设Led灯是低电平驱动点亮
LIB_LedConfig("LED2","D2","L",200,200)
--LED2开始闪烁
LIB_LedStartWork("LED2")

LIB_LedStopWork(p1)

函数描述: Led停止闪烁

应用示例:

xxxxxxxxxx
--LED2停止闪烁
LIB_LedStopWork("LED2")

独立按键

LIB_ButtonConfig(p1,p2,p3)

函数描述: 按键(BTN1~BTN7)工作模式的配置。注意:BTN1~BTN8是可以分配在任意D0~D11上的，看你的心情。

应用示例:

xxxxxxxxxx
--设置按键3(占用D1口)以低电平有效的方式检测按键动作
LIB_ButtonConfig("BTN3","D1","L")

r1 = LIB_ButtonQuery(p1)

函数描述: 检测按键(Btn1~Btn8)的动作

注意：当持续按压时，LIB_ButtonQuery会持续返回数值3或4，直到按键弹起后最终会返回一个数值1或2.

应用示例:

xxxxxxxxxx
--设置按键3(占用D0口)，假设按键是低电平有效
LIB_ButtonConfig("BTN3","D0","L")
--设置按键4(占用D2口)，假设按键是低电平有效
LIB_ButtonConfig("BTN4","D2","L")
--持续检测按键3和4是否有短按动作
while(true)
do
    --查询按键3是否短按过
    if LIB_ButtonQuery("BTN3") == 1 then
        print("Button3 clicked")
    end
    --查询按键4是否长按过（按压超过3秒后松开）
    if LIB_ButtonQuery("BTN4") == 2 then
        print("Button4 long pressed")
    end
    --查询按键4是否一直长按中（持续按压(0.8秒~3秒)）
    if LIB_ButtonQuery("BTN4") == 3 then
        print("Button4 short hold presse")
    end
    --查询按键4是否一直长按中（持续按压(3秒以上)）
    if LIB_ButtonQuery("BTN4") == 4 then
        print("Button4 long hold presse")
    end
end

0.96寸oled屏

LIB_0_96_OledConfig(p1)

函数描述: 配置0.96寸oled显示模块和core的连接端口，并初始化开始工作

应用示例:

xxxxxxxxxx
--设置0.96寸oled模块占用SCL1和SDA1引脚
LIB_0_96_OledConfig("IIC1")

LIB_0_96_OledPuts(p1,p2,p3)

函数描述: 在p1行，p2列显示字符串。0.96寸oled整个屏幕可以容纳4行且每行长度不超过16列的ascii字符。

应用示例:

xxxxxxxxxx
--设置0.96寸oled模块占用SCL1和SDA1引脚
LIB_0_96_OledConfig("IIC1")
cnt = 0
while(true)
do
    cnt = cnt + 1
    LIB_DelayMs(1000)
    --每隔1秒，在第2行的起始处(第1列)显示"cnt = xxxxx"字符串
    LIB_0_96_OledPuts("2","1",string.format("cnt = %05d",cnt))
end

LIB_0_96_OledScreenClear()

函数描述: 清除整个屏幕的内容

应用示例:

xxxxxxxxxx
LIB_0_96_OledScreenClear()

1602LCD(IIc接口)

LIB_LCD1602Config(p1)

函数描述: 配置LCD1602的连接端口，并初始化开始工作

应用示例:

xxxxxxxxxx
--设置LCD1602模块占用SCL0和SDA0引脚
LIB_LCD1602Config("IIC0")

LIB_LCD1602Puts(p1,p2,p3,p4)

函数描述: 在p1行，p2列显示字符串。LCD1602整个屏幕可以容纳2行且每行长度不超过16列的ascii字符。

应用示例:

xxxxxxxxxx
--设置LCD1602模块占用SCL0和SDA0引脚
LIB_LCD1602Config("IIC0")
cnt = 1
while(true)
do
    cnt = cnt + 1
    LIB_DelayMs(100)
    --每隔0.1秒，在第2行的起始处(第1列)显示"cnt = xxxxx"字符串
    LIB_LCD1602Puts("2","1",string.format("cnt = %05d",cnt),"LightOn")
end

LIB_LCD1602ScreenClear()

函数描述: 清除整个屏幕的内容

应用示例:

xxxxxxxxxx
LIB_LCD1602ScreenClear()

TF卡读写

r1,r2 = LIB_Fread(p1,p2)

函数描述: 从文件指定位置开始读取文件内容，一次读取256字节。注意调用该函数会阻塞程序。

应用示例:

xxxxxxxxxx
--从main.lua文件的0地址处开始读取256字节
read_number, read_content = LIB_Fread("main.lua",0)
if read_number > 0 then
    print(string.format("readed %d bytes", #read_content))
end

LIB_Fwrite(p1,p2)

函数描述: 将table内的数据从指定文件的末尾处写入

应用示例:

xxxxxxxxxx
--向"abc.txt"文件中写入一串整型数据
num_tab = {1,2,3,4,5}
LIB_Fwrite("abc.txt", num_tab)

LIB_Fdelete(p1)

函数描述: 删除文件

应用示例:

xxxxxxxxxx
--删除文件"abc.txt"
LIB_Fdelete("abc.txt")

TF卡读写扩展(仅适用于C1)

LIB_Fcache(p1,p2,p3)

函数描述: 缓存将要写入TF卡上文件的数据，当芯片内部4KB缓存将时，会自动将4K数据写入指定文件的末尾处， 注意1：该函数具有阻塞性 注意2：代码中使用该函数后，一定不要再使用print函数以及LIB_SystemLogEnable()函数了，因为会造成TF卡写入冲突。

应用示例:

xxxxxxxxxx
--向abc.txt文件中写入一串整型数据
num_tab = {1,2,3,4,5}
LIB_Fcache("Write", abc.txt", num_tab)
--将缓存中的数据立刻写入abc.txt文件
LIB_Fcache("Flush", abc.txt")

数码管和矩阵键盘

LIB_SegLedsAndMatrixKeysConfig(p1,p2,p3)

函数描述: 配置数码管矩阵键盘模块开始工作。

应用示例:

xxxxxxxxxx
--配置数码管矩阵键盘模块的引脚DIO,CLK,STB占用Core的D7,D6,D5引脚，并开始工作
LIB_SegLedsAndMatrixKeysConfig("D7","D6","D5")

r1,r2 = LIB_MatrixKeysRead()

函数描述: 查询矩阵键盘是否有按键按下，并返回按键值

应用示例:

xxxxxxxxxx
--配置数码管矩阵键盘模块的引脚DIO,CLK,STB分别占用Core的D7,D6,D5引脚，并开始工作
LIB_SegLedsAndMatrixKeysConfig("D7","D6","D5")
--查询矩阵键盘是否有按键按下，如果有就print输出
while(true)
do
    keypress_flag,key_pos = LIB_MatrixKeysRead()
    if keypress_flag == 1 then
        print(string.format("Key %d Pressed\r\n", key_pos))
    end
end

LIB_SegLedsWrite(p1,p2,p3)

函数描述: 设置8位数码管需要显示的数值、小数位个数以及数码管亮度

"LEVEL0"是完全灭掉，"LEVEL8"是最亮状态

应用示例:

xxxxxxxxxx
--设置数码管显示8位十进制数值12345.678，亮度为最亮
LIB_SegLedsWrite(12345678, "3", "LEVEL8")

TM1650四位数码管显示

LIB_FourSegLedsConfig(p1,p2)

函数描述: 配置TM1650四位数码管模块开始工作。

应用示例:

xxxxxxxxxx
--配置TM1650四位数码管模块的引脚DIO,CLK占用Core的D7,D6引脚，并开始工作
LIB_FourSegLedsConfig("D7","D6")

LIB_FourSegLedsNumWrite(p1,p2,p3)

函数描述: 设置8位数码管需要显示的数值、小数位个数以及数码管亮度

应用示例:

​x
--设置数码管显示数值123.4，亮度为最亮
LIB_FourSegLedsNumWrite(1234, "3", "L8")
--设置数码管显示数值-1，亮度为最亮
LIB_FourSegLedsNumWrite(-1, "0", "L8")
--设置数码管显示数值1，亮度为最暗
LIB_FourSegLedsNumWrite(1, "0", "L1")
​

LIB_FourSegLedsRawWrite(p1,p2,p3,p4,p5)

函数描述: 设置8位数码管需要显示的数值、小数位个数以及数码管亮度

应用示例:

xxxxxxxxxx
--设置数码管显示1234，亮度为最亮
LIB_FourSegLedsRawWrite(0x06,0x5B,0x4F,0x66,"L8")
--设置数码管显示ABCD，亮度为最暗
LIB_FourSegLedsRawWrite(0x77,0x7C,0x39,0x5E,"L1")

全彩RGB Led

LIB_RGBledConfig(p1,p2,p3)

函数描述: 配置共阴极RGB模块开始工作，模块的R,G,B引脚分别固定占用Core的D0,D1,D2引脚 p1,p2,p3这三个参数用来调整RGB Led白平衡用

应用示例:

xxxxxxxxxx
--配置共阴极RGB模块开始工作，模块的R,G,B引脚分别固定占用Core的D0,D1,D2引脚
--三个100表示不调整三色比例，即不考虑白平衡的问题
LIB_RGBledConfig(100,100,100)

LIB_RGBledUpdate(p1,p2,p3)

函数描述: 更新RGB的颜色值

应用示例:

xxxxxxxxxx
--配置共阴极RGB模块开始工作，模块的R,G,B引脚固定占用Core的D0,D1,D2引脚
LIB_RGBledConfig(100,100,100)
--更新RGB Led灯的色值为120,20,200
LIB_RGBledUpdate(120,20,200)

PCF8574扩展IO口

LIB_PCF8574Config(p1)

函数描述: 配置PCF8574模块占用Core的哪一个IIC端口，

应用示例:

xxxxxxxxxx
--设置PCF8574模块占用Core的SCL0和SDA0引脚
LIB_PCF8574Config("IIC0")

r1,r2 = LIB_PCF8574ReadPort(p1)

函数描述: 读取PCF8574的8个IO口的电平状态 注意:该函数每调用一次会耗时大概200us，这个耗时需要在您设计Lua代码时加以考虑

应用示例:

xxxxxxxxxx
--设置PCF8574模块占用Core的SCL0和SDA0引脚
LIB_PCF8574Config("IIC0")
--每隔0.3秒读取一次地址为0x27的PCF8574的端口值，如果正常读取到就print输出
while(true)
do
    LIB_DelayMs(300)
    ok,port = LIB_PCF8574ReadPort(0x27)
    if ok == 1 then
        print(string.format("Port Value: %02X\r\n", port))
    else
        print("Read fail, maybe caused by the iic error or device fault!\r\n")
    end
end

r1 = LIB_PCF8574WritePort(p1,p2)

函数描述: 向PCF8574写入8个IO口的电平状态 注意:该函数每调用一次会耗时大概200us，这个耗时需要在您设计Lua代码时加以考虑

应用示例:

xxxxxxxxxx
--设置PCF8574模块占用Core的SCL0和SDA0引脚
LIB_PCF8574Config("IIC0")
--每隔0.3秒向PCF8574写入端口值0xF0，即P0=P1=P2=P3=0,P4=P5=P6=P7=1
while(true)
do
    LIB_DelayMs(300)
    ok = LIB_PCF8574WritePort(0x27,0xF0)
    if ok == 1 then
        print("Write 0xF0 success\r\n")
    else
        print("Read fail, maybe caused by the iic error or device fault!\r\n")
    end
end

WK2124 UART四串口扩展

LIB_WK2124Config(p1~p5)

函数描述: 配置WK2124模块开始工作，模块需要占用SPI的四个引脚以及由p5参数指定的一个GPIO口

应用示例:

xxxxxxxxxx
--配置WK2124模块开始工作,4个UART扩展口都开启，并且模块占用SPI(CS,MISO,MOSI,CLK)以及D5引脚
LIB_WK2124Config("B115200","B115200","B9600","B9600","D5")

r1,r2 = LIB_WK2124UartRecvQuery(p1)

函数描述: 查询某个"Uart(1~4)"口是否收到数据，并将收到的数据内容以table形式返回。 注意：发送端每次发送的数据不能超过256字节，并且建议发送间隔最好不要小于100ms

应用示例:

xxxxxxxxxx
--配置WK2124模块开始工作,4个UART扩展口都开启，并且模块占用SPI(CS,MISO,MOSI,CLK)以及D5引脚
LIB_WK2124Config("B115200","B115200","B9600","B9600","D5")
while(true)
do
    --查询Uart1是否收到数据，如果收到就print输出收到的数据
    u1_flag,u1_tab = LIB_WK2124UartRecvQuery("UART1")
    if u1_flag == 1 then
        print("Uart1 Recv:")
        --将从uart1串口收到的数据逐个打印出来
        for i, v in ipairs(u1_tab) do
            print(i, v)
        end 
    end
    --查询Uart2是否收到数据，如果收到就print输出收到的数据
    u2_flag,u2_tab = LIB_WK2124UartRecvQuery("UART2")
    if u2_flag == 1 then
        print("Uart2 Recv:")
        --将从uart2串口收到的数据逐个打印出来
        for i, v in ipairs(u2_tab) do
            print(i, v)
        end 
    end
    --查询Uart3是否收到数据，如果收到就print输出收到的数据
    u3_flag,u3_tab = LIB_WK2124UartRecvQuery("UART3")
    if u3_flag == 1 then
        print("Uart3 Recv:")
        --将从uar3串口收到的数据逐个打印出来
        for i, v in ipairs(u3_tab) do
            print(i, v)
        end 
    end
    --查询Uart4是否收到数据，如果收到就print输出收到的数据
    u4_flag,u4_tab = LIB_WK2124UartRecvQuery("UART4")
    if u4_flag == 1 then
        print("Uart4 Recv:")
        --将从uart4串口收到的数据逐个打印出来
        for i, v in ipairs(u4_tab) do
            print(i, v)
        end 
    end
end

LIB_WK2124UartSend(p1,p2)

函数描述: 向某个"Uart(1~4)"口发送一串数据，注意数据个数不能超过256个

应用示例:

xxxxxxxxxx
--配置WK2124模块开始工作,4个UART扩展口都开启，并且模块占用SPI(CS,MISO,MOSI,CLK)以及D5引脚
LIB_WK2124Config("B115200","B115200","B9600","B9600","D5")
send_table = {0x01,0x02,0x03,0x04,0x05,0x06} --要发送的数据
while(true)
do
    --向Uart1发送一串数据
    LIB_WK2124UartSend("UART1", send_table)
    LIB_DelayMs(2000)
    --向Uart2发送一串数据
    LIB_WK2124UartSend("UART2", send_table)
    LIB_DelayMs(2000)
    --向Uart3发送一串数据
    LIB_WK2124UartSend("UART3", send_table)
    LIB_DelayMs(2000)
    --向Uart4发送一串数据
    LIB_WK2124UartSend("UART4", send_table)
    LIB_DelayMs(2000)
end

AM1805低功耗

LIB_AM1805Config(p1)

函数描述: 配置AM1805低功耗模块占用Core的哪一个IIC端口

应用示例:

xxxxxxxxxx
--设置AM1805模块占用Core的SCL0和SDA0引脚
LIB_AM1805Config("IIC0")

LIB_AM1805Sleep(p1,p2)

函数描述: 配置AM1805断掉外部系统的电源开始休眠，默认在休眠时间到后唤醒，但也可以增加外部信号唤醒方式。

注意：调用LIB_AM1805Sleep()函数前请确保MCU至少已上电1.5秒以上，不然无法正常休眠

应用示例:

xxxxxxxxxx
--设置AM1805模块占用Core的SCL0和SDA0引脚
LIB_AM1805Config("IIC0")
print("power up")
while(GC(1) == true)
do
    --5秒钟后断电，休眠10秒再唤醒
    LIB_DelayMs(5000)
    print("power down")
    --设置AM1805模块开始休眠并断掉系统的电，10秒后唤醒，如果休眠
    --中途检测到上升沿信号，则立刻唤醒
    LIB_AM1805Sleep(10, "RISE")--此时系统将掉电，后面的代码都不再有效了
    --mcu lost power from there
end
​

SYN6288语音输出

LIB_SYN6288Config(p1,p2)

函数描述: 配置SYN6288语音模块占用的UART端口,以及需要播放的文字的编码

应用示例:

xxxxxxxxxx
--设置SYN6288模块占用TX0、RX0引脚,文本编码为GB2312
LIB_SYN6288Config("UART0","GB2312")

LIB_SYN6288Play(p1)

函数描述: 开始语音播放p1参数所包含的文本内容

应用示例:

xxxxxxxxxx
--设置SYN6288模块占用TX0、RX0引脚,文本编码为GB2312
LIB_SYN6288Config("UART0","GB2312")
while(true)
do
    --每隔10秒播放“你好，欢迎光临”
    LIB_SYN6288Play("你好，欢迎光临")
    LIB_DelayMs(10000)
end

LIB_SYN6288Stop()

函数描述: 停止正在播放的语音内容

应用示例:

xxxxxxxxxx
--停止正在播放的语音内容
LIB_SYN6288Stop()

LD3320A 语音识别

LIB_LD3320Config(p1,p2,p3,p4)

函数描述: 配置语音识别模块开始工作，以及RST引脚占用Core的端口号

p2需要注意的地方： 注意1:在正常生活条件下的室内环境和比较安静的室外环境，建议设置值为 40H-55H；使用距离在 0.5 米以上为好，避免声音录入产生过激。 注意2:在十分嘈杂的环境中，比如展览会现场，建议设置值为10H-2FH；此时需要使用者嘴巴距离MIC距离为 0~50 厘米以内。

应用示例:

xxxxxxxxxx
--PhraseCode是需要识别的短语的代号，例如识别到用户说"右边"时，我们会得到短语的代号"3"
PhraseCode = {1, 2, 3, 4, 5, 6} --注意: 元素个数不能超过50个!
--Phrase是需要识别的短语，每个短语的长度不能超过79个字节（包含拼音之间的空格）
Phrase = {"ni hao", "zuo bian", "you bian", "quan bu liang", "quan bu mie", "zai jian"} --注意: 元素个数不能超过50个!
--配置LD3320语音识别模块的引脚RST占用Core的D7引脚以及SPI接口，麦克风音量0x43
LIB_LD3320Config("D7",0x43,PhraseCode,Phrase)

r1,r2 = LIB_LD3320GetResult()

函数描述: 查询是否有有效短语识别结果 注意：该函数必须是在检测到模块的IRQ引脚有下降沿信号时才能被调用

应用示例:

xxxxxxxxxx
Flag,PhraseCode = LIB_LD3320GetResult()
if Flag == 1 then
    print("The detected phrase code is: %d", PhraseCode)
end

ESP32CAM 摄像头

Res,Info=LIB_EspCamOp(p1,...)

函数描述: 向Esp32Cam板子下发各种指令，并返回指令的执行结果 注意: 调用该函数会造成Lua应用代码阻塞一段时间，具体时间取决于不同指令的操作，开发者需注意。

开发者可以选择将Esp32Cam配置成如下四种场景功能之一： (一)Esp32Cam配置成本地相机工作 (二)Esp32Cam配置成远程相机工作 (三)Esp32Cam配置成Web camera模式工作 (四)Esp32Cam配置成Web server camera模式工作（不仅有视频流，还可以远程控制和采集传感器） 下面开始逐一介绍每种工作模式，开发者只需看自己感兴趣的工作模式

(一)当Esp32Cam配置成本地相机工作时:

参数介绍

• "Config": 表示开始进入配置流程。

• "LOCAL_PHOTO": 表示将Esp32Cam配置成本地相机功能。

• "UART0": 表示Core通过UART0(Tx0,Rx0)接口和Esp32Cam进行连接,也可以是"UART1"。

• HW: table类型，必须包含4个元素的字符串，定义如下:

  xxxxxxxxxx
  HW = 
  {
      "MySsid",--Wifi账号，这里其实用不上，随便写即可
      "MyPassword",--Wifi密码，这里其实用不上，随便写即可
      "FRAMESIZE_SVGA",--摄像头采集图片尺寸为SVGA，SVGA:800*600，尽量不要高于SVGA
      "12"--摄像头采集图片的质量为12，必须为"1"~"63",其中"1"质量最高
  }
  附注：上面的FRAMESIZE可以配置为如下种类:
  FRAMESIZE_QQVGA:160*120
  FRAMESIZE_QCIF:176*144
  FRAMESIZE_HQVGA:240*176
  FRAMESIZE_QVGA:320*240
  FRAMESIZE_CIF:400*296
  FRAMESIZE_VGA:640*400
  FRAMESIZE_SVGA:800*600
  FRAMESIZE_XGA:1024*768
  FRAMESIZE_SXGA:1280*1024
  FRAMESIZE_UXGA:1600*1200
  FRAMESIZE_QXGA:2048*1536
  

  返回值介绍

• Res: 返回1表示成功，可以忽略下面的Info，返回0表示失败，可以打印Info信息来定位失败原因

• Info:失败原因，可能是下面的其中一个

  xxxxxxxxxx
  "Uart time out": Core和Esp32Cam板子通信失败
  "ack SD Card Mount Failed, esp will reset": 这种情况建议Core也跟着重启
  "ack No SD Card attached, esp will reset": 这种情况建议Core也跟着重启
  "ack cam init fail, esp will reset": 这种情况建议Core也跟着重启
  

返回值介绍

• Res: 返回1表示成功，可以忽略下面的Info，返回0表示失败，可以打印Info信息来定位失败原因

• Info:失败原因，可能是下面的其中一个

  xxxxxxxxxx
  "Uart time out": Core和Esp32Cam板子通信失败
  "ack cam capture fail, esp will reset": 这种情况建议Core也跟着重启
  "ack Failed to open file in writing mode, esp will reset": 这种情况建议Core也跟着重启
  

(二)当Esp32Cam配置成远程相机工作时:

参数介绍

• "Config": 表示开始进入配置流程。

• "REMOTE_PHOTO": 表示将Esp32Cam配置成远程相机功能。

• "UART0": 表示Core通过UART0(Tx0,Rx0)接口和Esp32Cam进行连接,也可以是"UART1"。

• HW: table类型，必须包含4个元素的字符串，定义如下:

  xxxxxxxxxx
  HW = 
  {
      "MySsid",--Wifi账号
      "MyPassword",--Wifi密码
      "FRAMESIZE_SVGA",--摄像头采集图片尺寸为SVGA，SVGA:800*600，尽量不要高于SVGA
      "12"--摄像头采集图片的质量为12，必须为"1"~"63",其中"1"质量最高
  }
  附注：上面的FRAMESIZE可以配置为如下种类:
  FRAMESIZE_QQVGA:160*120
  FRAMESIZE_QCIF:176*144
  FRAMESIZE_HQVGA:240*176
  FRAMESIZE_QVGA:320*240
  FRAMESIZE_CIF:400*296
  FRAMESIZE_VGA:640*400
  FRAMESIZE_SVGA:800*600
  FRAMESIZE_XGA:1024*768
  FRAMESIZE_SXGA:1280*1024
  FRAMESIZE_UXGA:1600*1200
  FRAMESIZE_QXGA:2048*1536
  

• IP: table类型，必须包含5个元素的字符串，定义如下:

  xxxxxxxxxx
  IP = 
  {
      "Dynamic",--表示动态IP模式，动态IP模式下，忽略下面5项，"Static"时需要配置下面5项
      "0.0.0.0",--本机IP地址
      "0.0.0.0",--gateway地址
      "0.0.0.0",--subnet地址
      "0.0.0.0",--首选DNS地址
      "0.0.0.0"--次选DNS地址
  }
  

• SERVER: table类型，必须包含2个元素的字符串，定义如下:

  xxxxxxxxxx
  SERVER = 
  {
      "xxx.com",--服务器地址
      "80"--服务器端口号
  }
  

• H1: table类型，H1是Http Post发送图片的Header的前一部分内容,具体内容开发者自定义，但每行不要超过256个字符:

  xxxxxxxxxx
  H1 = 
  {
      "POST /api/xxx/yyy?deviceno=123456789 HTTP/1.1\r\n",
      "Host: xxx.com\r\n",
      "User-Agent: ...\r\n",
      "Accept: ... \r\n",
      "Accept-Encoding: ...\r\n",
      "Connection: ...\r\n",
      "Content-Type: ...; boundary=123456789000000000987654321\r\n",
      "Content-Length: %d\r\n\r\n"
  }
  注意0：上面的内容只是示例，具体内容需开发者根据实际情况来定
  注意1：上面的deviceno可以换成设备的唯一ID号，这样方便了server端可以识别Post消息的来源
  注意2：上面的Content-Length: 后面的%d不要删除，会自动填充 H2 + 图片大小 + H3的和
  

• H2: table类型，H2是Http Post发送图片的Header的后一部分内容,具体内容开发者自定义，但每行不要超过256个字符:

  xxxxxxxxxx
  H2 = 
  {
      "--123456789000000000987654321\r\n",
      "Content-Disposition: form-data; name=\"file\"; filename=\"esp32-cam.jpg\"\r\n",
      "Content-Type: application/octet-stream;chartset=UTF-8\r\n\r\n"
  }
  注意0：上面的内容只是示例，具体内容需开发者根据实际情况来定
  

• H3: string类型，H3是http消息中的boundary，需要和上面H1和H2中的保持相同:

  xxxxxxxxxx
  H3 = "--123456789000000000987654321--"
  注意：上面的内容只是示例，具体内容需开发者根据实际情况来定
  

返回值介绍

• Res: 返回1表示成功，可以忽略下面的Info，返回0表示失败，可以打印Info信息来定位失败原因

• Info:失败原因，可能是下面的其中一个

  xxxxxxxxxx
  "Uart time out": Core和Esp32Cam板子通信失败
  "ack staticIP STA config failed, esp will reset": 这种情况建议Core也跟着重启
  "ack cam init fail, esp will reset": 这种情况建议Core也跟着重启
  "ack para not surport": 这种情况开发者请检查一下传入函数的参数是否在规定范围之内
  

返回值介绍

• Res: 返回1表示成功，可以忽略下面的Info，返回0表示失败，可以打印Info信息来定位失败原因

• Info:失败原因，可能是下面的其中一个

  xxxxxxxxxx
  "Uart time out": Core和Esp32Cam板子通信失败
  "ack cam capture fail, esp will reset": 这种情况建议Core也跟着重启
  "ack got entire http resp timeout": 在预期时间，比如上面的2000ms内没有收到包含"{"和"}"的消息体
  "ack connect to server fail": Esp32Cam无法和服务器建立连接
  "ack wifi not connected": Esp32Cam没有接入Wifi网络
  

(三)当Esp32Cam配置成Web camera模式工作时:

参数介绍

• "Config": 表示开始进入配置流程。

• "WEB_VEDIO": 表示将Esp32Cam配置成网络摄像机WebServer纯视频流功能。

• "UART0": 表示Core通过UART0(Tx0,Rx0)接口和Esp32Cam进行连接,也可以是"UART1"。

• HW: table类型，必须包含4个元素的字符串，定义如下:

  xxxxxxxxxx
  HW = 
  {
      "MySsid",--Wifi账号
      "MyPassword",--Wifi密码
      "FRAMESIZE_SVGA",--摄像头采集图片尺寸为SVGA，SVGA:800*600，尽量不要高于SVGA
      "12"--摄像头采集图片的质量为12，必须为"1"~"63",其中"1"质量最高
  }
  附注：上面的FRAMESIZE可以配置为如下种类:
  FRAMESIZE_QQVGA:160*120
  FRAMESIZE_QCIF:176*144
  FRAMESIZE_HQVGA:240*176
  FRAMESIZE_QVGA:320*240
  FRAMESIZE_CIF:400*296
  FRAMESIZE_VGA:640*400
  FRAMESIZE_SVGA:800*600
  FRAMESIZE_XGA:1024*768
  FRAMESIZE_SXGA:1280*1024
  FRAMESIZE_UXGA:1600*1200
  FRAMESIZE_QXGA:2048*1536
  

• IP: table类型，必须包含5个元素的字符串，定义如下:

  xxxxxxxxxx
  IP = 
  {
      "Dynamic",--表示动态IP模式，动态IP模式下，忽略下面5项，"Static"时需要配置下面5项
      "0.0.0.0",--本机IP地址
      "0.0.0.0",--gateway地址
      "0.0.0.0",--subnet地址
      "0.0.0.0",--首选DNS地址
      "0.0.0.0"--次选DNS地址
  }
  

• SERVER: table类型，必须包含2个元素的字符串，定义如下:

  xxxxxxxxxx
  SERVER = 
  {
      "80"--本机视频流Web Server端口号
  }
  

• H1: table类型，H1是Web Server 回复客户端的http header

  xxxxxxxxxx
  H1 = 
  {   
      "multipart/x-mixed-replace;boundary=123456789000000000987654321"
  }
  注意0：上面的内容只是示例，具体内容需开发者根据实际情况来定
  

• H2: table类型，H2是Web Server 回复客户端的图片信息描述,每行不要超过256个字符:

  xxxxxxxxxx
  H2 = 
  {
      "Content-Type: image/jpeg\r\nContent-Length: %d\r\n\r\n"
  }
  注意0：上面的内容只是示例，具体内容需开发者根据实际情况来定
  注意1：上面的Content-Length: 后面的%d不要删除，会自动填充图片大小
  

• H3: string类型，H3是http消息中的boundary，需要和上面H1中的保持相同:

  xxxxxxxxxx
  H3 = "\r\n--123456789000000000987654321\r\n"
  注意：上面的内容只是示例，具体内容需开发者根据实际情况来定
  

返回值介绍

• Res: 返回1表示成功，可以忽略下面的Info，返回0表示失败，可以打印Info信息来定位失败原因

• Info:失败原因，可能是下面的其中一个

  xxxxxxxxxx
  "Uart time out": Core和Esp32Cam板子通信失败
  "ack staticIP STA config failed, esp will reset": 这种情况建议Core也跟着重启
  "ack cam init fail, esp will reset": 这种情况建议Core也跟着重启
  "ack web server httpd_start() fail, return code=xx":Http server开启失败
  "ack para not surport": 这种情况开发者请检查一下传入函数的参数是否在规定范围之内
  

(四)当Esp32Cam配置成Web server camera模式工作时:

参数介绍

• "Config": 表示开始进入配置流程。

• "WEB_VEDIO_ENHANCE": 表示将Esp32Cam配置成网络摄像机WebServer增强版。

• "UART0": 表示Core通过UART0(Tx0,Rx0)接口和Esp32Cam进行连接,也可以是"UART1"。

• HW: table类型，必须包含4个元素的字符串，定义如下:

  xxxxxxxxxx
  HW = 
  {
      "MySsid",--Wifi账号
      "MyPassword",--Wifi密码
      "FRAMESIZE_SVGA",--摄像头采集图片尺寸为SVGA，SVGA:800*600，尽量不要高于SVGA
      "12"--摄像头采集图片的质量为12，必须为"1"~"63",其中"1"质量最高
  }
  附注：上面的FRAMESIZE可以配置为如下种类:
  FRAMESIZE_QQVGA:160*120
  FRAMESIZE_QCIF:176*144
  FRAMESIZE_HQVGA:240*176
  FRAMESIZE_QVGA:320*240
  FRAMESIZE_CIF:400*296
  FRAMESIZE_VGA:640*400
  FRAMESIZE_SVGA:800*600
  FRAMESIZE_XGA:1024*768
  FRAMESIZE_SXGA:1280*1024
  FRAMESIZE_UXGA:1600*1200
  FRAMESIZE_QXGA:2048*1536
  

• IP: table类型，必须包含5个元素的字符串，定义如下:

  xxxxxxxxxx
  IP = 
  {
      "Dynamic",--表示动态IP模式，动态IP模式下，忽略下面5项，"Static"时需要配置下面5项
      "0.0.0.0",--本机IP地址
      "0.0.0.0",--gateway地址
      "0.0.0.0",--subnet地址
      "0.0.0.0",--首选DNS地址
      "0.0.0.0"--次选DNS地址
  }
  

• SERVER: table类型，必须包含2个元素的字符串，定义如下:

  xxxxxxxxxx
  SERVER = 
  {
      "80"--本机视频流Web http Server端口号
      "81"--本机视频流端口号
  }
  

• H1: table类型，H1是Web Server 回复客户端的视频流http header

  xxxxxxxxxx
  H1 = 
  {   
      "multipart/x-mixed-replace;boundary=123456789000000000987654321"
  }
  注意0：上面的内容只是示例，具体内容需开发者根据实际情况来定
  

• H2: table类型，H2是Web Server 回复客户端的图片信息描述,每行不要超过256个字符:

  xxxxxxxxxx
  H2 = 
  {
      "Content-Type: image/jpeg\r\nContent-Length: %d\r\n\r\n"
  }
  注意0：上面的内容只是示例，具体内容需开发者根据实际情况来定
  注意1：上面的Content-Length: 后面的%d不要删除，会自动填充图片大小
  

• H3: string类型，H3是http消息中的boundary，需要和上面H1中的保持相同:

  xxxxxxxxxx
  H3 = "\r\n--123456789000000000987654321\r\n"
  注意：上面的内容只是示例，具体内容需开发者根据实际情况来定
  

返回值介绍

• Res: 返回1表示成功，可以忽略下面的Info，返回0表示失败，可以打印Info信息来定位失败原因

• Info:失败原因，可能是下面的其中一个

  xxxxxxxxxx
  "Uart time out": Core和Esp32Cam板子通信失败
  "ack staticIP STA config failed, esp will reset": 这种情况建议Core也跟着重启
  "ack cam init fail, esp will reset": 这种情况建议Core也跟着重启
  "ack SD Card Mount Failed, esp will reset":这种情况建议Core也跟着重启
  "ack No SD Card attached, esp will reset":这种情况建议Core也跟着重启
  "ack error, file %s must not larger than 10240 bytes":SD卡中的.html太大，超过10K了
  "ack failed to open %s":无法打开SD卡上的html文件
  "ack httpd_start() web_httpd fail, err=%d, esp will reset":Http server开启失败，这种情况建议Core也跟着重启
  "ack httpd_start() stream_httpd fail, err=%d, esp will reset":Http 视频流服务开启失败，这种情况建议Core也跟着重启
  "ack para not surport": 这种情况开发者请检查一下传入函数的参数是否在规定范围之内
  

(五)其他:

返回值介绍

• Res: 返回1表示Wifi成功连上，返回0表示没连接上Wifi

• Info:当Res=1时，Info包含分配的动态IP或者静态IP地址字符串(比如:192.168.1.55); 当Res=0时，Info包含Wifi的状态字符串

  xxxxxxxxxx
  Wifi的状态字符串可能是如下一种:
  Uart time out
  WL_CONNECTED
  WL_NO_SHIELD
  WL_IDLE_STATUS
  WL_NO_SSID_AVAIL
  WL_SCAN_COMPLETED
  WL_CONNECT_FAILED
  WL_CONNECTION_LOST
  WL_DISCONNECTED
  UNKONW_ERROR
  

返回值介绍

• Res: 返回1表示指令下发成功，返回0表示和Esp32Cam的uart通信失败
• Info:当Res=1时，可以忽略Info; 当Res=0时，Info包含应该是"Uart time out"

返回值介绍

• Res: 返回1表示指令下发成功，返回0表示和Esp32Cam的uart通信失败
• Info:当Res=1时，可以忽略Info; 当Res=0时，Info包含应该是"Uart time out"

返回值介绍

• Res: 返回1表示指令下发成功，返回0表示和Esp32Cam的uart通信失败
• Info:当Res=1时，可以忽略Info; 当Res=0时，Info包含应该是"Uart time out"

返回值介绍

• Res: 返回1表示指令下发成功，返回0表示和Esp32Cam的uart通信失败
• Info:当Res=1时，Info体现用户通过Web网页发来的cmd指令，当Info="null"时此时Web网页客户端无cmd发来，否则有cmd发来。所以如果想及时获取客户端发来的cmd,开发者在lua代码中需及时调用本函数，建议100~200ms调用一次。

无线局域网

Ble低功耗蓝牙(仅C1支持)

LIB_NrfBleDefaultConfig(p1)

函数描述: 按默认参数配置蓝牙，如果对默认参数的值感兴趣，可查看LIB_NrfBleAdvanceConfig里的应用示例，里面的参数即为默认参数 注意: 如果你的项目中同时用到USB功能时，一定要先调用本函数初始化蓝牙之后，再调用LIB_UsbConfig()函数。

service描述: service包含两个特性(Characteristic): 一个用来发送数据，一个用来接收数据

• Rx Characteristic (UUID: 0x0002)用来接收手机的数据 手机蓝牙可以通过ATT Write方式向Rx Characteristic发送数据
• Tx Characteristic (UUID: 0x0003)用来向手机发送数据 如果手机蓝牙为Tx Characteristic使能了notification，那么设备就可以通过发送notification的方式向手机蓝牙发送数据

应用示例:

xxxxxxxxxx
--配置低功耗蓝牙以默认参数工作，设备名称为"MyBle001"
LIB_NrfBleDefaultConfig("MyBle001")

LIB_NrfBleAdvanceConfig(p1,p2,p3,p4,p5,p6,p7,p8,p9,p10,p11,p12)

函数描述: 按指定参数配置蓝牙 注意: 如果你的项目中同时用到USB功能时，一定要先调用本函数初始化蓝牙之后，再调用LIB_UsbConfig()函数。

service描述: service包含两个特性(Characteristic): 一个用来发送数据，一个用来接收数据

• Rx Characteristic (UUID: 0x0002)用来接收手机的数据 手机蓝牙可以通过ATT Write方式向Rx Characteristic发送数据
• Tx Characteristic (UUID: 0x0003)用来向手机发送数据 如果手机蓝牙为Tx Characteristic使能了notification，那么设备就可以通过发送notification的方式向手机蓝牙发送数据

应用示例:

xxxxxxxxxx
--按如下指定参数配置低功耗蓝牙工作:
--设备名称为"MyBle001"，广播间隔40ms,广播时长180秒循环广播
--最小连接间隔20ms,最大75ms，0间隔忽略，连接失效时间4秒
--第一次请求参数更新时间5秒，之后每次间隔30秒，尝试请求参数更新次数最多3次就放弃
--uuid类型为16bit，service uuid = 0x0001
LIB_NrfBleAdvanceConfig("MyBle001",40,18000,20,75,0,4000,5000,30000,3,1,0x0001)

r1,r2 = LIB_NrfBleRecv()

函数描述: 查询是否收到蓝牙数据，如果收到数据则返回接收到的蓝牙数据

应用示例:

xxxxxxxxxx
--配置低功耗蓝牙以默认参数工作，设备名称为"MyBle001"
LIB_NrfBleDefaultConfig("MyBle001")
--查询是否收到蓝牙数据，如果收到就print输出
while(true)
do
    recv_flag,recv_tab = LIB_NrfBleRecv()
    if recv_flag == 1 then
        print(string.format("receive %d bytes", #recv_tab))
    end
end

LIB_NrfBleSend(p1)

函数描述: 将table p1中的数据通过蓝牙发送出去

应用示例:

xxxxxxxxxx
--配置低功耗蓝牙以默认参数工作，设备名称为"MyBle001"
LIB_NrfBleDefaultConfig("MyBle001")
table = {1,2,3,4,5}
while(true)
do
    --每隔3秒发送一次数据
    LIB_NrfBleSend(table)
    LIB_DelayMs(3000)
end

r1 = LIB_NrfBleConnectQuery()

函数描述: 查询是否已和手机蓝牙建立连接

应用示例:

xxxxxxxxxx
--配置低功耗蓝牙以默认参数工作，设备名称为"MyBle001"
LIB_NrfBleDefaultConfig("MyBle001")
while(true)
do
    --每隔3秒查询一次是否已和手机蓝牙建立连接
    LIB_DelayMs(3000)
    if LIB_NrfBleConnectQuery() == 1 then
        print("ble connected")
    end
end

LIB_NrfBleIbeaconConfig(p1,p2,p3,p4,p5,p6)

函数描述: 按指定参数配置iBeacon蓝牙广播数据的具体内容，并开始工作 注意: 如果你的项目中同时用到USB功能时，一定要先调用本函数初始化iBeacon蓝牙之后，再调用LIB_UsbConfig()函数。

应用示例:

xxxxxxxxxx
--这里为了实验目的，任意定义了16个数据为作为uuid
uuid = {0xD0,0xD1,0xD2,0xD3,0xD4,0xD5,0xD6,0xD7,0xD8,0xD9,0xDA,0xDB,0xDC,0xDD,0xDE,0xDF}
--初始化iBeacon广播信息具体内容，并开启iBeacon蓝牙广播，注意：该函数只能调用一次
--CompanyID=0x004C, Major=0x1234, Minor=0x5678, rssi_1m=0xC3(-59db), 广播间隔=100ms
LIB_NrfBleIbeaconConfig(0x004C,0x1234,0x5678,0x3C,100,uuid)

LIB_NrfBleIbeaconUpdate(p1,p2)

函数描述: beacon开启之后，可以通过本函数来实时设置beacon蓝牙广播中Major和Minor的值，

应用示例:

xxxxxxxxxx
var1 = 0x1234
var2 = 0x5678
LIB_NrfBleIbeaconUpdate(var1,var2)

ThreadMesh组网(仅C1支持)

LIB_MeshConfig(p1,p2,p3)

函数描述: 配置设备的网络参数，如果设备是网络中的第一个节点，则自动形成Mesh网络，否则加入已存在的Mesh网络。 PanID参数和Channel参数用来决定加入哪个网络，并保证网络的唯一性，所以在同一个物理空间内，是可以共存多个PanID和Channel不一致的Mesh网络。

注意！ 如果用了2.4G Mesh，Ble低功耗蓝牙和USB接口就不能再用了。

应用示例:

xxxxxxxxxx
--配置设备为server节点并开始工作，网络参数为:Pan ID=0x1234 Channel=11
LIB_MeshConfig("Server",0x1234,11)

r1,r2,r3 = LIB_MeshServerRecvData()

函数描述: server查询是否收到client上传的data

应用示例:

xxxxxxxxxx
--配置设备为server节点并开始工作，网络参数为:Pan ID=0x1234 Channel=11
LIB_MeshConfig("Server",0x1234,11)
--查询是否收到数据，如果收到就print输出
while(true)
do
    recv_flag, recv_client_name, recv_data_tab = LIB_MeshServerRecvData()
    if recv_flag == 1 then
        print(string.format("receive %d bytes data from %s", #recv_data_tab, recv_client_name))
    end
end

LIB_MeshServerSendCommand(p1,p2)

函数描述: server向client下发8字节的命令数据。

注意1: 下发的command不会马上被client收到，而是取决于对应的client下次何时上传数据，server会自动在回复给client的response中附带上该command， 这样做是因为client有可能为低功耗传感器设备，并不会一直保持在线。

注意2: 下发的command并不保证一定会被client收到，比如下发一条command给"client01"还没被"client01"收到就被新下发给"client02"的command给覆盖了， 但是Core专门为名称是"CONTROL0" ~ "CONTROL9"的10个client分配了专有command缓存，所以mesh网络内最多可以有10个client可以确保接收命令不被其他client覆盖。

注意3：由于网络负荷大或其他原因，Core并不保证每次下发给client的command能够100%被client收到，这一点"CONTROL(0~9)"也不例外， 所以如果希望server下发的command 100%到达client，不仅client的名字需为“CONTROL(0~9)”，而且需要用户在应用层面上做保障，比如读取下一次client上传的状态 以确认上一次的command是否达到。

应用示例:

xxxxxxxxxx
cmd_tab = {1,2,3,4,5,6,7,8}
--向普通 client发送命令
LIB_MeshServerSendCommand("Client01",cmd_tab)
--向CONTROL client发送命令
LIB_MeshServerSendCommand("CONTROL0",cmd_tab)

r1 = LIB_MeshServerNetStateQuery()

函数描述: 查询sever当前的网络状态

应用示例:

xxxxxxxxxx
if LIB_MeshServerNetStateQuery() == 1 then
    print("Server had joined in mesh net\r\n")
end

r1,r2 = LIB_MeshClientRecvCommand()

函数描述: client查询是否收到server下发的8字节command

应用示例:

xxxxxxxxxx
recv_flag, recv_cmd_tab = LIB_MeshClientRecvCommand()
if recv_flag == 1 then
    print(string.format("receive %d bytes command from server", #recv_cmd_tab))
end

LIB_MeshClientSendData(p1,p2)

函数描述: client向server上传8字节的数据。 此上传过程如果失败Core会自动启动重发机制，如果系统重发了5次都没成功Core会认为和server已断开连接，可以通过LIB_MeshClientNetStateQuery函数查询到连接是否已断开

应用示例:

xxxxxxxxxx
data_tab = {1,2,3,4,5,6,7,8}
LIB_MeshClientSendData("Client01",data_tab)

r1 = LIB_MeshClientNetStateQuery()

函数描述: 查询client当前的网络状态

应用示例:

xxxxxxxxxx
link = LIB_MeshClientNetStateQuery()
if link == 0 then
    pirnt("Client had not joined in mesh net\r\n")
elseif link == 1 then
    print("Client had joined in mesh net\r\n")
elseif link == 2 then
    print("Client had joined in mesh and connected with server\r\n")
end

红外无线通信

LIB_IRConfig(p1)

函数描述: 配置红外无线模块占用的引脚端口，该模块适用于NEC编解码协议的红外编码和解码

应用示例:

xxxxxxxxxx
--设置红外无线模块占用TX0、RX0引脚，并使能接收和发送
LIB_IRConfig("UART0")

r1,r2 = LIB_IRRecv()

函数描述: 查询是否收到红外遥控数据，如果收到数据则返回接收到的3个字节的遥控数据内容。

应用示例:

xxxxxxxxxx
--设置红外无线模块占用TX0、RX0引脚，并使能接收和发送
LIB_IRConfig("UART0")
while(true)
do
    --查询是否收到红外数据，如果收到就print输出收到的数据
    recv_flag,recv_tab = LIB_IRRecv()
    if recv_flag == 1 then
        print(string.format("IR data =%02x %02x %02x", recv_tab[1],recv_tab[2],recv_tab[3]))
    end
end

LIB_IRSend(p1)

函数描述: 发送红外遥控数据，必须为包含3个字节的table

应用示例:

xxxxxxxxxx
--设置红外无线模块占用TX0、RX0引脚，并使能接收和发送
LIB_IRConfig("UART0")
table = {0x01,0x02,0x03} --红外遥控数据
while(true)
do
    --每隔5秒发送一次红外遥控数据，数据为 0x01,0x02,0x03
    LIB_IRSend(table)
    LIB_DelayMs(5000)
end

LIB_24G_Config(p1,p2,p3,p4,p5)

函数描述: 配置NRF24L01/SI24R1 2.4G无线模块占用SPI引脚，以及CE占用的GPIO引脚，并开始工作

应用示例:

xxxxxxxxxx
--发送模块和接收模块的地址Addr必须一样
Addr = {0x01,0x02,0x03,0x04,0x05}
--设置SI24R1 2.4G无线模块占用MOSI,MISO,CLK,cs,以及D5引脚
--通信信道在2480Mhz，速率125K，发射功率为最大的7dB
LIB_24G_Config("D5", Addr, 80, "125Kpbs", "7dB")

r1,r2 = LIB_24G_Recv()

函数描述: 查询是否收到2.4G对端发来的数据，如果收到数据则返回接收到的数据来源及内容。注意对端发来的每个数据包不要大于32字节，且数据包时间间隔尽量不要小于100ms 注意：由于SI24R1底层收发数据已被固定为每包32字节，所以每次不管对方发送多少字节过来，都是收到32字节，只是多余的字节都会为0。

应用示例:

xxxxxxxxxx
--发送模块和接收模块的地址Addr必须一样
Addr = {0x01,0x02,0x03,0x04,0x05}
--设置SI24R1 2.4G无线模块占用MOSI,MISO,CLK,cs,以及D5引脚
--通信信道在2480Mhz，速率125K，发射功率为最大的7dB
LIB_24G_Config("D5", Addr, 80, "125Kpbs", "7dB")
while(GC(1) == true)
do
    --查询是否收到数据，如果收到就print输出收到的数据个数,固定为32个
    recv_flag,recv_tab = LIB_24G_Recv()
    if recv_flag == 1 then
        print(string.format("receive %d bytes", #recv_tab))
    end
end

LIB_24G_Send(p1)

函数描述: 将p1数组中的数据发送给对端，每包发送的数据量不要超过32字节，每包发送间隔时间也尽量大于100ms 注意：由于SI24R1底层收发数据已被固定为每包32字节，所以不管每次发送多少字节，实际都是32字节，只是多余的字节都会为0。

应用示例:

xxxxxxxxxx
--发送模块和接收模块的地址Addr必须一样
Addr = {0x01,0x02,0x03,0x04,0x05}
--设置SI24R1 2.4G无线模块占用MOSI,MISO,CLK,cs,以及D5引脚
--通信信道在2480Mhz，速率125K，发射功率为最大的7dB
LIB_24G_Config("D5", Addr, 80, "125Kpbs", "7dB")
tab = {1,2,3,4,5}
while(GC(1) == true)
do
    --每隔5秒向对端发送一包5字节的数据,实际上是32字节，只是多余的字节都会为0
    LIB_24G_Send(tab)
    LIB_DelayMs(5000)
end

无线广域网

Wifi TCP通信(esp8266)

LIB_WifiTcpConfig(p1,p2,p3,p4,p5,p6,p7)

函数描述: 配置WIFI模块(esp8266)占用的引脚端口，并以TCP Client方式和Server(服务器)通信

注意1：心跳包是由开发者在Lua代码中以不大于p7的心跳时间间隔向服务器发送一包数据，并且服务器应返回心跳包响应数据。心跳包及响应的具体内容和长度由您和服务器端开发人员商量。 注意2：当p7的值为0的时候，Core默认关闭心跳机制(即Core不会因为服务器长时间没有数据下发而重启wifi模块)，但真正开发产品时还是需要您和服务器端开发人员商量好心跳包的策略，这样就能保证wifi模块常年不掉线。

应用示例:

xxxxxxxxxx
--设置esp8266 Wifi模块占用TX0、RX0、D5引脚，TCP Client模式
--路由器账号:mywifi 路由器密码:abc123，tcp服务器域名:www.shineblink.com 端口号:1266
--心跳包间隔时间0秒(不使用心跳机制)。如果需要使用请在ApiDoc文档中查阅关于LIB_WifiTcpConfig函数的p7参数详细介绍
LIB_WifiTcpConfig("UART0","D5","mywifi","abc123","www.shineblink.com",1266,0)

r1,r2 = LIB_WifiTcpRecv()

函数描述: 查询是否收到TCP server发来数据，如果收到数据则返回接收到的数据。注意服务端下发的每个数据包尽量不要大于256字节，且数据包时间间隔尽量不要小于100ms

应用示例:

xxxxxxxxxx
--设置esp8266 Wifi模块占用TX0、RX0、D5引脚，TCP Client模式
--路由器账号:mywifi 路由器密码:abc123，tcp服务器域名:www.shineblink.com 端口号:1266
--心跳包间隔时间0秒(不使用心跳机制)。如果需要使用请在ApiDoc文档中查阅关于LIB_WifiTcpConfig函数的p7参数详细介绍
LIB_WifiTcpConfig("UART0","D5","mywifi","abc123","www.shineblink.com",1266,0)
while(true)
do
    --查询是否收到数据，如果收到就print输出收到的字节数
    recv_flag,recv_tab = LIB_WifiTcpRecv()
    if recv_flag == 1 then
        print(string.format("tcp receive %d bytes", #recv_tab))
    end
end

LIB_WifiTcpSend(p1)