天启教育M1开发板开发教程：编程篇-天启立方小车

import模块名: tqc

4.1、获取声音强度
函数用法：tqc.voice_get_intensity()
功能描述：获取声音强度
输入项：无
返回值：声音强度（范围：0 ~ 100）

4.2、控制蜂鸣器节拍
函数用法：tqc.buzzer_set_beat(tune, duration)
功能描述：控制蜂鸣器节拍
输入项：
tune：音调，3 ~ 7：C5的3 ~ 7；8 ~ 14：C6的1 ~ 7；15 ~ 21：C7的1 ~ 7；22 ~ 28：C8的1 ~ 7
duration：持续几个base（拍音调持续时间， base时间是1/4拍，125ms）
返回值：无

4.3、控制蜂鸣器音乐
函数用法：tqc.buzzer_set_music(type)
功能描述：控制蜂鸣器节拍
输入项：
type：音乐类型
1：生日快乐
2：欢乐颂
3：葫芦娃
返回值：无

4.4、停止蜂鸣器音乐播放
函数用法：tqc.buzzer_close()
功能描述：停止蜂鸣器音乐播放
输入项：无
返回值：无

4.5、获取双路循迹传感器检测状态
函数用法：tqc.get_trace_status( dir)
功能描述：获取双路循迹传感器检测状态。
输入项：
dir：获取的哪一路状态
0：左路
1：右路
返回值：当前检测的状态
0：黑
1：白
其他：异常

4.6、获取避障传感器检测状态
函数用法：tqc.get_avoid_status(value)
功能描述：获取避障传感器检测状态。
输入项：
Value: 1 ~ 5 检测灵敏度
返回值：检测状态。
0：前方无障碍物。
1：前方有障碍物。

4.7、获取rgb颜色传感器检测状态
函数用法：tqc.get_rgb_status(color)
功能描述：获取颜色传感器检测的状态，只能检测红、绿、蓝。
输入项：要检测的颜色
0：红色
1：绿色
2：蓝色
返回值：返回检测状态。
0：当前颜色与检测颜色不一致。
1：当前颜色与检测颜色一致。

4.8、控制左右电机(非阻塞)
函数用法：tqc.motor_set_dir(option,left_dir,right_dir,speed)
功能描述：控制左右步进电机的正反转。
输入项：
option：选择控制电机
0：控制左右电机
1：控制左电机
2：控制右电机
left_dir：控制左电机正反转
0：左电机反转
1：左电机正转
right_dir：控制右电机正反转
0：右电机反转
1：右电机正转
speed：电机转速，取值1 ~ 5
返回值：无

4.9、控制步进电机停止
函数用法：tqc.motor_stop(dir)
功能描述：控制选择的步进电机停止。
输入项：控制选择的电机
dir：控制选择的电机
0：停止所有电机
1：停止左电机
2：停止右电机
返回值：无

4.10、控制小车旋转
函数用法：tqc.car_set_angle(dir,angle,speed)
功能描述：控制小车左旋转、右旋转、
输入项：
dir：控制小车旋转方向
0：左旋转
1：右旋转
angle：控制小车转动的角度，取值1 ~ 180
speed：电机转速，取值1 ~ 5
返回值：无

4.11、控制小车前进或后退距离
函数用法：tqc.car_set_distance(dir,distance,speed)
功能描述：控制小车前进或后退指定的距离
输入项：dir：控制小车前进或后退
0：后退
1：前进
distance：控制小车前进或者后退的距离，取值1 ~ 255
speed：电机转速，取值1 ~ 5
返回值：无

4.12、控制车轮转动的圈数
函数用法：tqc.car_set_wheel(dir,wheel,speed)
功能描述：控制车轮转动的圈数
输入项：dir：控制车轮正转或反转
0：反转
1：正转
wheel：控制正转或反转的圈数，取值1 ~ 255
speed：电机转速，取值1~5
返回值：无

4.13、设置rgb颜色传感器灯
函数用法：tqc.set_rgb(color)
功能描述：只能设置红、绿、蓝其中一种。
输入项：要设置的颜色
0：关闭
0x01：红色
0x02：绿色
0x04：蓝色
0x03：黄色
0x06：青色
0x05：紫色
0x07：白色
返回值：无

4.14、切换到无屏编程模式
函数用法：tqc.switch_mode()
功能描述：从IDE模式切换到无屏编程模式
输入项：无
返回值：无

4.15、小车是否停止
函数用法：tqc.get_car_staus()
功能描述：返回小车的运行状态
输入项：无
返回值：返回运行状态。
0：停止状态。
1：运行状态。