天启教育M1开发板开发教程：编程篇-天启主板Python接口

1.1、天启主板外设接口

import模块名: tqmain

1.1.1、点阵屏使能控制

函数用法： tqmain.matri_enable(enable)

功能描述：点阵屏使能控制

**输入项：

enable：使能状态

返回值：无

1.1.2、关闭点阵屏显示

函数用法： tqmain.matri_offall()

功能描述：关闭点阵屏显示

输入项：无

返回值：无

1.1.3、点阵屏亮度控制

函数用法： tqmain.matri_set_brightness(value)

功能描述：点阵屏使能控制

输入项：

value：亮度

返回值：无

1.1.4、点阵屏显示或熄灭某个坐标灯

函数用法：**tqmain.matri_strfill_display(value)

功能描述：点阵屏显示或熄灭某个坐标灯

输入项： value ：字符串

例如： value= ‘1000000,1000000,1000000,1000000,1000000,1000000’

点亮： 1

熄灭： 0

返回值：无

1.1.5、点阵屏显示图案

函数用法： tqmain.matri_fill_display(value1, value2)

功能描述：点阵屏显示图案

输入项：

value1：图案转化的数值1

Value2：图案转化的数值2

返回值：无

1.1.6、点阵屏显示文字

函数用法： tqmain.matri_string_display(value)

功能描述：点阵屏显示文字内容

输入项：

value：文字内容

返回值：无

1.1.7、点阵屏绘制条形图

函数用法： tqmain.matri_bar_chart(val,totalVal)

功能描述：点阵屏绘制条形图

输入项：

val：设定当前条形图高度数值

totalVal：设定条形图总高度数值

返回值：无

1.1.8 三轴传感器初始化

函数用法： tqmain.sc7a20_init()

功能描述：三轴传感器初始化

输入项：无

返回值：无

1.1.9 获取三轴传感器姿态

函数用法： tqmain.sc7a20_get_motion()

功能描述：获取三轴传感器姿态

输入项：无

返回值：

获取姿态：

0：摇晃

1：向上倾斜

2：向下倾斜

3：向左倾斜

4：向右倾斜

5：正面朝上

6：正面朝下

1.1.10 获取三轴传感器x轴加速度

函数用法： tqmain.sc7a20_get_acc_x()

功能描述：获取三轴传感器x轴加速度

输入项：无

返回值：x轴加速度

1.1.11 获取三轴传感器y轴加速度

函数用法： tqmain.sc7a20_get_acc_y()

功能描述：获取三轴传感器y轴加速度

输入项：无

返回值：x轴加速度

1.1.12 获取三轴传感器z轴加速度

函数用法： tqmain.sc7a20_get_acc_z()

功能描述：获取三轴传感器z轴加速度

输入项：无

返回值：x轴加速度

1.1.13 获取三轴传感器姿态字符串

函数用法： tqmain.get_acceleration()

功能描述：获取三轴传感器姿态

输入项：无

返回值：

获取姿态：

shake ：摇晃

up ：向上倾斜

down ：向下倾斜

left ：向左倾斜

right ：向右倾斜

face up：正面朝上

face down：正面朝下

1.1.15 串口打印

函数用法：tqmain.serial_write_line(value)

功能描述：串口打印内容

输入项： value ：字符串、整数或者小数**

返回值：无

1.2、天启wifi部分相关接口

import模块名 : wifi

1.2.1、连接到WiFi热点

函数用法： wifi.wlan_connect(ssid,password)

功能描述：连接到WiFi热点

输入项：

ssid：热点名称

password ：热点密码

返回值：无

1.2.2、热点连接判断

函数用法： wifi.wlan_is_connected()

功能描述：判断热点是否连接成功

输入项：无

返回值：

0：失败

1：成功

1.2.3、创建热点局域网

函数用法： wifi.build_local_network(ssid, psk)

功能描述：创建局域网热点

输入项：

ssid：热点名称

psk：热点密码

返回值：无

1.2.4、给指定局域网的地址号发送数据

函数用法： wifi.send_local_network_message(send,ip);

功能描述：给指定局域网的地址号发送数据

输入项：

send：文字内容

ip：地址号

返回值：无

1.2.5、连接指定热点局域网,并设置地址号

函数用法： wifi.connet_local_network(ssid, psk ,ip)

功能描述：连接指定热点局域网,并设置地址号

输入项：

ssid：ap名称

psk：ap密码

ip ：地址号

返回值：无

1.2.6、接收到局域网的数据

函数用法： wifi.read_local_network_message()

功能描述：接收到局域网的数据

输入项：无

返回值：接受到数据内容

1.2.7、设置id名称

函数用法： wifi.mqtt_set_id(id)

功能描述：设置id名称

输入项：

id：id内容

返回值：无

1.2.8、连接mqtt

函数用法： wifi.mqtt_connect()

功能描述：连接mqtt

输入项：无

返回值：无

1.2.9、判断连接是否成功

函数用法： wifi.mqtt_is_connected(）

功能描述：判断连接是否成功

输入项：无

返回值：

0：失败

1：成功

1.2.10、断开连接

函数用法： wifi.mqtt_disconnect()

功能描述：断开连接

输入项：无

返回值：无

1.2.11、发布消息到主题

函数用法： wifi.mqtt_publish_topic_msg(topic,messagedata)

功能描述：发布消息到主题

输入项：

topic：主题内容

messagedata ：消息内容

返回值：无

1.2.12、订阅消息

函数用法： wifi.mqtt_subscribe(topic,"none")

功能描述：订阅消息

输入项：

topic：主题内容

none：指定字符串

返回值：无

1.2.13、接受消息数据

函数用法： wifi. mqtt_receive_message(）

功能描述：接受消息数据

输入项：无

返回值：接受消息内容

1.2.14、发布离线消息到主题

函数用法： wifi. publish_offline_msg(topic,messagedata)

功能描述：发布离线消息到主题

输入项：

topic：主题

messagedata ：消息内容

返回值：无

1.2.15、设置mqtt服务器信息

函数用法： wifi. mqtt_set_msg(host,port,clientid,username,password)

功能描述：设置mqtt服务器信息

输入项：

host： 地址

port： 端口

clientid： 客户端id

username：账号

password：密码

返回值：无

1.3****主板内部计时器

import模块名: timer

1.3.1、计时器归零

函数用法： timer.reset()

功能描述：计时器归零

输入项：无

返回值：无

1.3.2、获取计时器计时秒数

函数用法： timer.get_time()

功能描述：获取计时器计时秒数

输入项：无

返回值：计时器已经计时的秒数

1.4 主板内部数学计算

import模块名: tqmath

1.4.1、 sin函数

函数用法： tqmath.sin(num)

功能描述：计算sin值

输入项：

num：数字

返回值：sin结果

1.4.2、 cos函数

函数用法： tqmath.cos(num)

功能描述：计算cos值

输入项：

num：数字

返回值：cos结果

1.4.3、 tan函数

函数用法： tqmath.tan(num)

功能描述：计算tan值

输入项：

num：数字

返回值：tan结果

1.4.4、 asin函数

函数用法： tqmath.asin(num)

功能描述：计算asin值

输入项：

num：数字

返回值：asin结果

1.4.5、 acos函数

函数用法： tqmath.acos(num)

功能描述：计算acos值

输入项：

num：数字

返回值：acos结果

1.4.6、 atan函数

函数用法： tqmath.atan(num)

功能描述：计算atan值

输入项：

num：数字

返回值：atan结果

1.4.7、 log函数

函数用法： tqmath.log(num)

功能描述：计算log值

输入项：

num：数字

返回值：log结果

1.4.8、 log10函数

函数用法： tqmath.log10(num)

功能描述：计算log10值

输入项：

num：数字

返回值：log10结果

1.4.9、 平方函数

函数用法： tqmath.sq(num)

功能描述：计算平方值

输入项：

num：数字

返回值：平方结果

1.4.10、 平方根函数

函数用法： tqmath.sqrt(num)

功能描述：计算平方根值

输入项：

num：数字

返回值：平方根结果

1.4.11、 幂函数

函数用法： tqmath.pow(num1, num2)

功能描述：计算num1的num2次方

输入项：

num1, num2：数字

返回值：幂结果

1.4.12、 约束函数

函数用法： tqmath.constrain(num1, num2, num3)

功能描述：约束num1在num2到num3之间

输入项：

num1, num2, num3：数字

返回值：约束后的结果

1.4.13、 映射函数

函数用法： tqmath.map(num, rangeL1, rangeH1, rangeL2, rangeH2)

功能描述：把num从rangeL1到rangeH1映射到rangeL2到rangeH2

输入项：

num, rangeL1, rangeH1，rangeL2，rangeH2：数字

返回值：约束后的结果

1.4.14、 绝对值函数

函数用法： tqmath.abs(num)

功能描述：计算数字绝对值

输入项：

num：数字

返回值：绝对值结果

1.4.15、 取整（四舍五入）函数

函数用法： tqmath.round(num)

功能描述：四舍五入取整

输入项：

num：数字

返回值：取整结果

1.4.16、 取整（向上舍入）函数

函数用法： tqmath.ceil(num)

功能描述：向上舍入取整

输入项：

num：数字

返回值：取整结果

1.4.17、 取整（向下舍入）函数

函数用法： tqmath.floor(num)

功能描述：向下舍入取整

输入项：

num：数字

返回值：取整结果

1.4.18、 取随机数

函数用法： tqmath.random(num1, num2)

功能描述：取num1和num2之间的随机整数

输入项：

num1：数字

num2：数字

返回值：取随机整数结果

1.5 主板内部延时函数

import模块名: os

1.5.1、延时秒

函数用法： os.sleep(s)

功能描述：延时秒

输入项：

s：延时秒数

返回值：无

1.5.2、延时毫秒

函数用法： os.msleep(ms)

功能描述：延时毫秒

输入项：

ms：延时毫秒数

返回值：无