显示页面修订记录反向链接回到顶部 本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。 ====== Weeemake Arduino Libaries API Reference ====== ===== RGB超声波传感器API ===== <html> <body lang=EN-US style='text-justify-trim:punctuation'> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>class</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeUltrasonicSensor</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:超声波传感器类名定义</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>其可直接调用的成员函数如下:</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(1)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> <span style='color:#0080FF'>WeUltrasonicSensor</span><span style='color:black'>(</span><span style='color:#8000FF'>uint8_t</span></span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:构造函数,在定义超声波类时可定义接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0 style='border-collapse:collapse;border:none'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 valign=top style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>示例:</span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeUltrasonicSensor ultrasonic_sensor(PORT_A);</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>备注:在定义类时,可以不直接传入</span><span style='font-size:14.0pt'>port</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>的值</span><span style='font-size:14.0pt'>(</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>初值为</span><span style='font-size:14.0pt'>0)</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>,可之后设置:</span></p> <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:16.0pt; font-family:"Courier New";color:#0080FF'>WeUltrasonicSensor ultrasonic_sensor;</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>之后调用:</span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>ultrasonic_sensor.reset(PORT_A);</span></b></p> <p class=MsoNormal><span style='font-size:16.0pt'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(2)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'> void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>reset</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:可重新设置接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0 style='border-collapse:collapse;border:none'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 valign=top style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(3)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> <span style='color:#8000FF'>double</span></span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>distanceCm</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:获取超声波测距数据</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:双精度浮点数,范围</span><span style='font-size:14.0pt'>3~500</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>,单位:厘米</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(4)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> <span style='color:#8000FF'>void</span></span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>setColor</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>index</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>,</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>red</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>,</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>green</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>,</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>blue</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:设置超声波内置</span><span style='font-size:14.0pt'>RGB</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>灯的显示颜色并显示</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0 style='border-collapse:collapse;border:none'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal align=center style='text-align:center'><b><span style='font-size:16.0pt;font-family:等线;color:#0080FF'>index</span></b></p> </td> <td width=449 valign=top style='width:336.8pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=left style='text-align:left'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>选择</span><span style='font-size:14.0pt;color:windowtext'>RGB</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>灯,范围</span><span style='font-size:14.0pt;color:windowtext'>1~3</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>,</span><span style='font-size:14.0pt;color:windowtext'>1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为左,</span><span style='font-size:14.0pt;color:windowtext'>2</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为右,</span><span style='font-size:14.0pt;color:windowtext'>3</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为全部</span></p> </td> </tr> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;border-top:none; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=center style='text-align:center'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>red</span></b></p> </td> <td width=449 valign=top style='width:336.8pt;border-top:none;border-left: none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=left style='text-align:left'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>红色分量设置(</span><span style='font-size:14.0pt;color:windowtext'>0~255</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>)</span></p> </td> </tr> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;border-top:none; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=center style='text-align:center'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>green</span></b></p> </td> <td width=449 valign=top style='width:336.8pt;border-top:none;border-left: none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=left style='text-align:left'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>绿色分量设置(</span><span style='font-size:14.0pt;color:windowtext'>0~255</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>)</span></p> </td> </tr> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;border-top:none; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=center style='text-align:center'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>blue</span></b></p> </td> <td width=449 valign=top style='width:336.8pt;border-top:none;border-left: none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=left style='text-align:left'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>蓝色分量设置(</span><span style='font-size:14.0pt;color:windowtext'>0~255</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>)</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(5)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> <span style='color:#8000FF'>void</span></span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>setLed</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>index</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>,</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>bool</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>isOn</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>);</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:驱动</span><span style='font-size:14.0pt;background:yellow'>Mini RGB</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;background:yellow'>超声波传感器</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>板载上两颗黄色</span><span style='font-size:14.0pt'>LED</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>灯</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0 style='border-collapse:collapse;border:none'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal align=center style='text-align:center'><b><span style='font-size:16.0pt;font-family:等线;color:#0080FF'>index</span></b></p> </td> <td width=449 valign=top style='width:336.8pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=left style='text-align:left'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>选择</span><span style='font-size:14.0pt;color:windowtext'>LED</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>灯,范围</span><span style='font-size:14.0pt;color:windowtext'>1~3</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>,</span><span style='font-size:14.0pt;color:windowtext'>1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为左,</span><span style='font-size:14.0pt;color:windowtext'>2</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为右,</span><span style='font-size:14.0pt;color:windowtext'>3</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为全部</span></p> </td> </tr> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;border-top:none; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=center style='text-align:center'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>isOn</span></b></p> </td> <td width=449 valign=top style='width:336.8pt;border-top:none;border-left: none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt; padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal align=left style='text-align:left'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>设置</span><span style='font-size:14.0pt;color:windowtext'>LED</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>灯的状态,</span><span style='font-size:14.0pt;color:windowtext'>0</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为灭,</span><span style='font-size:14.0pt;color:windowtext'>1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>为亮</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>编程示例:</span></p> </body></html> <sxh c/c++; first-line: 1;highlight: [50,100]; title: ultrasonic_test.ino> #include "WeELF328P.h" WeUltrasonicSensor ultraSensor(PORT_B); void setup() { Serial.begin(9600); } void loop() { ultraSensor.setColor(1,0,20,0); //(Red,Green,Blue) ultraSensor.setColor(2,20,0,0); //(Red,Green,Blue) Serial.print("Distance : "); Serial.print(ultraSensor.distanceCm() ); Serial.println(" cm"); delay(100); } </sxh> \\ ===== 巡线传感器API ===== ==== 1. 双路巡线传感器API ==== <html><body> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>class</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeLineFollower</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:双路巡线传感器类名定义</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>其可直接调用的成员函数如下:</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(1)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeLineFollower</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:构造函数,在定义超声波类时可定义接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 valign=top style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>示例:</span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeLineFollower</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'> linefollower_sensor(PORT_A);</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>备注:在定义类时,可以不直接传入</span><span style='font-size:14.0pt'>port</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>的值</span><span style='font-size:14.0pt'>(</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>初值为</span><span style='font-size:14.0pt'>0)</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>,可之后设置:</span></p> <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:16.0pt; font-family:"Courier New";color:#0080FF'>WeLineFollower</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'> linefollower_sensor;</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>之后调用:</span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>linefollower_sensor.reset(PORT_A);</span></b></p> <p class=MsoNormal><span style='font-size:16.0pt'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(2)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'> void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>reset</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:可重新设置接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 valign=top style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(3)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint16_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>startRead</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>index</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:获取巡线探头测量数据</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>index</span></b></p> </td> <td width=330 valign=top style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择探头,</span><span style='font-size:14.0pt;font-family:等线; color:windowtext'>1<span lang=ZH-CN>为</span>S1<span lang=ZH-CN>,</span>2<span lang=ZH-CN>为</span>S2</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:整数,范围</span><span style='font-size:14.0pt'>0~1023</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>编程示例:</span></p> </body></html> <sxh c/c++; first-line: 1;highlight: [50,100]; title: linfollower_test.ino> #include "WeELF328P.h" WeLineFollower lineFollower(PORT_A); void setup() { Serial.begin(9600); } void loop() { uint16_t s1,s2; s1=lineFollower.startRead(1); s2=lineFollower.startRead(2); Serial.print("S1="); Serial.println(s1); Serial.print("S2="); Serial.println(s2); delay(100); } </sxh> \\ ==== 2. 单路巡线传感器API ==== <html><body> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>class</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeSingleLineFollower</span></b></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(1)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeSingLineFollower</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:构造函数,在定义超声波类时可定义接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse;mso-yfti-tbllook:1184;mso-padding-alt:0in 0in 0in 0in'> <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; height:25.6pt'> <td valign=top style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=924 valign=top style='width:692.9pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,只能选择模拟口,</span><span style='font-size:14.0pt; font-family:等线;color:windowtext'>ELF<span lang=ZH-CN>主控板的</span></span><span style='font-size:14.0pt;color:windowtext'>PORT_1~PORT_6</span><span lang=ZH-CN style='font-size:14.0pt;font-family:宋体;color:windowtext'>,</span><span style='font-size:14.0pt;color:windowtext'>ELF MINI</span><span lang=ZH-CN style='font-size:14.0pt;font-family:宋体;color:windowtext'>主控板的</span><span style='font-size:14.0pt;color:windowtext'>PORT_A~PORT_D</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(2)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint16_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>read</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:获取巡线探头测量数据</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:整数,范围</span><span style='font-size:14.0pt'>0~1023</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>编程示例:</span></span></p> </body></html> <sxh c/c++; first-line: 1;highlight: [50,100]; title: slf_test.ino> #include<WeELF328P.h> WeSingleLineFollower slf_sensor(PORT_3); void setup() { Serial.begin(9600); } void loop() { uint16_t value = slf_sensor.read(); Serial.println(value); delay(100) } </sxh> \\ ===== LED表情面板模块API ===== ===== MP3模块API ===== <html><body> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>class</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeMP3</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:</span><span style='font-size:14.0pt;font-family:等线'>MP3<span lang=ZH-CN>模块类名定义</span></span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>其可直接调用的成员函数如下:</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(1)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> <span style='color:#0080FF'>WeMP3</span><span style='color:black'>(</span><span style='color:#8000FF'>uint8_t</span></span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:构造函数,在定义</span><span style='font-size:14.0pt;font-family:等线'>MP3<span lang=ZH-CN>类时可定义接口</span></span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=center style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 valign=center style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>示例:</span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>WeMP3</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'> mp3(PORT_A);</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>备注:在定义类时,可以不直接传入</span><span style='font-size:14.0pt'>port</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>的值</span><span style='font-size:14.0pt'>(</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>初值为</span><span style='font-size:14.0pt'>0)</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>,可之后设置:</span></p> <p class=MsoNormal style='margin-left:.5in'><b><span style='font-size:16.0pt; font-family:"Courier New";color:#0080FF'>WeMP3</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'> mp3;</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>之后调用:</span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>mp3.reset(PORT_A);</span></b></p> <p class=MsoNormal> </p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(2)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'> void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>reset</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:可重新设置接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=center style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 valign=center style='width:247.4pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span style='font-size:10.0pt;font-family:等线'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(3)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>appointDevice</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>devtype</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>);</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:设置曲目播放来源,内置</span><span style='font-size:14.0pt;font-family:等线'>FLASH<span lang=ZH-CN>或</span>TF<span lang=ZH-CN>卡</span></span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=center style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>devtype</span></b></p> </td> <td width=399 valign=center style='width:299.6pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择播放文件来源,</span><span style='font-size:14.0pt;font-family: 等线;color:windowtext'>2<span lang=ZH-CN>为</span>TF<span lang=ZH-CN>卡,</span>4<span lang=ZH-CN>为内置</span>FLASH</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal> </p> <p class=MsoNormal><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(4)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>appointVolume</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>volume</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:设置播放音量</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=center style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>volume</span></b></p> </td> <td width=298 valign=center style='width:223.7pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>音量值,范围(</span><span style='font-size:14.0pt;font-family: 等线;color:windowtext'>0~30<span lang=ZH-CN>)</span></span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'> </p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(5)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>appointMusic</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint16_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>num</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:指定播放第几首</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse'> <tr style='height:25.6pt'> <td valign=center style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>num</span></b></p> </td> <td width=298 valign=center style='width:223.7pt;border:solid windowtext 1.0pt; border-left:none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择第几首,范围(</span><span style='font-size:14.0pt;font-family: 等线;color:windowtext'>0~3000<span lang=ZH-CN>)</span></span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'> </p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(6)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>play</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:播放</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'> </span></b></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(7)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>pause</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:暂停播放</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(8)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>prevMusic</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:上一首</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span style='font-size:10.0pt;font-family:等线'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(9)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>nextMusic</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:下一首</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal> </p> <p class=MsoNormal align=left style='text-align:left;background:white'><span style='font-size:16.0pt'> </span><b><span style='font-size:12.0pt; font-family:"News Gothic MT",sans-serif'>(10)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>isOver</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>(</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'>void</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:判断当前曲目是否播放完毕</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:</span><span style='font-size:14.0pt;font-family:等线'>1<span lang=ZH-CN>表示播放完毕,</span>0<span lang=ZH-CN>表示未播放完</span></span></p> </body></html> <sxh c/c++; first-line: 1;highlight: [50,100]; title: mp3_test.ino> #include "WeELF328P.h" WeMP3 mp3(PORT_A); void setup() { mp3.appointVolume(20); //Volume 0~23 mp3.appointDevice(4); //2-TF; 4-FLASH mp3.appointMusic(1); //0~3000 } void loop() { if(mp3.isOver()==1) { mp3.nextMusic(); } } </sxh> \\ ===== 电子指南针传感器API ===== <html><body> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:16.0pt;font-family:"Courier New";mso-fareast-font-family:"Times New Roman"; color:#8000FF'>class</span></b><span style='font-size:10.0pt;font-family:"Courier New"; mso-fareast-font-family:"Times New Roman";color:black'> </span><span class=SpellE><b><span style='font-size:16.0pt;font-family:"Courier New"; mso-fareast-font-family:"Times New Roman";color:#0080FF'>WeCompassSensor</span></b></span><span style='font-size:12.0pt;font-family:"Times New Roman",serif;mso-fareast-font-family: "Times New Roman"'><o:p></o:p></span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:电子罗盘传感器类名定义</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>其可直接调用的成员函数如下:</span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(1)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><span class=SpellE><span class=GramE><b><span style='font-size:16.0pt;font-family: "Courier New";mso-fareast-font-family:"Times New Roman";color:#0080FF'>WeCompassSensor</span></b></span></span><span class=GramE><b><span style='font-size:16.0pt;font-family:"Courier New"; color:black'>(</span></b></span><b><span style='font-size:16.0pt;font-family: "Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt; font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt; font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:构造函数,在定义电子罗盘传感器类时可定义接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse;mso-yfti-tbllook:1184;mso-padding-alt:0in 0in 0in 0in'> <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; height:25.6pt'> <td style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 style='width:247.4pt;border:solid windowtext 1.0pt;border-left: none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>示例:</span><span class=SpellE><b><span style='font-size:16.0pt;font-family:"Courier New"; mso-fareast-font-family:"Times New Roman";color:#0080FF'>WeCompassSensor</span></b></span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'> <span class=GramE>compass(</span>PORT_A);</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>备注:在定义类时,可以不直接传入</span><span style='font-size:14.0pt'>port</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>的值</span><span style='font-size:14.0pt'>(</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>初值为</span><span style='font-size:14.0pt'>0)</span><span lang=ZH-CN style='font-size:14.0pt; font-family:等线'>,可之后设置:</span></p> <p class=MsoNormal style='margin-left:.5in'><span class=SpellE><b><span style='font-size:16.0pt;font-family:"Courier New";mso-fareast-font-family:"Times New Roman"; color:#0080FF'>WeCompassSensor</span></b></span><b><span style='font-size:16.0pt; font-family:"Courier New";color:#0080FF'> compass;</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>之后调用:</span><span class=SpellE><span class=GramE><b><span style='font-size:16.0pt;font-family: "Courier New";color:#0080FF'>compass.reset</span></b></span></span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>(PORT_B);</span></b></p> <p class=MsoNormal> </p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(2)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:#8000FF'> void</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><span class=GramE><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>reset</span></b><b><span style='font-size:16.0pt;font-family: "Courier New";color:black'>(</span></b></span><b><span style='font-size:16.0pt; font-family:"Courier New";color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family:"Courier New";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";color:#0080FF'>port</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>=</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:red'>0</span></b><b><span style='font-size:16.0pt;font-family:"Courier New";color:black'>)</span></b></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:可重新设置接口</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse;mso-yfti-tbllook:1184;mso-padding-alt:0in 0in 0in 0in'> <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; height:25.6pt'> <td style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; color:#0080FF'>port</span></b></p> </td> <td width=330 style='width:247.4pt;border:solid windowtext 1.0pt;border-left: none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择端口,如</span><span style='font-size:14.0pt;color:windowtext'>PORT_A,PORT_1</span><span lang=ZH-CN style='font-size:14.0pt;font-family:等线;color:windowtext'>等</span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:无</span></p> <p class=MsoNormal><span style='font-size:10.0pt;font-family:等线'> </span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><b><span style='font-size:12.0pt;font-family:"News Gothic MT",sans-serif'>(3)</span></b><b><span style='font-size:16.0pt;font-family:"Courier New"'> </span></b><b><span style='font-size:16.0pt;font-family:"Courier New";mso-fareast-font-family:"Times New Roman"; color:#8000FF'>uint16_t</span></b><span style='font-size:10.0pt;font-family: "Courier New";mso-fareast-font-family:"Times New Roman";color:black'> </span><span class=SpellE><span class=GramE><b><span style='font-size:16.0pt;font-family: "Courier New";mso-fareast-font-family:"Times New Roman";color:#0080FF'>readValue</span></b></span></span><span class=GramE><b><span style='font-size:16.0pt;font-family:"Courier New"; mso-fareast-font-family:"Times New Roman";color:black'>(</span></b></span><b><span style='font-size:16.0pt;font-family:"Courier New";mso-fareast-font-family:"Times New Roman"; color:#8000FF'>uint8_t</span></b><span style='font-size:10.0pt;font-family: "Courier New";mso-fareast-font-family:"Times New Roman";color:black'> </span><b><span style='font-size:16.0pt;font-family:"Courier New";mso-fareast-font-family:"Times New Roman"; color:#0080FF'>index</span></b><b><span style='font-size:16.0pt;font-family: "Courier New";mso-fareast-font-family:"Times New Roman";color:black'>)</span></b><span style='font-size:12.0pt;font-family:"Times New Roman",serif;mso-fareast-font-family: "Times New Roman"'><o:p></o:p></span></p> <p class=MsoNormal align=left style='text-align:left;background:white'><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>描述:获取定向数据</span></p> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>参数:</span></p> <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 style='border-collapse:collapse;mso-yfti-tbllook:1184;mso-padding-alt:0in 0in 0in 0in'> <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; height:25.6pt'> <td style='border:solid windowtext 1.0pt;padding:0in 5.4pt 0in 5.4pt; height:25.6pt'> <p class=MsoNormal><b><span style='font-size:16.0pt;font-family:"Courier New"; mso-fareast-font-family:"Times New Roman";color:#0080FF'>index</span></b></p> </td> <td width=593 style='width:444.8pt;border:solid windowtext 1.0pt;border-left: none;padding:0in 5.4pt 0in 5.4pt;height:25.6pt'> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线; color:windowtext'>选择获取某一方向轴上的定向角度,</span><span style='font-size:14.0pt; font-family:等线;color:windowtext'>0<span lang=ZH-CN>为</span>X<span lang=ZH-CN>轴,</span>1<span lang=ZH-CN>为</span>Y<span lang=ZH-CN>轴,</span>2<span lang=ZH-CN>为</span>Z<span lang=ZH-CN>轴</span></span></p> </td> </tr> </table> <p class=MsoNormal><span lang=ZH-CN style='font-size:14.0pt;font-family:等线'>返回值:整数,</span><span style='font-size:14.0pt;font-family:等线'>0~360</span></p> <p class=MsoNormal> <span lang=ZH-CN style='font-size:14.0pt;font-family: 等线'>编程示例:</span> </p> </body></html> <sxh c/c++; first-line: 1;highlight: [50,100]; title: compass_test.ino> #include "WeELF328P.h" WeCompassSensor compass(PORT_A); void setup() { Serial.begin(115200); } void loop() { int16_t head_X; compass.update(); head_X = compass.readValue(0); Serial.print("Compass:"); Serial.println(head_X); delay(200); } </sxh> \\