不知道大家有没有听说的Scratch： http://scratch.mit.edu/    是由麻省理工开发的一个软件，帮助孩子们从零开始学习编程。图形化的程序设计，萌萌哒的界面，想必能够吸引住众多孩子。不过这么好的软件貌似在国内知名度不高。
* i% c1 l2 F& u5 D
    后来，一个团队开发了一个名为S4A（Scartch for Arduino）的软件：http://s4a.cat/   将Scartch与Arduino连接起来。结合了Scartch的编程优点，外加Arduino的众多传感器，一时间孩子们也能够玩转舵机，开关，以及模拟量的传感器了。S4A使用了Arduino的6路AD采集接口，3路PWM接口和3路舵机接口，方便小孩子连接传感器，实现自己的设计。

    后来，我觉得S4A这个玩意挺好玩的，看了一下桌子上的Nucleo，决定来移植一下。经过大约3天的紧张工作，终于成功完成了移植。期间出了一个小小的问题耗费了大约一天的时间。也就是Nucleo和S4A通讯的时候，S4A总是崩溃，一直未响应。不知道是什么原因，期间一直在改动自己的代码。一天无果。第二天无意间换了FT232作为串口通讯的工具。竟然奇迹般的好了。事后发现，只要是Nucleo的串口，不出几分钟，S4A必然崩溃。不知道是Nucleo串口的原因还是S4A的原因。
; Z3 }, D% E- x
( T" P/ O  s9 E+ @( {% f    在移植完之后，我简单的用S4A写了一个呼吸灯的程序，突然发现，用C很容易实现的东西，让我来拖拽的时候竟然不知道如何去做了。。。
下面是程序截图：

1 L+ S3 {9 ]0 h5 P+ k4 W最后，给大家上传一小段视频看一下（由于社区限制，只能将视频分成两个压缩包上传），感兴趣点个赞，不感兴趣路过好了。


5 W9 R! R( F& W---------------------------------------------------------------------------------------------------------------------------------------------------------------------
Nucleo334的软件包以上传到社区。欢迎大家下载试用。
4 v8 ~, |& H. @+ @/ G发帖的时候占用了3层楼。对这几层的规划：
; [& Q! ~2 c" O! z

• 简单的介绍一下S4A软件如何使用。带领大家拖拽一个小程序。
• 全面介绍一下如何将S4A在Arduino上的软件移植到STM的Nucleo板上。
• 暂时还没想好能干点什么。
  : K1 }# ~7 J8 t$ f" B( B- }

2 d" \' w9 A4 K5 V3 u) P
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
    软件包已经上传，名为S4Nu.rar（Scartch for Nucleo）欢迎大家提前下载使用。另外需要特别注意的是：虽然Nucleo自带了串口，但是在与S4A连接的时候不要使用这个串口。也不要使用USB连线将Nucleo与电脑相连。
9 m1 O6 w0 t  {4 G$ M4 a2 J    应该对Nucleo使用外部供电。并使用USB转串口工具，例如CP2102，FT232等连接电脑与Nucleo的串口。具体是什么原因暂时还未知。可能在接下来的几天内能够解决这个问题，也可能解决不掉。下面就要说说如何设置Nucleo的硬件部分：

• 将Nucleo复位按键（板子上面的那个黑色开关）下面的短路帽由U5V改成E5V。这样能切换到外部电源供电。
  - W* m4 K+ b! H# k1 J2 S" }
• 将Nucleo背面的焊桥SB62和SB63短接。这样可以使PA2和PA3引脚连到Arduino接口的D0（Rx）和D1（Tx）。如果你懒得焊接，也可以使用CN3排针（STLINK）部分。CN3标记的RX接的是Nucleo的TX，而CN3的TX接的是Nucleo的RX。
  
• 使用外部电源给Nucleo供电。外部电源5V接到Morpho左边排针的E5V，将外部电源GND接到Nucleo的GND。
• 将你使用的串口工具的TX接D0或者CN3的TX，串口工具的RX接D1或者CN3的RX，串口工具的GND接Nucleo的GND，并将串口工具连接到电脑。
• 打开S4A软件，S4A会自动搜索电脑上的串口，判断包格式。如果包正确，那么可以顺利连接。
• 顺利连接之后可以看到S4A软件上显示的6路AD量和两路数字量输入。
  
  

• 2015.6.9   更新2楼，介绍S4A如何使用。
• 2015.6.10 更新3楼，介绍S4A Arduino源代码。
  8 B# i5 p/ ?5 ~& `3 M
  

7 @( X2 d5 B% w+ x6 Z    因通讯的问题，给老外的技术支持发了一封邮件，几天后，收到了一个回复，大概意思说是他们的S4A只是为Arduino Uno和Duemienova定做的，并且在今后的升级中，会考虑兼容更多的板子。本以为这件事就这样算了。

6 s( H+ a- T( D7 m8 W    没想到，另一个人，猜测大概是S4A的开发人员，给回复了一封邮件。意思是他正在考虑让S4A在LPC的ARM处理器上工作。让我发送一下我的代码，说不定他可以检查到什么错误。好消息，给你吧。
; ~2 h. t, s4 Z: |5 O) T) X" K/ I0 J, c
9 F  @% d+ w; A) ?4 s$ R- W    在发送完STM32的代码之后，静等了几天，昨晚收到了邮件回复：也没看出是什么软件的问题，大概是USB转串口的问题吧。

. I. U! L* K8 K" \+ h
; c2 U4 A8 @6 R% g+ J& Z5 d
( Z2 t! F- O  G9 q& e( q

Scartch的简单编程
% v9 h9 {) |$ O2 e, b4 w0 G. [

    如果你代码下载完毕，串口连接完成，打开S4A之后，就可以看到6路AD模拟量和两个开关的数字量的值了。图中的COMx是你实际使用的串口。在我的电脑上，这个COM3是使用FT232转换出来的。还要注意图片中的旗帜的标志和那个红色的大圆点。旗帜代表运行我们使用S4A拖拽的程序，圆点代表停止。
" a: M, k  Q, ?
5 t3 t0 f2 `" T9 \
. U( C7 K6 J) U5 U* `, \    在S4A的左上角可以看到动作，控制，外观，等等控件。里面有各种各样的工具供我们使用。
$ m. T- m4 L) Q( p. k0 ^4 z: A

• 动作一栏含有数字引脚的输出，舵机控制，pwm输出等。是对硬件的实际控制。
• 控制一栏中是常见的循环，if else分支语句，延时等函数。
• 数字和逻辑运算里面含有常用的大于小于判断，加减乘除等语法。
• 变量一栏中可以设置一个自己的变量，用于存储AD的采集值，pwm的输出值等等。更奇葩的是，还有链表这个东西。一直搞不清楚对小孩子而言，链表可以干什么。
  

    脚本这个位置就是我们写程序的地方。只要将程序按照逻辑结构放在这里就可以。一定要注意的是，开始的语句是一个“当旗帜被点击”的语句。这条语句类似于C语言中的main函数，程序开始执行的地方。下面就来简单的写一个闪灯的程序。
( ]6 ?2 i, Q& Y5 M% b0 r" N- E

0 U+ }4 }: n0 G6 N, ^
, k/ j7 F( y3 P0 D4 I/ i9 k: @    这就是我们平时在单片机中常写的Hello world程序。是不是很简单呢？如果想修改延时的时间怎么办？双击“等待1秒”中的1，然后填上你想要的时间并按回车。这个时间是小数的形式。可以是0.1 。

( n1 X4 h, I( Z( W0 |    我们平时在写程序的时候，经常会设置一个变量，用于存储延时的时间。在S4A中，变量的设置也是支持的。在变量一栏中点击“新建一个变量”，之后填上变量的名字，就出现很多关于这个变量操作的控件。比如设置变量的值，将变量增加一个数值等等。可是，为什么没有减小变量的数值呢？其实只要将“将变量delayTime的值增加[]”中的空格处填写一个负数就可以了。比如-10 。可是小孩子如果不知道负数怎么办呢？


. S/ Y9 P+ \  v. d! n" H6 }    在程序写完之后，点击右上角圆点旁边的旗帜图标就可以运行了。
' u: @9 F/ i& _; j  T# ^$ U
! c. y1 Y. R0 M: T3 p7 ~   不知道你家孩子会不会喜欢上！

$ e5 V# ^% Y1 s$ n


9 E" F: |% t- n: a
3 \, Y' |9 g' D, I3 [
, @  k% q) L' s2 h, K, C

; P/ J& Y* O' f9 X6 J2 @  U3 [, ]

S4A Arduino源代码解析
- C2 V  r4 A1 H

准备工具：

• S4A，可以在http://s4a.cat/ 下载。
  1 F$ f& O0 ~/ @( n1 \

• Arduino IDE（如果没有，可以使用文本编辑工具代替。比如Notepad++或者记事本）。
• S4A串口通讯协议。在附件中提供下载。
• S4A Arduino通讯源代码。在附件中提供下载。
  

---

Arduino的函数

1. int main( void )
   6 c) l5 U- s1 ^4 z
2. {
   
3.         setup();
   " G/ ^5 E2 `' \6 o9 }
4.         for (;;){
   
5.                 loop();
   
6.         }
   
7.         return 0;
   & [8 Z6 d4 F! V: b2 l" b1 Y
8. }

复制代码

setup()和loop()是我们需要自己填充的。setup只会被调用一次，完成代码的一些初始化工作。loop是需要一直循环执行的。
6 {6 [- m: P5 T
Arduino控制IO引脚的几个函数在arduino.h（SAM系列的在wiring_digital.h）中。
, |7 e- G" H9 b' r) o+ L: R

• pinMode用于设置引脚的工作方式，可以是INPUT，OUTPUT。
• digitalWrite是设置引脚的电平值。类似于STM32库文件中的GPIO_WriteBit。
• digitalRead是读取引脚的电平值。类似于STM32库文件中的GPIO_ReadInputDataBit。
• analogRead读取模拟引脚的电压值。因为Arduino是10位AD，所以这个函数的返回值在0-1023之间。
• analogWrite并不是一个DA输出，而是pwm输出。在Arduino SAM中被改为了pwmWrite。
  

1. void pinMode(uint8_t, uint8_t);
   5 q4 w/ |! x, U* f+ \) p
2. void digitalWrite(uint8_t, uint8_t);
   # d& e- f- S1 A) K) A
3. int digitalRead(uint8_t);
     k, P8 z) E. w0 e( H; ?# _9 t% W
4. int analogRead(uint8_t);
   5 t& m8 O) `9 b  W
5. void analogWrite(uint8_t, int);

复制代码

---

S4A的数据结构
! O; J3 X# Z) w" c

1. typedef enum {
   * f! v6 ]. ?! ~( e
2.   input, servomotor, pwm, digital }
   
3. pinType;
   
4. 
   
5. typedef struct pin {
   ) H3 \) ]' s8 z) t/ _
6.   pinType type;       //Type of pin
   8 Z4 F0 h/ b2 g: C. D1 S" w
7.   int state;         //State of an output
   
8.   //byte value;       //Value of an input. Not used by now. TODO
   ! \/ r) M7 @0 g! P/ G3 |- f/ N
9. };   
   ' T' A, g6 }; M1 m0 H# p$ Y) O* ]

复制代码

上面的代码在Arduino中确实能够编译。但是在C语言中确不能。不知道是不是C++中typedef的一个新特性，还是一个bug。我在移植的时候直接修改了这段：
7 r) m! h5 N5 [1 S9 \

1. typedef struct pin {
   , c4 \% Q' |% b1 H  l
2.   pinType type;       //Type of pin
   
3.   int state;         //State of an output
   . ~  r! N9 Y# D, U6 a
4.   //byte value;       //Value of an input. Not used by now. TODO
   
5. } pin ;
   

复制代码

struct pin是一个结构体，里面存储了引脚的信息，包括引脚的type和引脚的state。type是引脚的模式，可以是input，servomotors，pwm或者digital。state是引脚的值，有效取值从0到1023 。
! T! U8 e; ~3 F& d7 a5 tS4A规定：

• 如果一个引脚是input（用于输入）或者digital（用于输出），那么state取值只能0或者1023 。0表示低电平，1023表示高电平。
• 如果一个引脚是servomotor（舵机接口）或者pwm，state的取值只能从0到255 。表示占空比。0表示占空比为0%，255表示占空比为100% 。
  

S4A的Arduino源代码中定义了一个14个元素的数组，用来表示D0~D13的引脚的信息和状态：
0 F" L4 r* ]  k4 V$ H! M5 ]% W

1. pin arduinoPins[14]; //Array of struct holding 0-13 pins information

复制代码

S4A对每一个引脚的功能都加以区分：
[原文]
Components have to be connected in a particular way. S4A allows for 6 analog inputs (analog pins), 2 digital inputs (digital pins 2 and 3), 3 analog outputs (digital pins 5, 6 and 9), 3 digital outputs (pins 10, 11 and 13) and 4 special outputs to connect Parallax continuous rotation servomotors (digital pins 4, 7, 8 and 12).

• A0-A5，6路模拟量输入。引脚信息没有存放在arduinoPins数组中。
• D0，D1是通讯串口的RX和TX。保留给串口使用。
• D2，D3是两路数字开关量。可以用来接按键。pinType为input。
• D4，D7，D8是舵机接口。pinType为servomotors。这三个舵机接口是通过延时函数来实现的。即使Nucleo板上发现这3个接口不是pwm接口也无所谓。
• D5，D6，D9是pwm接口。pinType为pwm。使用逻辑分析仪测试，这三个pwm接口的周期都为2ms，频率为500Hz。
• D10，D11，D12，D13是数字输出接口。pinType为digital。可以驱动led灯等设备。
  / j* d8 X6 g/ C) s9 c

6 E* `# B) b5 ^* N2 p9 S& ]

---

  j1 h% J, U2 V; t- P+ Z7 kS4A的通信协议
根据S4A的通信协议（在附件中），每隔一段时间(20ms,在下文中会说明为什么是20ms），Arduino（或者Nucleo）应该依次将A0~A5的模拟量，D2，D3的电平值依次上传。共8组(一组数据由两个字节组成）数据。每一组数据都有相应的格式：

	7	6	5	4	3	2 ; v, S9 z, E( I' F5 e; |  l# }6 |	1	0
Byte1	1	N	N	N	N	R	R	R
Byte2	0	R	R	R	R	R	R	R

• 每一个字节的最高位是一个标志位。Byte1的最高位必须为1，Byte2的最高位必须是0.这样就可以判断包是否正确。因为Byte1一定是大于127的，Byte2一定是小于127的。
• N表示数据编号。Arduino上传至S4A：A0~A5模拟量的编号是0~5，D2编号是6，D3编号为7.
• N表示数据编号。S4A下传至Arduino：D4~D13的编号为4~13 。
• R表示需要上传的数据。由10位组成，可以表示0-1023的最大值。这也就是为什么STM32可以达到12位AD采集，却要设置成10位的原因了。
  

举个例子：比如某一上传时刻，采集到了A0~A5的电压制为1023，D2为高电平，D3位低电平，那么应该上传：
B1_0000_111 B0_1111111 //A0,1023
) C* g/ B/ V4 J( G) u4 L' I# |B1_0001_111 B0_1111111 //A1,1023
B1_0010_111 B0_1111111 //A2,1023
0 P  j1 M. v2 _1 t& k. H3 V: yB1_0011_111 B0_1111111 //A3,1023
B1_0100_111 B0_1111111 //A4,1023
B1_0101_111 B0_1111111 //A5,1023
B1_0110_111 B0_1111111 //D2,HIGH
9 J8 i2 I# o/ k9 z: QB1_0111_000 B0_0000000 //D3,LOW
$ W' |+ |% T9 K$ C! P* E
Arduino采集AD接口的信息的时候，一个AD接口采集了5次，取五次结果的中间值作为最后上传的结果：

1. for (byte p = 0; p < 5; p++)
   
2.         readings[p] = analogRead(sensorIndex);
     C+ H, M  }2 K1 e
3.     insertionSort(readings, 5); //sort readings
   $ T; }) S( T( {. }# s# f
4.     sensorValues[sensorIndex] = readings[2]; //select median reading

复制代码

insertionSort是插入排序，将5次结果排序，那么五次结果中的第二个一定是中间值。
: U# i5 v1 T' o3 v1 G2 W/ A

索引 / M/ y1 t/ a2 M* d* ^9 t	0	1	2 8 L, @% i/ l4 |) {9 b2 W	3	4
原始数据	1023	1018	1020	1019	1021

& b& A3 o3 Y7 A' b5 B* u

索引	0	1	2	3	4
排序之后	1018	1019	1020	1021	1023

在源代码中，将数据打包上传的代码：（Serial.write发送8位无符号整数）

1. void ScratchBoardSensorReport(byte sensor, int value) //PicoBoard protocol, 2 bytes per sensor
   
2. {
   + A7 r3 ~2 g; _, Y% h
3.   Serial.write( B10000000
   
4.     | ((sensor & B1111)<<3)
   
5.     | ((value>>7) & B111));
   
6.   Serial.write( value & B1111111);
   
7. }

复制代码

而每隔大约75ms，S4A会将D4~D13的值传给Arduino。因为这个时间很短，为了保证数据的接受完整，在实际移植的时候，应该建立RingBuffer缓冲区，采用中断接收的方式。
/ E  }$ s- R. G
* [& I+ e) J# L! J% ?/ b[原文]Protocol                        
$ n3 [6 ~0 B, i3 T8 x2 N: PS4A interacts with Arduino by sending the actuator states and receiving sensor states every 75 ms, therefore the pulse width needs to be greater than this time period. The data exchange follows the PicoBoard protocol and needs a specific program (firmware) to be installed in the board. Please refer to the Downloads section for further instructions on how to do so.

当Arduino接收到S4A传来的数据之后，会对数据解码，获取N编号和R的值：

1. pin = ((actuatorHighByte >> 3) & 0x0F);
   
2. newVal = ((actuatorHighByte & 0x07) << 7) | (actuatorLowByte & 0x7F);

复制代码

如果R值需要更新：
+ E# Y7 F# a% N; n$ G' T7 Z

1. if(arduinoPins[pin].state != newVal)
   
2. {
   
3.     arduinoPins[pin].state = newVal;
   $ X1 p' k0 z2 g
4.     updateActuator(pin);
   7 ~5 N5 W  D: @
5. }

复制代码

而查阅updateActuator的代码，发现并没有更新舵机的代码（具体什么原因，会和上文提到的20ms一起解释）。

1. void updateActuator(byte pinNumber)
   
2. {
   3 I' v- s1 F& L* m: n9 r/ [
3.   if (arduinoPins[pinNumber].type==digital) digitalWrite(pinNumber, arduinoPins[pinNumber].state);
   
4.   else if (arduinoPins[pinNumber].type==pwm) analogWrite(pinNumber, arduinoPins[pinNumber].state);
   
5. }

复制代码

---

20ms？
loop函数是整个调用过程：

1. void loop()
   + p% B: v& l+ l# C) `! @
2. {
   6 ^- I* z0 Y: G
3.   static unsigned long timerCheckUpdate = millis();
   
4. 
   6 g* G$ M8 ^/ p/ W7 i
5.   if (millis()-timerCheckUpdate>=20)
   ( C: r' `# e/ @9 R, }$ F
6.   {
   
7.     sendUpdateServomotors();
   ( O# v" ?% I- I$ u, O
8.     sendSensorValues();
   
9.     timerCheckUpdate=millis();
   % q' G1 V" B. y$ U
10.   }
    
11. 
    
12.   readSerialPort();
      B" Z- N8 y  }
13. }

复制代码

由于C和C++的原因，上述代码在C中并不能成功编译。因此我修改为：

1. void loop()
   ! b  P! S& _, F" {) g
2. {
   ; m! e8 W& w3 l$ \0 e6 Q
3.   static unsigned long timerCheckUpdate = 0;
   8 K2 U* L7 M2 O3 {' ~
4.   //...
   
5. }

复制代码

   millis()是Arduino中用于获取自CPU启动以来经历的ms数。将timerCheckUpdate改为0，只不过第一次执行的时候if中的语句也能够执行罢了。在这20ms中，更新了舵机的数值，上传了A0~A5，D2，D3的状态。在最后更新了timerCheckUpdate时间戳，保证下一次执行是在20ms之后。如果这时候串口的接受缓冲区中存在数据，读出来，并解析。
    先科普一下舵机的知识：舵机的转动角度是0~180度，转动角度的大小是由pwm的占空比决定的。pwm的周期必须为20ms。pwm波形中高电平的时间大约在500us~2500us之间。500us代表0度，2500us代表180度。

1. void sendUpdateServomotors()
   
2. {
   
3.   for (byte p = 0; p < 10; p++)
   $ s! N* `/ L7 ?) ?1 A* l
4.     if (arduinoPins[p].type == servomotor) servo(p, arduinoPins[p].state);
   0 x" R5 j. \" T; s8 t& I
5. }
   
6. 
   
7. void servo (byte pinNumber, byte angle)
   + I7 Q1 u: D5 Y' q& O3 [- n# e
8. {
   
9.   if (angle != 255)
   
10.     pulse(pinNumber, (angle * 10) + 600);
      N6 E+ f# g2 Q3 e6 n1 a7 o
11. }
    - M# y2 a& b' [3 \* M3 h
12. 
    
13. void pulse (byte pinNumber, unsigned int pulseWidth)
    
14. {
    
15.   digitalWrite(pinNumber, HIGH);
    
16.   delayMicroseconds(pulseWidth);
    
17.   digitalWrite(pinNumber, LOW);
    
18. }

复制代码

servo这个函数将S4A发送来的舵机的转动角度（0~180）转换成为实际的高电平时间。然后通过延时来产生一定时间的高电平。为了保证舵机能够正常运转。在移植的时候必须提供一个精度较高的delayMicroseconds函数。


! x  ?4 `5 t$ i& C+ _8 G0 J

! i- b, @+ b- H+ s  I4 H/ V/ }S4A的Arduino函数解析就这么多，希望大家都能够移植到自己的单片机中。
! x/ q" ]4 a+ G% SHave Fun！
- K- C) \) H7 m% N
( ?' K! y- A  ^0 p

占楼。。。

牛逼，Arduino上的图形化编程都让你搞过来

Paderboy 发表于 2015-6-8 20:16
牛逼，Arduino上的图形化编程都让你搞过来

3 k3 B% ~" a1 r4 w看到了通讯协议。之后的就很简单了。

Paderboy 发表于 2015-6-8 20:16
牛逼，Arduino上的图形化编程都让你搞过来

不过视频录的不怎么样

楼主大神啊，跟不上

风子 发表于 2015-6-8 20:29
! j2 T: n2 S2 a9 X) o0 u3 I楼主大神啊，跟不上

) G4 c. x1 o( v: ^都是从小白开始的。现在会的也不多。。。只是觉得好玩

哇。这东西好玩啊

好强啊，希望有详细的教程 啊

是不是要有Arduino才能玩啊

强啊，还不如个孩子，

谢谢分享。。。

good！