ILI9341 3.2 TFT

Using Rinky-Dink's UTFT Library:  UTFT myGLCD(ILI9341_16, 38, 39, 40, 41);

From TFT to Due:

TFT-Pin	Lable	Due
1	CS	40
2	RS	38
3	WR	39
4	RD	3.3V
5	RST	41
6	DB0	37
7	DB1	36
8	DB2	35
9	DB3	34
10	DB4	33
11	DB5	32
12	DB6	31
13	DB7	30
14	DB8	22
15	DB9	23
16	DB10	24
17	DB11	25
18	DB12	26
19	DB13	27
20	DB14	28
21	DB15	29
22	SDCS	--
23	BL	3.3V
24	VDD	3.3V
25	VDD	3.3V
26	GND	GND
27	GND	GND
28	NC	--
29	MISO	3
30	MOSI	4
31	PEN	2
32	F_CS	--
33	T_CS	5
34	CLK	6

From Due to TFT:

Due	Lable
2	PEN
3	MISO
4	MOSI
5	T_CS
6	CLK
22	DB8
23	DB9
24	DB10
25	DB11
26	DB12
27	DB13
28	DB14
29	DB15
30	DB7
31	DB6
32	DB5
33	DB4
34	DB3
35	DB2
36	DB1
37	DB0
38	RS
39	WR
40	CS
41	RST
--	SDCS
--	NC
--	F_CS
3.3V	RD
3.3V	BL
3.3V	VDD
3.3V	VDD
GND	GND
GND	GND

References: 

• Using ILI9341 TFT LCD Display Module Touch Panel For Arduino with Arduino DUE

Arduino 之間的 I2C 通訊 (7) 單片機有效傳送數據的選擇

這個章節的重點, 不在於 I2C 通訊, 但却是通訊中常見的問題.

要完成一個通訊, 最基本會有兩個主角, 發送者 及 接收者.
兩者之間, 只要有著共同的通訊協定, 就可以簡單達成通訊了.

以下的例子中, 在表達傳送數據的時候, 為了分辨一個 byte, 以及文字的數據, 將會用 [xx] 表示一個數值為 xx 的十六進數據 (有需要時, 我會加上 {...} 去顯示二進值), 例如 [31] 即數值為 0x31 的一個 byte.  而要表達一些文字時, 就會用 "..." 去表達, 例如 "A" 就是一個 A 字, 其 ACSII code 為 65, 實際送出 0x41.  所以 [41] 跟 "A" 將會是相同的東西.



通訊協定的選擇

(1) 單一字節
對於發送單一字節的訊息, 大家可能會覺得沒有什麼協定吧, 就是一個 write, 另一個  read 就完成.
其實, 當中對通訊的資料, 也有一個協定了, 就是發出的資料, 長度是一個 byte.
資料的長度, 也是協定的一種.

例: 如要送出 x=30, 就送出以下一個  byte

[1E]

(2) 簡單合成
比如我要發送 一個物體的 坐標 (x,y,z 均為 0-1023 的整數),  每個坐標可以用 2 byte 去發出.
最簡單的方法, 就是定了資料的次序, 每個數據以 H L 的次序送出 2 byte, 連續發出 6 個 byte, 那這個協定就可以看成是:

[X][X][Y][Y][Z][Z]

例:  當 x=30, y=123, y= 567 時, 就會送出

[00][1E][00][7B][02][37]

(3) 轉化合成
另一個方式, 考慮到 0-1023 的數值, 只用了 10bits, 3 個數字加起來, 也只有 30 bit.  如果認為通訊時間比較重要, 不介意多做前後期工作, 甚至可以把數據先合成 4個 bytes 再送出去.
最後餘下的 2個 byte, 還可以用作 checksum.
這個協定, 就變成是:

{xxxxxxxx}{xxyyyyyy}{yyyyzzzz}{zzzzzzcc}

例:  當 x=30, y=123, y= 567 時, 就會送出
  30 = 0x001E = 0000011110b
123 = 0x007B = 0001111011b
567 = 0x0237 = 1000110111b
cc = 00 (暫定不作任何計算)
{00000111}{10000111}{10111000}{11011100}

即 發送以下 4 個 bytes 就可以了.
[07][87][B8][DC]

(4) 在數據中插入開始/結束碼

有時, 數據的變化比較大, 比如要發送一段文字, 總不可能每次都固定為最大長度去發送吧.  當中加入結束碼, 可以更有效處理數據.   開始/結束碼的選擇, 也有一定的技巧, 一定要避開數據中會出現的所以可能性, 如果沒法避免, 就要加入特別處理方法.


例:  當 x=30, y=123, z= 567, 結束碼為 [FF] 時, 就會送出

[1E][FF][7B][FF][02][37][FF]

萬一數據中有可能出現 [FF], 就要對數據加以處理, 例如數據中每一個 [FF] 就變成 [FF][FF].
接收的時候, 就做一次還原, 每當碰上連續兩個 [FF] 就變成 [FF], 最後單獨的就是結束碼了.

例如 x=255, y=123, z=567

就會發送 [FF][FF][FF][7B][FF][02][37][FF]

最前的兩個 [FF] 合成數據 [FF}, 之後單獨的就是 結束碼, 如此下去就可以了.

(5) 固定長度文字

以上都是站在電腦的角度去溝通, 但有時為了讓用家方便看到資料, 會把數據轉成人類可以看到的形式...就是完轉化成文字送出去.  上面的例子中, 數據是0-1023, 最簡單的方法, 每個數據用 4個 字符, 前面補 零, 合共 12 個字符.

[X][X][X][X][Y][Y][Y][Y][Z][Z][Z][Z]

例:  當 x=30, y=123, z= 567 時, 就會送出

"003001230567"

即送出以下 12 個 byte:

[30][30][33][30][30][31][32][33][30][35][36][37]

(個人認為, 對 MCU 而言, 實在不值得)

(6) 在文字中加入開始/結束碼

跟 4 有點相似, 上例中 x=30 時, 前面浪費了 2 個 byte, 有些時間, 如果數據的變化比較大, 用固定長度會出現更大的浪費.  比如數值由 0-10000000, 因為要滿足所有數值, 就要預留 8 個 byte, 如果正常數據只是 100 以內, 那大部份數據都要浪費 6 個 byte 了.  所以, 有些協定, 就會加入 開始/結束 碼, 把幾個數提分開.  注意, 為免誤認 開始/結束碼, 一般會使用數據中不會出現的字符.  例如上面要傳送數字, 就絕不會用數字作開始/結束 碼了.  但當要發送二進數據時, 就要像 (4) 的對數據進行處理.

如果只用結束碼 [#] 的話, 上面的協定就變成:

[X]*[#][Y]*[#][Z]*[#]

例:  當 x=30, y=123, z= 567 時, 就會送出

"30#123#567#"

如果要發送二進的數據, 因為開始/結束 碼有機會在數據中出現, 就要進行特別處理.

例如, 當數據中出現 "#" 時, 把每一個 "#" 就變成 "##".  接收程式只會在收到 基數的連續 "#" 才會把最後一個看成是結束碼, 

例如: "12#3", 就會送出 "12##3#", 接收時, 因為第一次的 "#" 是連續兩個 "#", 就會變回數據中的一個 "#", 而最後一個是單獨的, 就是結束碼了.  

(7) 加入更多資訊

慢慢發展下去, 有些人會覺得, 這種固定次序的方式, 對程式更新有限制.
比如 將來 加減資料, 新舊程式難以共存.  對於一些公用的服務, 會有很大影響.
經過不斷改良, 就出現了像 XML 的格式, 每一個資料都加上一個名稱.  讀取資料就更準確, 不易出錯了.  將來改變參數也不會有大問題.

比如上面的例子上, 要發送一個位置 x=30, y=123, z= 567 , 可以送出以下字串:

<location><x>30</x><y>123</y><z>567</z></location>

非常清楚的表達了要發送的資料, 以及每個資料的意義, 很好吧?
但請細心想想, 對通訊而言, (2) 的簡單合成固定長度位置發出去, 好在那裡?

以 MCU 為中心去作出選擇

機械不是人類, 只要有清楚的協定, 就會明白數據的意義.

對桌面機或大型電腦而言, 丁點禿的數據處理, 沒什麼大不了.
但在 MCU 上應用, 只會是加重負擔, 可以說是畫蛇添足的門面功夫.  既浪費資源, 亦沒有好處.

以上的方法中, (3), (5), (6) 及 (7) 對 MCU 而言, 都只會做成不必要的負擔.  個人不贊成用在 MCU 的通訊上.

(3) 的方法可以省點通訊時間, 但合成數據除非本身有簡單硬件去做, 又或數據的來源就是合成的, 不需額外處理, 否則, 對一般通訊而言, 未必有大幫助.  但對程式的要求會相對提高了, 所以不贊成初學者使用.  而且, 執行上也要浪費更多資源去處理數據的合成及還原.

(5),(6),(7) 可能是比較多人會喜歡用的, 特別是 (6), 例如用 "30,123,567" 去發送資料, "看"起來不錯吧.
但這個"看"法, 只在於用人眼去"看", 對MCU而言, 一點也不好"看" 呢.

而 MCU 一般用途比較專一, 將來出現大變化的機會不會太大, (7) 的方法實在是太浪費了,  MCU 的程式, 應該要更重視資源的運用.  那些多餘的 tag header, 實在要不得.

一般而言, 個人會選擇 (2) 或 (4), 又或是混合使用.  如果數據是固定的, (2) 可以說是最快捷簡單的方式.  有時可以加入開始/ 結束碼, 去防止傳送時出現問題, 而誤認數據, 就更加安全了.

日常生活中, 網絡發送的數據包, 它的 header 也是用固定長度的數據送出的.

以下是 IP Header 的資料格式的例子:

如果你把數據拿來看, 只會是一堆難以直接理解的二進數值.
但對電腦系統而言, 要看這樣的數據, 比看文字容易得多呢.  接收端可以直接讀取 第 3,4 個byte 去獲取資料的總長度, 第 10 個 byte 去辨別類型, .....

如果轉成了文字發送, 你自己可能會容易看到資料的意思, 例如 "TotalLength:128; Protocol:TCP", 但系統要了解當中的意思, 可要花費不少資源呢.
通訊用的資料是給系統看的, 應該先考慮那個方法對系統更好, 可不要 喧賓奪主.

注意:
我並不是說 XML 不適合用作通訊, 在大型的系統上, XML 也有很大的好處的.
只是因應 MCU 的限制, 以 XML 格式進行通訊, 絕非一個好的選擇.


發送資料的方式

但發送數據, 並非只有一個個 byte 的, 不同的數據, 又如何轉成 byte[] 去發送呢?
網上經常會看到, 有人問用 串口通訊時, 如何把 浮點 的數據送出去?
很多人都會選用 文字的方式, 例如 "123.45" 送出去.
如果精確度是固定的話, 這個方法還勉強可以, 如果精確度不定, 那要轉成多少個位數才合理呢?

如果大家可以把自己是人類的前提取下, 把自己當成是一台電腦, 問題就會簡單得多了.

為什麼?  先問問自己, 你要發送的資料, 發送之前是放在那裡的?  是用什麼形式去放?

或許你會答我, 是放在 某個 變數中吧.  例如 float a = 123.45;  就是放在 a 那裡.
那 a 是什麼?  那個 123.45 是怎樣放?  放在那裡?

a 可以說是放在電腦內的記憶體的某些資料吧, 至於怎樣放置 小數, 這是大學課程中有教的吧.


未完.....待續....

Arduino 之間的 I2C 通訊 (6) 由 master 提供參數, 再由 slave 作出相應的回復

看了(5) 之後, 這個章節其實也沒大意義, 只是把 master 發出的東西加點變化吧.
重點將會是下一章節中所提及, 如何有效地把數據送出 (不論是 master 或 slave 都一樣).

為什麼說 (6) 是沒意義呢?  請大家再看看 (5) 吧:

• Arduino 之間的 I2C 通訊 (5) master 向 slave 要求不同資料

第 (5) 是 slave 可以提供不同的資料供 master 去選擇.
而 (6) 是 由 master 把需要的參數提供給 slave 應用.

如果認真去想, (5) 的範例中, 不是已經由 master 提供了一個參數嗎?
對, 就是用來選擇有關資訊的 dataMode 吧.
只不過, (5) 接收到那個 參數後, 只是用來分辨要回傳的資料, 而不是用來計算.
但實際的作用是沒分別的, 就是由 master 提供了一個數據給 slave 吧.

那為什麼又要多開一個沒意義的章節呢?

首先, 很多朋友會覺得, 參數的作用會有所不同.
其次, 在 (5) 的 選擇服務功能上, 基本上只是一個 byte 的數據, 簡單的送出去就行了.
但 參數可以超過一個 byte, 有不同的類形(int, float, char[],...), 亦可以同時有多個參數.

所以, 發送參數, 就有需要考慮到發送的方式.
流程上都是一樣, 把要發送的東西, 用 Wire.write 送出去, 而接收的, 也就是不斷用 Wire.read 去接收.

重點在於, 如何把不同類型的數據, 都用 Wire.write 發出去.

同樣的做法, 也可以應用到串口通訊的.

如果在桌面電腦上, 要作出通訊, 基本上用什麼形式也沒大問題, 因為基本上不需要考慮速度以及記憶體的問題.
就以現在比較常見的 XML 通訊為例, 小小的幾個 byte, 做一個很大的 XML 發出去, 也是很平常的事.
但在 MCU 上, 要準備及處理一個 XML, 需要浪費很大的資源, 實在是不值得的.

下一個章節, (7) 單片機有效傳送數據的選擇, 將會針對 單片機的資源限制, 尋求既有效率又簡單的通訊方法.


以下先用一個簡單的例子, 說明如何可以在 master 向 slave 提供參數.

假設有一台 slave 服務機, 可以提供 AND , OR  及 XOR 的計算.
由 master 送出 3 個 byte, 中間一個作為運算的選擇, 'A' = AND, 'O' = OR, 'X' = XOR.
如運算不在 'A', 'O' 及 'X' 之內, 就會把結果定為 0xFF.
而 slave 會回傳接收到的資料, 再加上運算結果.

比如發出 0x31 0x41 0x35 就是要計算 0x31 AND 0x35 的結果 (0x31 & 0x35 = 0x31).
Slave 就會回傳 0x31 0x41 0x35 0x31

Master 的程式:

#include <Wire.h>
 
#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 
#define DATA_SIZE 4

void setup()
{
  Wire.begin();
  
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Master.06 started");
  Serial.println();
}

byte data[4];
  
void loop()
{
  if (Serial.available()) {
     
    Wire.beginTransmission(SLAVE_ADDRESS);
    for (int i = 0; i < 3; i++) {
      data[i] = Serial.read();
      delay(1);
    }
    Wire.write(data, 3);
    Wire.endTransmission();
    while(Serial.available()) Serial.read();  // Clear the serial buffer, in this example, just request data from slave
    
    Serial.print("Data sent: ");
    for (int i = 0; i < 3; i++) {
      Serial.print(data[i], HEX);
      Serial.print(" ");
    }
    Serial.println();

    Wire.beginTransmission(SLAVE_ADDRESS);
    Wire.requestFrom(SLAVE_ADDRESS, DATA_SIZE);
    if (Wire.available()) {
      for (int i = 0; i < 4; i++) data[i] = Wire.read();
      while (Wire.available()) Serial.print((char) Wire.read());
      Serial.println();
    }
    Wire.endTransmission();

    Serial.print("Data returned: ");
    for (int i = 0; i < 4; i++) {
      Serial.print(data[i], HEX);
      Serial.print(" ");
    }
    Serial.println();

  }
}

Slave 的程式:

#include <Wire.h>

 
#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 
 
byte data[4];
boolean dataReceived = false;
boolean dataReady = false;
boolean dataReturned = false;

void setup() {
  Wire.begin(SLAVE_ADDRESS);    // join I2C bus as a slave with address 1
  Wire.onReceive(receiveEvent); // register event
  Wire.onRequest(requestEvent); // register event
  
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Slave.06 started\n");
}
 
void loop() {
  if (dataReturned) {
    dataReturned = false;
    Serial.print("Data received: ");
    for (int i = 0; i < 3; i++) {
      Serial.print(data[i], HEX);
      Serial.print(" ");
    }
    Serial.print(" => ");
    Serial.println(data[3], HEX);
  }
}
 
void receiveEvent(int count) {
  if (Wire.available()) {
    for (int i = 0; i < 3; i++) data[i] = Wire.read();
    while (Wire.available()) Wire.read();
    dataReceived = true;
    dataReturned = false;
  }
}
 
void requestEvent()
{
  char op = (char) data[1];
  Serial.print("op = ");
  Serial.println(op);
  switch (op) {
    case 'A':
      data[3] = data[0] & data[2];
      break;
    case 'O':
      data[3] = data[0] | data[2];
      break;
    case 'X':
      data[3] = data[0] ^ data[2];
      break;
    default:
      data[3] = 0xFF;
      break;
  }
  Wire.write(data, 4);
  dataReceived = false;
  dataReturned = true;
}

以上範例, 只在於說明如何發送參數給 slave 使用, 當中並沒有加入錯誤的檢測.
而且只用了簡單參數, 下一個章節將會探討給何發送不同的數據.

相關程式下載:

• master_06.ino
• slave_06.ino

Arduino 之間的 I2C 通訊 (5) master 向 slave 要求不同資料

相關指令:

指令	發出耆	作用
Wire.begin([<address>]);	master / slave	啟動 Wire (由於 i2c 是用 Wire 的, 這就等同啟動 i2c 了)
Wire.beginTransmission(<address>);	master	開始對 <address> 的連線
Wire.endTransmission();	master	關閉之前的連線
Wire.requestFrom(<address>,<len>);	master	在線上向拍定地址發出回傳 <len> bytes 資料的請求
Wire.available();	master	檢查連線上是否有可接收的資料
Wire.read();	master / slave	讀取連線上的一個 byte 的資料
Wire.write(<array>,<size>);	slave / slave	在連線上送出 <size>個 byte 的資料
Wire.onReceive(<function>)	slave	設定用來接收資料的函數
Wire.onRequest(<function>)	slave	設定函數用來回應線上的請求

這個可以說是之前的一個初步小總結了.

從 (4) 已經說明了 slave 如果把資料回傳, 但大家可能會發覺, 某些 i2c device, 是可以選擇不同的資料的, 在處理請求的函數中, 如何得知 master 想要什麼?

對, 在 request 之中, 是沒有任何有關請求的資料提供的, 就只是一個空白的請求.

但就像 MPU6050 之類的模塊, 不是可以選擇不同的數據嗎?
如果大家有用過 I2CDev 的庫, 或許會發覺 readByte 的函數, 不是有一個 regAddr, 向 slave 要求不同的數據嗎?

    static int8_t readByte(uint8_t devAddr, uint8_t regAddr, uint8_t *data, uint16_t timeout=I2Cdev::readTimeout);

大家有看過之前 (1) - (4) 的話, 難道想不出來嗎?  多思考一下, 把所知道的結合起來.

對了, 說穿了就只是把兩個工序結合起來.

• master 先向 slave 發送所需資料的指令
• slave 收到後, 先記下來, 不作處理
• master 再向 slave 發出傳送資料的請求
• slave 收到請求後, 先看看 master 剛發過來有關所需資料的指令, 再把相關資料回傳

是否很簡單呢?

master 向 slave 選擇所需資料

明白了原理, 步驟也很簡單, 就是把 (2) + (4) 結合:

1. 執行 beginTransmission 並指定接收指令的地址
2. 以 Wire.write 把所需資料的指令發送出去
3. 執行 endTransmission 完成指令發送
4. 執行 beginTransmission 並指定連線地址
5. 以 Wire.requestFrom 發出請求
6. 不斷以 Wire.available 檢查是否有資源, 並以 Wire.read 把一個 byute 資料提出
7. 執行 endTransmission 作結束

當中 3. 4. 是否有必要, 我也不肯定.  但為了把 發送 / 接收 可獨立一點, 先把發送完結或者會好一點.  而且, 3. 4. 之後, 有需要或許要加入一點 delay, 好讓 slave 處理資料.  當然, 看實際情況決定, 並不是必須的.

以下是簡單的例子, master 發出請求時, 會先指定所需資料.

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 
#define DATA_SIZE 8
 
void setup()
{
  Wire.begin();
 
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Master.05 started");
  Serial.println();
}
 
 
void loop()
{
  if (Serial.available()) {
    
    Wire.beginTransmission(SLAVE_ADDRESS);
    Wire.write(Serial.read());
    delay(1);
    Wire.endTransmission();

    Wire.beginTransmission(SLAVE_ADDRESS);
    Wire.requestFrom(SLAVE_ADDRESS, DATA_SIZE);
    if (Wire.available()) {
      Serial.print("Data returned: ");
      while (Wire.available()) Serial.print((char) Wire.read());
      Serial.println();
    }
    Wire.endTransmission();
    while(Serial.available()) Serial.read();  // Clear the serial buffer, in this example, just request data from slave

  }
}

salve 向 master 回傳所需資料

跟 master 一樣, 所需步驟, 同樣是把 (3) + (4) 結合起來就可以了.

• 執行 Wire.onReceive 去設定接收資料的函數
• 執行 Wire.onRequest 去設定處理請求的函數
• 在 onRecevie 函數中, 以 Wire.available 檢查是否有資料需要處理.  
• 要有複雜的程序, 先記下來, 留待主程式去做
• 在主程序中檢查是否有 接收資料待處理
• 在 onRequest 函數中, 跟據之前 onReceive 收到的指令, 以 Wire.write 把 所需資料回傳

但這裡有一點要留意, 之前沒提及的.  就是當 master 發出 requestFrom 時, slave 是會觸發一次 onReceive 而當中是沒有資料的.  所以在 onReceive 當中, 必須要先檢查 Wire.available.

以下是一個簡單例子, master 可以選擇 2 種資料, 而回傳結果如下:

0 - 回傳 "Super169"
1 - 回傳 "Apple II"
其他 - 回傳 "WhoAmI"

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 

uint8_t dataMode = '0';
boolean modeChanged = false;

void setup() {
  Wire.begin(SLAVE_ADDRESS);    // join I2C bus as a slave with address 1
  Wire.onReceive(receiveEvent); // register event
  Wire.onRequest(requestEvent); // register event
 
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Slave.05 started\n");
}

void loop() {
  if (modeChanged) {
    Serial.print("Change data mode to ");
    Serial.println((char) dataMode);
    modeChanged = false;
  }
}

void receiveEvent(int count) {
  if (Wire.available()) {
    dataMode = Wire.read();
    modeChanged = true;
    while (Wire.available()) Wire.read();
  }
}

void requestEvent()
{
  switch (dataMode) {
    case '0':
      Wire.write("Super169",8);
      break;
    case '1':
      Wire.write("Apple II",8);
      break;
    default:
      Wire.write("Who am I",8);
  }
}

額外測試項目

大家記得之前 (2) 時提及, 不要把 Serial.print 放在 receiveEvent 當中嗎?
在之前的例子, 由於只要 receiveEvent 在工作, 不會有任何影響.
但在今次的例子中, 大家看到為了把 data mode 的改變顯示出來, Serial.print 的部份放到主程式內.
有興趣的朋友可以試試把它修改一下, 放回 receiveEvent 內, 看看會有什麼結果.


相關程式下載:

• master_05.ino
• slave_05.ino

Arduino 之間的 I2C 通訊 (4) 由 master 向 slave 要求資料回傳

相關指令:

指令	發出耆	作用
Wire.begin([<address>]);	master / slave	啟動 Wire (由於 i2c 是用 Wire 的, 這就等同啟動 i2c 了)
Wire.beginTransmission(<address>);	master	開始對 <address> 的連線
Wire.endTransmission();	master	關閉之前的連線
Wire.requestFrom(<address>,<len>);	master	在線上向拍定地址發出回傳 <len> bytes 資料的請求
Wire.available();	master	檢查連線上是否有可接收的資料
Wire.read();	master	讀取連線上的一個 byte 的資料
Wire.onRequest(<function>)	slave	設定函數用來回應線上的請求
Wire.write(<array>,<size>);	slave	在連線上送出 <size>個 byte 的資料

之前已經試過由 master 向 slave 發送資料, 但對於一些像 傳感器的設備, 反而是需要由 slave 把資料回傳的.  有些傳感器可能需要一段時間去讀取資料 (例如 PM2.5 收集 30 秒數據), 如果在主控中執行, 可能會影響其他工序.  如果加一片 arduino 板子, 以 slave 形式去讀取資料, 當 master 發出請求時, 就可以直接把最後的結果回傳, master 就不用花太多時間了.  再者, 把程序分開後, 每個程序可獨立除錯, 而主程式亦變得簡單了.  就如 PM2.5 的例子, 把當中讀取及計算的部份後 master 中抽走, 就不用考慮因為要讀取連續數據而影響其他程序的問題了.

由於 slave 是不能主動發動連線, 所以只可以等待 master 的請求, 然後把資料送出去.

slave 回應請求

像之前接收資料一樣, slave 會設定一個 函數去回應 master 的請求的.

• 執行 Wire.onRequest 去設定處理請求的函數
• 在該函數中, 以 Wire.write 把 資料回傳

以下是一個簡單例子, 當接到請求後, 就回傳一句 "Super169"

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 

#define I2C_BUFFER_SIZE 32  
uint8_t i2cBuffer[I2C_BUFFER_SIZE];
uint8_t i2cBufferCnt = 0;

void setup() {
  Wire.begin(SLAVE_ADDRESS);    // join I2C bus as a slave with address 1
  Wire.onRequest(requestEvent); // register event
 
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Slave.04 started\n");
}

void loop() {
}

void requestEvent()
{
  Wire.write("Super169",8);
}

master 發出請求 並 接收資料


在 master 中發出請求及接收資料, 也只是幾個簡單步驟就可以了:

1. 執行 beginTransmission 並指定地址
2. 以 Wire.requestFrom 向指定地址發出請求, 並指定回傳資料的數目
3. 不斷以 Wire.available 檢查是否有資源, 並以 Wire.read 把一個 byute 資料提出
4. 執行 endTransmission 作結束

這裡大家可能會對 requestForm 有點疑問:

1. 為什麼 requestForm 要提供地址?

在 beginTransmission 中, 已指定了連線的地址, 其他地址是不能使用的, 為何還要指定地址?
這個本人亦有疑問, 但在網上找不到確實的答案.  以下是本人的推測, 有錯的希望大家指出.
首先, requestForm 是不需要放在 beginTransmission 之後的, 是可以獨立執行的, 所以必須要有地址.
但為什麼又要放入 beginTransmission 之後呢?  可能是為了確保 slave 在回傳資料時, 可以合法使用連線.  

2. 為什麼 requestForm 要提供回傳資料的大小

在之前的通訊中, 大家也看到, slave 發送完畢, 是不需要執行任何指令的.  對於 Wire 而言, 是沒有明確的訊息得知 slave 已發送完畢.  所以只好在發出請求時, 設定回傳資料的數目.  在正常情況下, 一般有特別的通訊協定, 發出請求的一方, 都會知道回傳資料的數目, 所以不會有問題的.  如果真的是沒有限定的話, 例如通訊協定中, 以回傳的第一個 byte 回報資料長度.  這樣只好用盡 Wire 的 buffer 把資料都接回來, 之後再進行分析處理.

以下就是一個前 slave 發出請求回傳資料的例子:

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 
#define DATA_SIZE 8

void setup()
{
  Wire.begin();
 
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Master.04 started");
  Serial.println();
}
 
 
void loop()
{
  if (Serial.available()) {

    Wire.requestFrom(SLAVE_ADDRESS, DATA_SIZE);
    Wire.beginTransmission(SLAVE_ADDRESS);
    if (Wire.available()) {
      Serial.print("Data returned: ");
      while (Wire.available()) Serial.print((char) Wire.read());
      Serial.println();
    }
    Wire.endTransmission();
    while(Serial.available()) Serial.read();  // Clear the serial buffer, in this example, just request data from slave
  }

}

執行後, 在 master 一方的 serial monitor 不論輸入什麼, 都會向 slave 發出回傳資料的請求.  而 slave 回傳的字句, 會在 serial monitor 中顯示出來.


相關程式下載:

• master_04.ino
• slave_04.ino

Arduino 之間的 I2C 通訊 (3) 由 master 向 slave 發送資料/發出指令 [slave 延遲處理]

相關指令:

指令	發出耆	作用
Wire.begin([<address>]);	master / slave	啟動 Wire (由於 i2c 是用 Wire 的, 這就等同啟動 i2c 了)
Wire.beginTransmission(<address>);	master	開始對 <address> 的連線
Wire.endTransmission();	master	關閉之前的連線
Wire.write(<data>);	master	在連線上送出 一個 byte 的資料
Wire.onReceive(<function>)	slave	設定用來接收資料的函數
Wire.available();	slave	檢查連線上是否有可接收的資料
Wire.read();	slave	讀取連線上的一個 byte 的資料

slave 延遲處理

之前的一篇, 不是已經可以由 master 向 slave 發送資料, 而 slave 亦成功收到了, 為什麼又攪個 延遲處理出來?

之前一篇, 處理 master 送來的資料, 都是在接收的函數之內.  但大家不要忘記, arduino 的主線, 是在 loop 之內執行的.  接收函數太大, 或會影響主程式進行, 而且, 有些時候, 主程式或許需要用到接收回來的資料.

延後處理就是把資料放進緩存一樣, 讓主程式去處理.
方法很簡單, 可以直接把資料放有有關變數, 又或用最通用的方式, 先放入一個 buffer 中.

以下例子, 就是用最通用的方式處理,

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 

#define I2C_BUFFER_SIZE 32  
uint8_t i2cBuffer[I2C_BUFFER_SIZE];
uint8_t i2cBufferCnt = 0;
boolean dataPending = false;

void setup() {
  Wire.begin(SLAVE_ADDRESS);    // join I2C bus as a slave with address 1
  Wire.onReceive(receiveEvent); // register event

  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Slave.03 started\n");
}

void loop() {
  if (dataPending) {
    Serial.println("Receive Data:");
    for (int idx = 0; idx < i2cBufferCnt; idx++) Serial.print((char) i2cBuffer[idx]);
    Serial.println("\n");   
    dataPending = false;
  }
}

void receiveEvent(int count) {
  i2cBufferCnt = 0;
  while(Wire.available()) {
    i2cBuffer[i2cBufferCnt++] = Wire.read();
  }
  dataPending = true;
}

執行後, 跟之前的是沒分別的.
當然, 你也可以嘗試把 i2c 的 buffer 加大或收細, 看看有什麼影響.


相關程式下載 (master_03 跟 master_02 是一樣的)

• master_03.ino
• slave_03.ino

Arduino 之間的 I2C 通訊 (2) 由 master 向 slave 發送資料/發出指令 [slave 直接處理]

相關指令:

指令	發出耆	作用
Wire.begin([<address>]);	master / slave	啟動 Wire (由於 i2c 是用 Wire 的, 這就等同啟動 i2c 了)
Wire.beginTransmission(<address>);	master	開始對 <address> 的連線
Wire.endTransmission();	master	關閉之前的連線
Wire.write(<data>);	master	在連線上送出 一個 byte 的資料
Wire.onReceive(<function>)	slave	設定用來接收資料的函數
Wire.available();	slave	檢查連線上是否有可接收的資料
Wire.read();	slave	讀取連線上的一個 byte 的資料

通訊也有不同程度的, 先做一個最簡單的單向通訊.
由於只有 master 可以主動發出通訊要求, 最簡單的就是由 master 向 slave 發送資料了.
這個例子是針對一些操控裝置, 例如你做了一個 i2C 的舵機, 由 arduino 發出指令, 要它轉到指定的角度, 而舵機是不會回傳任何資料的

程式同樣分開 mater 及 slave 的部份, master 發送, slave 接收.

master 發送資料

在 master 發送資料, 只有幾個簡單步驟就可以了:

1. 執行 beginTransmission 並指定接收資料地址
2. 以 Wire.write 把資料送出去
3. 執行 endTransmission 作結束

以下是一個簡單的例子, master 把 串口收到的資料, 發送給 slave.

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 

 
void setup()
{
  Wire.begin();
 
  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Master.02 started");
  Serial.println();
}
 
 
void loop()
{
  if (Serial.available()) {
    Wire.beginTransmission(SLAVE_ADDRESS);
    while(Serial.available()) {
      Wire.write(Serial.read());
      delay(1);
    }
    Wire.endTransmission();
  }
}

slave 接收資料

而 slave 接收, 是有點像 interrupt driven 的形式去做,  簡單的做法如下.

1. 執行 Wire.onReceive 去設定接收資料的函數
2. 在接收資料的函數中, 不斷以 Wire.available 檢查是否有資源, 並以 Wire.read 把一個 byute 資料提出, 直到所有資料提出後, Wire.available 為 false

注意, 因為 Wire 庫的 buffer 只有 32 個 byte, 每次發送的資料應限制在 32 個 byte 之內.
由於 master 進行 write 是沒有限制的, 如果發送超過 32 bytes, 之後的資料就會流失.

以下例子, 是在 接收的函數中, 直接處理接收回來的資料.

#include <Wire.h>

#define SLAVE_ADDRESS 0x12
#define SERIAL_BAUD 57600 

 
void setup() {
  Wire.begin(SLAVE_ADDRESS);    // join I2C bus as a slave with address 1
  Wire.onReceive(receiveEvent); // register event

  Serial.begin(SERIAL_BAUD);
  Serial.println("I2C Slave.02 started\n");
}

void loop() {
}

void receiveEvent(int count) {
  Serial.println("Receive Data:");
  while(Wire.available()) {
    Serial.print((char) Wire.read());
  }
  Serial.println("\n");
}

注意:  
這個例子中在 receiveEvent 中用到 Serial.print, 只是為了簡單展示結果, 雖然這裡沒有問題, 但其實是絕不應該的.
在正常的程式中, 應該盡量避免在 receiveEvent 中放入複雜的程序, 在下一章中會提及正確的做法.


執行程式後, 在 master 板子連線的 serial monitor 輸入資料, 就會發送到 slave 板子, 再在相關的 serial monitor 顯示出來.

相關程式下載:

• master_02.ino
• slave_02.ino