中鸣RCU使用指南

一. 控制器

1.1 控制器任务<1-8>

功能：程序起始模块，程序运行时会执行其下方模块
参数：1-8，定义函数，表示任务序号

import rcu # 导入rcu库
def task1():  # 定义任务1
    pass
task1()  # 执行任务1

#define _TASK_1_ 1
#include "JMLib.c"

void task1(void); //执行任务1

void task1(void)  //定义任务1
{
  pass
}

1.2 按下左键？/按下右键？

1.2.1 按下左键

功能：检测控制器的左侧按键是否被按下
返回值：1/0，按下时返回数值1，未按下时返回数值0

import rcu  # 导入rcu库
if rcu.GetLeftButton():
	pass

#include <GetLeftButton.h>
if (GetLeftButton()){
	pass
}

1.2.2 按下右键

功能：检测控制器的右侧按键是否被按下
返回值：1/0，按下时返回数值1，未按下时返回数值0

import rcu  # 导入rcu库
if rcu.GetRightButton():
	pass

#include <GetRightButton.h>
if (GetRightButton()){
	pass
}

1.3 麦克风音量

功能：读取控制器内置麦克风检测的声音大小值
返回值：0-4095，只表示音量大小无具体单位

import rcu  # 导入rcu库
if (rcu.GetInMic() == 50):
	pass

#include <GetInMic.h>
if (rcu.GetInMic() == 50){
	pass
}

1.4 电池电压

功能：读取控制器此时电源电压值
返回值：0-100，当数据为84时电压为8.4V

import rcu  # 导入rcu库
if (rcu.GetInVotage() == 50):
	pass

#include <GetInVotage.h>
if (GetInVotage() == 50){
	pass
}

1.5 控制器时间

功能：读取程序运行至今的时间
返回值：数值单位为毫秒，数值1000时为1秒

import rcu  # 导入rcu库
if (rcu.GetSysTime() == 50):
	pass

#include <GetSysTime.h>
if (rcu.GetSysTime() == 50){
	pass
}

1.6 控制器时间归零

功能：控制器运行程序后，内置时钟归零

import rcu  # 导入rcu库
rcu.SetSysTime()

#include <SetSysTime.h>
SetSysTime();

1.7 蜂鸣器开/关

功能：开启或关闭蜂鸣器
蜂鸣器有两种状态
- 开：1
- 关：0
参数：0/1，1表示开启，0表示关闭

import rcu  # 导入rcu库
rcu.SetInBeep(参数)

#include <SetInBeep.h>
SetInBeep(参数);

1.8 设置声音频率（）Hz 时间（）s

功能：设置蜂鸣器的音调以及播放时长
传入两个参数：(频率,时间)
- 参数1：不同频率能发出不同声音，Hight代表高音Low代表低音
  - High Do：1047
  - High Re：1175
  - High Mi：1319
  - High Fa：1397
  - High So：1568
  - High La：1760
  - High Si：1976
  - Do：523
  - Re：587
  - Mi：659
  - Fa：698
  - So：784
  - La：880
  - Si：988
  - Low Do：262
  - Low Re：294
  - Low Mi：330
  - Low Fa：349
  - Low So：392
  - Low La：440
  - Low Si：494
- 参数2：播放音调持续时间
  - 双拍：(2 * 1000)
  - 一拍：(1 * 1000)
  - 半拍：(0.5 * 1000)
  - 1/4拍：(0.25 * 1000)
  - 1/8拍：(0.125 * 1000)

import rcu  # 导入rcu库
rcu.SetInSound(参数1,参数2)

#include <SetInSound.h>
SetInSound(参数1,参数2);

1.9 地址（）数据值

功能：读取控制器内置数据的数值
参数：1-156，对应内置地址名称
返回值：控制器内置地址数据值

import rcu  # 导入rcu库
rcu.GetData(参数)

#include <GetData.h>
GetData(参数);

1.10 地址（）数据值设为（）

功能：将控制器指定内置数据设为指定值
参数1：1-156，对应内置地址名称
参数2：1-4095，赋予内置地址数据值

import rcu  # 导入rcu库
rcu.SetData(参数1,参数2)

1.11 发送串口数据（）波特率（）

功能：发送串口数据
参数1：发送的数据，数字或文本类型
参数2：一个单位时间内传输符号的个数，默认9600

import rcu  # 导入rcu库
rcu.SetUartData(参数1,参数2)

#include <SetUartData.h>
SetUartData(参数1,参数2);

1.12 接收串口数据波特率（）

功能：接收串口数据
参数：一个单位时间内传输符号的个数，默认9600
返回值：串口发送的数据，数字或文本类型

二. 马达

2.1 马达（）以速度（）转动

功能：使马达以指定速度运转
参数1：1~4，分别表示马达连接端口M1-M4
参数2：-100-100，马达速度数值越大速度越快，0停止，小于0则反转，大于0则正转

import rcu  # 导入rcu库
rcu.SetMotor(参数1,参数2)

#include <SetMotor.h>
SetMotor(参数1,参数2);

2.2 马达()编码器数值

功能：读取马达编码器数值，起到记录马达转动角度的作用
参数：1~4，马达连接端口
返回值：马达转动的角度值，数值1表示转动1度，有正负区分

import rcu  # 导入rcu库
rcu.GetMotorCode(参数)

#include <GetMotorCode.h>
GetMotorCode(参数);

2.3 马达（）编码器归零

功能：将编码器记录的数值清零
参数：1~4，马达连接端口

import rcu  # 导入rcu库
rcu.SetMotorCode(参数)

#include <SetMotorCode.h>
SetMotorCode(参数);

2.4 设置伺服马达（）以速度（）旋转（）

功能：设置马达转动到指定角度
参数1：1~4，马达连接端口
参数2：-100-100，马达速度
参数3：马达旋转的角度

import rcu  # 导入rcu库
rcu.SetMotorServo48(参数1,参数2,参数3)

#include <SetMotorServo48.h>
SetMotorServo48(参数1,参数2,参数3);

2.5 等待伺服马达（）以速度（）旋转（）

功能：等待马达转动到指定角度，再执行下方程序
参数1：1~4，马达连接端口
参数2：-100-100，马达速度
参数3：马达旋转的角度

import rcu  # 导入rcu库
rcu.SetWaitForAngle48(参数1,参数2,参数3)

#include <SetWaitForAngle48.h>
SetWaitForAngle48(参数1,参数2,参数3)

2.6 设置伺服马达(橙)（）速度（）角度（）

功能：设置马达转动到指定角度
参数1：1~4，马达连接端口
参数2：-100-100，马达速度
参数3：马达旋转的角度

import rcu  # 导入rcu库
rcu.SetMotorServo128(参数1,参数2,参数3)

#include <SetMotorServo128.h>
SetMotorServo128(参数1,参数2,参数3);

2.7 等待伺服马达(橙)（）速度（）角度（）

功能：等待马达转动到指定角度，再执行下方程序
参数1：1~4，马达连接端口
参数2：-100-100，马达速度
参数3：马达旋转的角度

import rcu  # 导入rcu库
rcu.SetWaitForAngle128(参数1,参数2,参数3)

#include <SetWaitForAngle128.h>
SetWaitForAngle128(参数1,参数2,参数3)

2.8 马达（）（）以速度（）编码（）前进

功能：使两个马达同步转动指定编码
参数1：1~4，马达连接端口
参数2：1~4，马达连接端口
参数3：-100-100，马达速度
参数4：0-2147483647，马达旋转的编码值

import rcu  # 导入rcu库
rcu.SetMotorStraightAngle(参数1,参数2,参数3,参数4)

#include <SetMotorStraightAngle.h>
SetMotorStraightAngle(参数1,参数2,参数3,参数4);

2.9 马达（）（）以速度（）编码（）转弯

功能：使两个马达同步转动指定编码
参数1：1~4，马达连接端口
参数2：1~4，马达连接端口
参数3：-100-100，马达速度
参数4：0-2147483647，马达旋转的编码值

import rcu  # 导入rcu库
rcu.SetCarTurn(参数1,参数2,参数3,参数4)

#include <SetCarTurn.h>
SetCarTurn(参数1,参数2,参数3,参数4);

2.10 马达功率M1（）M2（）M3（）M4（）

功能：设置马达最大功率，用于调整马达差异，重启控制器后会复原。
参数1：-100-100，M1马达功率百分比
参数2：-100-100，M2马达功率百分比
参数3：-100-100，M3马达功率百分比
参数4：-100-100，M4马达功率百分比

import rcu  # 导入rcu库
rcu.SetMotorPower(参数1,参数2,参数3,参数4)

#include <SetMotorPower.h>
SetMotorPower(参数1,参数2,参数3,参数4);

2.11 设置双马达走直线（）（）速度（）

功能：使两个马达同步转动
参数1：1~4，马达连接端口
参数2：1~4，马达连接端口
参数3：-100-100，马达速度

import rcu  # 导入rcu库
rcu.SetMotorStraight(参数1,参数2,参数3)

#include <SetMotorStraight.h>
SetMotorStraight(参数1,参数2,参数3);

2.12 设置双马达走同步转弯（）（）速度（）角度（）

功能：使两个马达同步转动指定角度
参数1：1~4，马达连接端口
参数2：1~4，马达连接端口
参数3：-100-100，马达速度
参数4：马达旋转的角度

import rcu  # 导入rcu库
rcu.SetMotorStraightTurn(参数1,参数2,参数3,参数4)

#include <SetMotorStraightTurn.h>
SetMotorStraightTurn(参数1,参数2,参数3,参数4);

2.13 小型舵机（）转动角度（）

功能：使小型舵机转动指定角度
参数1：1~3，对应M6的P3-P5、E6的P4-P6，小型舵机连接端口
参数2：0-180，小型舵机的转动角度

import rcu  # 导入rcu库
rcu.SetServo(参数1,参数2)

#include <SetServo.h>
SetServo(参数1,参数2);

2.14 小型舵机调速（）转动角度（）持续（）毫秒

功能：使小型舵机在指定时间内转动指定角度
参数1：1~3，对应M6的P3-P5、E6的P4-P6，小型舵机连接端口
参数2：0-180，小型舵机的转动角度
参数3：转动时间，数值为毫秒单位，数值1000时为1秒

import rcu  # 导入rcu库
rcu.SetServoTime(参数1,参数2,参数3)

#include <SetServoTime.h>
SetServoTime(参数1,参数2,参数3);

2.15 设置单通道伺服马达控制()通道编号()角度()时间()（ms）

功能：未知
参数1：1~8，对应P1-P8
参数2：未知
参数3：0-180，小型舵机的转动角度
参数4：转动时间，数值为毫秒单位

import rcu  # 导入rcu库
rcu.SetOneServo(参数1,参数2,参数3,参数4)

#include <SetOneServo.h>
SetOneServo(参数1,参数2,参数3,参数4);

2.16 数字舵机（）转动角度（）持续（）毫秒

功能：未知
参数1：1~5，对应M6的P1-P5，对应E6的P1-P8
参数2：0-180，舵机的转动角度
参数3：转动时间，数值为毫秒单位

import rcu  # 导入rcu库
rcu.SetMagneticServoDegreeTime(参数1,参数2,参数3)

#include <SetMagneticServoDegreeTime.h>
SetMagneticServoDegreeTime(参数1,参数2,参数3);

2.17 数字舵机（）转动角度（）速度（）

功能：未知
参数1：1~5，对应M6的P1-P5，对应E6的P1-P8
参数2：0-180，舵机的转动角度
参数3：-100-100，马达速度

import rcu  # 导入rcu库
rcu.SetMagneticServoDegreeSpeed(参数1,参数2,参数3)

#include <SetMagneticServoDegreeSpeed.h>
SetMagneticServoDegreeSpeed(参数1,参数2,参数3)

2.18 数字舵机（）目标编码（）速度（）

功能：未知
参数1：
- 1_{5，对应M6的P1}P
- 1_{8，对应E6的P1}P8
参数2：0-2147483647，舵机旋转的编码值
参数3：-100-100，舵机速度

import rcu  # 导入rcu库
rcu.SetMagneticServoCodeMotor(参数1,参数2,参数3)

#include <SetMagneticServoCodeMotor.h>
SetMagneticServoCodeMotor(参数1,参数2,参数3)

2.18 设置伺服舵机（）转动角度（）

功能：未知
参数1：1~3，对应M6的P3-P5、E6的P4-P6，小型舵机连接端口
参数2：0-180，舵机的转动角度

import rcu  # 导入rcu库
rcu.SetSeeringEngine(参数1,参数2)

#include <SetSeeringEngine.h>
SetSeeringEngine(参数1,参数2)；

2.19 设置伺服舵机调速（）转动角度（）持续（）毫秒

功能：未知
参数1：1~3，对应M6的P3-P5、E6的P4-P6，小型舵机连接端口
参数2：0-180，舵机的转动角度
参数3：转动时间，数值为毫秒单位

import rcu  # 导入rcu库
rcu.SetSeeringEngineTime(参数1,参数2,参数3)

#include <SetSeeringEngineTime.h>
SetSeeringEngineTime(参数1,参数2,参数3)

三. 传感器

3.1 触碰传感器

功能：判断触碰传感器是否被按下
参数：1~8，对应P1-P8，传感器端口
返回值：0/1，按下返回1，否则返回0

import rcu  # 导入rcu库
rcu.GetTouch(参数)

#include <GetTouch.h>
GetTouch(参数);

3.2 颜色传感器

功能：读取颜色传感器检测物体的颜色值
参数：1~8，对应P1-P8，传感器端口
返回值：1-6，对应红、绿、蓝、黄、黑、白色

import rcu  # 导入rcu库
rcu.GetColorSensor(参数,4)

#include <GetColorSensor.h>
GetColorSensor(参数,4);

3.3 超声波传感器

功能：读取超声传感器与障碍物的距离值
参数：1~8，对应P1-P8，传感器端口
返回值：7-180，单位cm

import rcu  # 导入rcu库
rcu.GetUltrasound(参数)

#include <GetUltrasound.h>
GetUltrasound(参数);

3.4 光电传感器

3.4.1 光电传感器（）数值

功能：读取光电传感器检测物体的颜色深度值
参数：1~8，对应P1-P8，传感器端口
返回值：0-4095，数值随着被测物体颜色越深而减少

import rcu  # 导入rcu库
rcu.GetLightSensor(参数)

#include <GetLightSensor.h>
GetLightSensor(参数);

3.4.2 光电传感器（）数字数值

功能：判断光电传感器检测的物体颜色深度是否小于阈值
参数：1~8，对应P1-P8，传感器端口
返回值：0/1，低于阈值返回1，否则返回0

import rcu  # 导入rcu库
rcu.GetLightSensorData(参数)

#include <GetLightSensorData.h>
GetLightSensorData(参数);

3.4.3 光电传感器（）灯（）

功能：开启或关闭光电传感器的LED灯
参数1：1~8，对应P1-P8，传感器端口
参数2：0/1，开灯为1，关灯为0

import rcu  # 导入rcu库
rcu.SetLightSensorLed(参数1,参数2)

#include <SetLightSensorLed.h>
SetLightSensorLed(参数1,参数2);

3.5 彩灯模块

功能：设置彩灯模块的显示颜色
参数1：1~8，对应P1-P8，传感器端口
参数2：彩灯颜色 0~7
- “红色”：1
- “绿色”：2
- “蓝色”：3
- “黄色”：4
- “紫色”：5
- “青色”：6
- “白色”：7
- “关” ：0

import rcu  # 导入rcu库
rcu.Set3CLed(参数1,参数2)

#include <Set3CLed.h>
Set3CLed(参数1,参数2);

3.6 手势识别传感器

功能：读取手势识别传感器对应端口的数值
参数：1~8，对应P1-P8，传感器端口
返回值：手势识别传感器对应端口的的数值

import rcu  # 导入rcu库
rcu.GetGesture(参数)

#include <GetGesture.h>
GetGesture(参数);

3.7 摄像头

3.7.1 摄像头遥感值（）

功能：未知
参数：0~3
- 左摇杆X轴：0
- 左摇杆Y轴：1
- 右摇杆X轴：2
- 右摇杆Y轴：3
返回值：对应轴的遥感值

import rcu  # 导入rcu库
rcu.GetWifiCamRockCtrlNew(参数)

#include <GetWifiCamRockCtrlNew.h>
GetWifiCamRockCtrlNew(参数);

3.7.2 摄像头检测结果（）

功能：未知
参数：0~3
- 二维码ID：0
- 图像面积：1
- 图像X坐标：2
- 图像Y坐标：3
返回值：摄像头检测值

import rcu  # 导入rcu库
rcu.GetWifiPictureData(参数)

#include <GetWifiPictureData.h>
GetWifiPictureData(参数);

3.7.3 摄像头识别数据（）

功能：未知
参数：未知
返回值：未知

import rcu  # 导入rcu库
rcu.GetCamRecog(参数)

#include <GetCamRecog.h>
GetCamRecog(参数);

3.7.4 摄像头检测图像（）

功能：图像识别为人脸或二维码
参数：0/1
- 人脸：0
- 二维码：1
返回值：0/1，对应识别结果为人脸/二维码

import rcu  # 导入rcu库
rcu.GetWifiCamPictureResult(参数)

#include <GetWifiCamPictureResult.h>
GetWifiCamPictureResult(参数);

3.7.5 摄像头检测图像尺寸为（）

功能：检测图像尺寸
参数：0~2
- 大：0
- 中：1
- 小：2
返回值：0/1/2，分别对应大/中/小

import rcu  # 导入rcu库
rcu.GetWifiCamPictureSize(参数)

#include <GetWifiCamPictureSize.h>
GetWifiCamPictureSize(参数);

3.7.6 摄像头检测图像位置为（）

功能：检测图像位置
参数：0~4
- 上：0
- 下：1
- 左：2
- 右：3
- 中：4
返回值：0~4，分别对应图像位置位于上、下、左、右、中

import rcu  # 导入rcu库
rcu.GetWifiCamPictureSite(参数)

#include <GetWifiCamPictureSite.h>
GetWifiCamPictureSite(参数);

3.8 RFID

3.8.1 读RFID卡号（）

功能：读取RFID对应端口的卡号
参数：
- 1_{5，对应M6的P1}P
- 1_{8，对应E6的P1}P8
返回值：返回读取的RFID对应端口的卡号

import rcu  # 导入rcu库
rcu.GetRFID522(参数)

#include <GetRFID522.h>
GetRFID522(参数);

3.8.2 读RFID数据（）

功能：读取RFID对应端口的数据
参数：
- 1_{5，对应M6的P1}P
- 1_{8，对应E6的P1}P8
返回值：返回读取的RFID对应端口的数据

import rcu  # 导入rcu库
rcu.ReadRFID522(参数)

#include <ReadRFID522.h>
ReadRFID522(参数);

3.8.3 写RFID数据（）（）

功能：写入RFID对应端口的数据
参数1：
- 1_{5，对应M6的P1}P
- 1_{8，对应E6的P1}P8
参数2：未知

import rcu  # 导入rcu库
rcu.WriteRFID522(参数1,参数2)

#include <WriteRFID522.h>
WriteRFID522(参数1,参数2);

四. 显示

M6-RCU：2.4英寸彩色高清触摸屏（320x240）
- 默认字体（实测有误差）
  - X轴：符号 0~318，数字 0~262，中心 100
  - Y轴：符号 0~224，数字 0~236，中心 112
E6-RCU：2.4英寸彩色高清触摸屏（240x320）
- 默认字体（未测试）
  - X轴：符号 0~224，数字 0~236，中心 112
  - Y轴：符号 0~318，数字 0~262，中心 100

4.1 屏幕被触摸？

功能：判断屏幕是否被触摸
返回值：1/0，触摸时返回1，未触摸时返回0

import rcu  # 导入rcu库
rcu.GetTouchScreen()

#include <GetTouchScreen.h>
GetTouchScreen();

4.2 屏幕被触摸的X轴

功能：读取屏幕触摸点的X轴坐标值
返回值：1-240，屏幕从左往右，数值从小到大，无触摸时值为0

import rcu  # 导入rcu库
rcu.GetTouchScreenX()

#include <GetTouchScreenX.h>
GetTouchScreenX();

4.3 屏幕被触摸的Y轴

功能：读取屏幕触摸点的Y轴坐标值
返回值：1-320，屏幕从上往下，数值从小到大，无触摸时值为0

import rcu  # 导入rcu库
rcu.GetTouchScreenY()

#include <GetTouchScreenY.h>
GetTouchScreenY();

4.4 LCD清屏黄色

功能：清除显示屏全部的显示内容，背景颜色设置成黄色
参数：清屏后的背景颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetLCDClear(参数)

#include <SetLCDClear.h>
SetLCDClear(参数);

4.5 设置字体大小（）

功能：设置屏幕显示字体大小
参数：字体大小,0~4
- “默认字体”：0
- “中字体”：1
- “大字体”：2
- “特大字体”：3
- “超大字体”：4

import rcu  # 导入rcu库
rcu.SetFontSize(参数)

#include <SetFontSize.h>
SetFontSize(参数);

4.6 在屏幕第（）行显示数字（）

功能：在显示屏设定的行位置显示数字，显示方式为右对齐
参数1：1-20，行号
参数2：0- $10^30$ ，显示的数字
参数3：字体颜色，默认黄色 0xFFE0
参数4：背景颜色，默认黑色 0x0000

import rcu  # 导入rcu库
rcu.SetDisplayVar(参数1,参数2,参数3,参数4)

#include <SetDisplayVar.h>
SetDisplayVar(参数1,参数2,参数3,参数4);

4.7 在屏幕第（）行显示字符（）

功能：在显示屏设定的行位置显示字符，显示方式为左对齐
参数1：1-20，行号
参数2：字符串文本类型，不区分中英文，限制输入20个

import rcu  # 导入rcu库
rcu.SetDisplayString(参数1,"参数2",0xFFE0,0x0000)

#include <SetDisplayString.h>
SetDisplayString(参数1,"参数2",0xFFE0,0x0000);

4.8 显示图片X（）Y（）文件名（）缩放比例（）

功能：在显示屏设定的坐标位置显示图片，起始位置为图片的左上角
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：图片文件名，图片应预先存入到磁盘控制器内，格式为字符串文本类型
参数4：0-3
- 0:不缩放
- 1:缩放1/2
- 2:缩放1/4
- 3:缩放1/8
支持显示标准有损压缩JPEG图片和无损16位/24位/32位真彩BMP图片

import rcu  # 导入rcu库
rcu.SetDisplayPicture(参数1,参数2,"参数3",参数4)

#include <SetDisplayPicture.h>
SetDisplayPicture(参数1,参数2,"参数3",参数4);

4.9 在屏幕X（）Y（）显示数字（）颜色（）背景（）

功能：在显示屏设定的坐标位置显示数字，数字和背景颜色可设定
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：显示的数字
参数4：字体颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000
参数5：背景颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetDisplayVarXY(参数1,参数2,参数3,参数4,参数5)

#include <SetDisplayVarXY.h>
SetDisplayVarXY(参数1,参数2,参数3,参数4,参数5);

4.10 在屏幕X（）Y（）显示字符（）颜色（）背景（）透明（）

功能：在显示屏设定的坐标位置显示字符文本
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：显示的字符，字符串文本类型
参数4：字体颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000
参数5：背景颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000
参数6：0/1，是否透明。0为否，1为是

import rcu  # 导入rcu库
rcu.SetDisplayStringXY(参数1,参数2,参数3,参数4,参数5,参数6)

#include <SetDisplayStringXY.h>
SetDisplayStringXY(参数1,参数2,"参数3",参数4,参数5,参数6);

4.11 在屏幕第（）行显示10位正数（）颜色（）背景颜色（）

功能：在显示屏设定的坐标位置显示字符文本
参数1：0-20，行数
参数2：显示的正数，要求10位
参数3：字体颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000
参数4：背景颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetDisplayVarU32(参数1,参数2,参数3,参数4)

#include <SetDisplayVarU32.h>
SetDisplayVarU32(参数1,参数2,参数3,参数4);

4.12 在屏幕第（）行显示浮点数（）颜色（）背景颜色（）

功能：在显示屏设定的坐标位置显示字符文本
参数1：0-20，行数
参数2：显示的数字，浮点类型
参数3：字体颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000
参数4：背景颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
//python未实现
//rcu.SetDisplayFloat(参数1,参数2,参数3,参数4)

#include <SetDisplayFloat.h>
SetDisplayFloat(参数1,参数2,参数3,参数4);

4.13 绘制点X（）Y（）颜色（）

功能：在显示屏设定的坐标位置显示一个坐标点
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：点的颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetLCDDot(参数1,参数2,参数3)

#include <SetLCDDot.h>
SetLCDDot(参数1,参数2,参数3);

4.14 绘制直线X（）Y（）角度（）长度（）颜色（）

功能：从显示屏设定的坐标位置开始，朝设定的角度方向绘制一条线段
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：0-360，旋转角度
参数4：长度，一个单位长度等于一个像素点
参数5：线段颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetLCDLine(参数1,参数2,参数3,参数4,参数5)

#include <SetLCDLine.h>
SetLCDLine(参数1,参数2,参数3,参数4,参数5);

1.15 绘制圆X（）Y（）半径（）颜色（）

功能：以显示屏设定的坐标位置为圆心，绘制一个实心圆形
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：一个单位半径长度等于一个像素点
参数4：圆的颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetLCDSolidCircle(参数1,参数2,参数3,参数4)

#include <SetLCDSolidCircle.h>
SetLCDSolidCircle(参数1,参数2,参数3,参数4);

4.16 绘制矩形X（）Y（）宽（）高（）线宽（）颜色（）

功能：绘制一个空心矩形，左上角为显示屏设定的坐标位置
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：M6：1-320，宽
参数4：M6：1-240，高
参数5：一个单位线宽等于一个像素点的宽
参数6：线的颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetLCDRectangle2(参数1,参数2,参数3,参数4,参数5,参数6)

#include <SetLCDRectangle2.h>
SetLCDRectangle2(参数1,参数2,参数3,参数4,参数5,参数6);

4.17 绘制实心矩形X（）Y（）宽（）高（）线宽（）颜色（）

功能：绘制一个实心矩形，左上角为显示屏设定的坐标位置
参数1：0-239，X坐标
参数2：0-319，Y坐标
参数3：M6：1-320，宽
参数4：M6：1-240，高
参数5：一个单位线宽等于一个像素点的宽
参数6：矩形的颜色
- “红色”：0xF800
- “绿色”：0x07E0
- “蓝色”：0x001F
- “黄色”：0xFFE0
- “紫色”：0xF81F
- “青色”：0x07FF
- “白色”：0xFFFF
- “黑色”：0x0000

import rcu  # 导入rcu库
rcu.SetLCDFilledRectangle2(参数1,参数2,参数3,参数4,参数5,参数6)

#include <SetLCDFilledRectangle2.h>
SetLCDFilledRectangle2(参数1,参数2,参数3,参数4,参数5,参数6);

五. 播放

（人工智能、ZMBLOCKS鸣编程）

5.1 播放MP3文件夹名（）MP3名（）

功能：播放MP3磁盘中01文件夹内名称为01的MP3
参数1：01-99，文件夹名称
参数2：01-99，音频文件名称

SetMp3Play

import rcu  # 导入rcu库
rcu.SetMp3Play(参数1,参数2)

#include <SetMp3Play.h>
SetMp3Play(参数1,参数2);

5.2 暂停播放MP3

功能：功能：中断MP3的播放

SetMp3Suspend

import rcu  # 导入rcu库
rcu.SetMp3Suspend()

#include <SetMp3Suspend.h>
SetMp3Suspend();

5.3 播放声音（）

功能：播放内置MP3文件
参数：1~14，对应不同的声音
- 公鸡：1
- 狼：2
- 猫：3
- 马：4
- 鸭：5
- 鼓：6
- 竖琴：7
- 钟声：8
- 笑声：9
- 舒适：10
- 轻快：11
- 欢乐：12
- 街舞：13
- 舞动：14
内置MP3存放在音频磁盘中，可以直接操作文件更改和删除。但是删除后，这个编程模块就会失效。本质上这个编程模块只是播放指定文件夹中的MP3，删除后会无法播放。

SetMp3Play

import rcu  # 导入rcu库
rcu.SetMp3Play(参数)

#include <SetMp3Play.h>
SetMp3Play(参数);

六. 无线

6.1 接收RCU蓝牙数据

功能：控制器通过蓝牙接收另一个控制器发送的数据
返回值：0-255

GetBluetoothData

import rcu  # 导入rcu库
rcu.GetBluetoothData()

#include <GetBluetoothData.h>
GetBluetoothData();

6.2 RCU蓝牙发送数据（）

功能：控制器通过蓝牙向另一个控制器发送数据
参数：0-255

SetBluetoothData

import rcu  # 导入rcu库
rcu.SetBluetoothData(参数)

#include <SetBluetoothData.h>
SetBluetoothData(参数);

6.3 语音识别（）

功能：通过WIFI模块接收APP软件语音数据，与关键词比较返回识别结果。
参数：字符串文本类型

import rcu  # 导入rcu库
rcu.GetComVoice(参数)

#include <GetComVoice.h>
GetComVoice(参数);

6.4 手机键码

功能：读取手机蓝牙键码
返回值：

import rcu  # 导入rcu库
rcu.GetBluetoothControl()

#include <GetBluetoothControl.h>
GetBluetoothControl()

6.5 手机键值

功能：读取手机蓝牙键值
返回值：

import rcu  # 导入rcu库
rcu.GetBluetoothControlData()

#include <GetBluetoothControlData.h>
GetBluetoothControlData()

6.6 蓝牙手柄键码

功能：读取蓝牙手柄键码
返回值：

import rcu  # 导入rcu库
rcu.GetBTModuleRemoteCode(参数)

#include <GetBTModuleRemoteCode.h>
GetBTModuleRemoteCode(参数)

6.7 蓝牙手柄键值

功能：读取蓝牙手柄键值
返回值：

import rcu  # 导入rcu库
rcu.GetBTModuleRemoteButton()

#include <GetBTModuleRemoteButton.h>
GetBTModuleRemoteButton()

6.8 蓝牙手柄遥感值方向（）轴（）

功能：读取蓝牙手柄的左、右摇杆值
参数1：0/1
- 左：0
- 右：1
参数2：0/1
- X轴：0
- Y轴：1
返回值：布尔类型

import rcu  # 导入rcu库
rcu.GetBTModuleRemoteRocker(参数1,参数2)

#include <GetBTModuleRemoteRocker.h>
GetBTModuleRemoteRocker(参数1,参数2)

七. 控制

7.1 等待（）秒

功能：等待指定时间后，执行其后程序
参数：等待时间，单位为秒

SetWaitForTime

SetWaitForTime(参数)

#include <SetWaitForTime.h>
SetWaitForTime(参数);

7.2 重复执行（）次

功能：重复执行其包含的程序指定次数，默认值为10次
参数：循环次数，数值须为正整数

count

for count in range(参数):
    pass

for(int i = 0; i < 10; i++){
  pass;
    }

7.3 重复执行

功能：重复执行其包含的程序

while

while True:
    pass

for(;;){
  pass;
    }

7.4 如果（）那么…

功能：如果指定条件成立，就执行其包含的程序
参数：判断条件
返回值：布尔类型0/1，满足条件执行包含的程序，不满足条件跳过不执行

if 参数:
    pass

if (参数){
  pass;
    }

7.5 如果（）那么…否则…

功能：如果指定条件成立，就执行其包含的程序1，否则执行程序2
参数：判断条件
返回值：布尔类型0/1，满足条件执行程序1，否则执行程序2

if-else

if 参数:
    pass
else:
    pass

if (参数){
  pass;
    }
else{
  pass;
    }

7.6 等待（）

功能：等待指定条件成立，执行其后程序
参数：满足的条件
返回值：布尔类型0/1，满足条件才开始执行，不满足条件继续等待

wait

while not(参数):
    pass  //置为空
pass

参数;
while (!(参数));
pass;

7.7 重复执行直到（）

功能：功能：重复执行其包含的程序，直到指定条件成立，而后停止程序。
参数：满足的条件
返回值：布尔类型0/1，满足条件才开始执行，不满足条件继续重复循环

until

while not(参数):
    pass

参数;
while (!(参数)){
  pass;
}

八. 运算

8.1. 算术运算符

8.2. 赋值运算符

见 “变量”

中鸣RCU使用指南

中鸣RCU使用指南

一. 控制器

1.1 控制器任务<1-8>

1.2 按下左键？/按下右键？

1.2.1 按下左键

1.2.2 按下右键

1.3 麦克风音量

1.4 电池电压

1.5 控制器时间

1.6 控制器时间归零

1.7 蜂鸣器 开/关

1.8 设置声音频率（）Hz 时间（）s

1.9 地址（）数据值

1.10 地址（）数据值设为（）

1.11 发送串口数据（）波特率（）

1.12 接收串口数据波特率（）

二. 马达

2.1 马达（）以速度（）转动

2.2 马达()编码器数值

2.3 马达（）编码器归零

2.4 设置伺服马达（）以速度（）旋转（）

2.5 等待伺服马达（）以速度（）旋转（）

2.6 设置伺服马达(橙)（）速度（）角度（）

2.7 等待伺服马达(橙)（）速度（）角度（）

2.8 马达（）（）以速度（）编码（）前进

2.9 马达（）（）以速度（）编码（）转弯

2.10 马达功率M1（）M2（）M3（）M4（）

2.11 设置双马达走直线（）（）速度（）

2.12 设置双马达走同步转弯（）（）速度（）角度（）

2.13 小型舵机（）转动角度（）

2.14 小型舵机调速（）转动角度（）持续（）毫秒

2.15 设置单通道伺服马达控制()通道编号()角度()时间()（ms）

2.16 数字舵机（）转动角度（）持续（）毫秒

2.17 数字舵机（）转动角度（）速度（）

2.18 数字舵机（）目标编码（）速度（）

2.18 设置伺服舵机（）转动角度（）

2.19 设置伺服舵机调速（）转动角度（）持续（）毫秒

三. 传感器

3.1 触碰传感器

3.2 颜色传感器

3.3 超声波传感器

3.4 光电传感器

3.4.1 光电传感器（）数值

3.4.2 光电传感器（）数字数值

3.4.3 光电传感器（）灯（）

3.5 彩灯模块

3.6 手势识别传感器

3.7 摄像头

3.7.1 摄像头遥感值（）

3.7.2 摄像头检测结果（）

3.7.3 摄像头识别数据（）

3.7.4 摄像头检测图像（）

3.7.5 摄像头检测图像尺寸为（）

3.7.6 摄像头检测图像位置为（）

3.8 RFID

3.8.1 读RFID卡号（）

3.8.2 读RFID数据（）

3.8.3 写RFID数据（）（）

四. 显示

4.1 屏幕被触摸？

4.2 屏幕被触摸的X轴

4.3 屏幕被触摸的Y轴

4.4 LCD清屏黄色

4.5 设置字体大小（）

4.6 在屏幕第（）行显示数字（）

4.7 在屏幕第（）行显示字符（）

4.8 显示图片X（）Y（）文件名（）缩放比例（）

4.9 在屏幕X（）Y（）显示数字（）颜色（）背景（）

4.10 在屏幕X（）Y（）显示字符（）颜色（）背景（）透明（）

4.11 在屏幕第（）行显示10位正数（）颜色（）背景颜色（）

4.12 在屏幕第（）行显示浮点数（）颜色（）背景颜色（）

4.13 绘制点X（）Y（）颜色（）

4.14 绘制直线X（）Y（）角度（）长度（）颜色（）

1.15 绘制圆X（）Y（）半径（）颜色（）

4.16 绘制矩形X（）Y（）宽（）高（）线宽（）颜色（）

4.17 绘制实心矩形X（）Y（）宽（）高（）线宽（）颜色（）

五. 播放

5.1 播放MP3文件夹名（）MP3名（）

5.2 暂停播放MP3

1.7 蜂鸣器开/关