Thư viện truyền dữ liệu bất kỳ (byte ,long, float , double ... ) theo gói tin cho arduino

Giả sử bạn có 2 arduino đang kết nối với nhau bằng 1 giao tiếp nào đó (I2C, SPI, UART, IR ..) , có thể là không dây hay có dây.  Bạn có 1 biến dữ liệu trong arduino A và muốn nó sẽ nằm trong arduino B bằng cách gửi qua giao tiếp đó.

Trong thiết bị điện tử logic chỉ có 2 mức tín hiệu là High (1) và Low (0) tương ứng với 2 mức điện áp. Khi xuất ra đường truyền, dữ liệu cũng sẽ chỉ là các Byte chứa các Bit nhị phân 0-1 như thế này

Vậy làm sao để thiết bị nhận (arduino B) tìm ra chính xác dữ liệu mong muốn  ?

Cách tốt nhất để giải quyết vấn đề này là đặt ra những quy ước chung cho dữ liệu muốn gửi.

Máy thu sẽ dựa vào những dấu hiệu đó để nhận biết và tách lấy thứ nó cần.

Ví dụ:  Chúng ta có 1 byte dữ liệu A với giá trị bằng 11. Phía trước của A sẽ là 1 byte Start (B10101010) , Phía sau của A là 1 byte Stop (B10011010), Như vậy A có thể sẽ bằng B00000101.

Ta nói “có thể sẽ bằng” là vì A có thể là 1 giá trị nhiễu (không giống với dữ liệu gửi), hoặc khi A trùng với Start sẽ khiến máy thu không thể phân biệt…

Như vậy, để xác suất nhận đúng A tăng lên thì ta phải nâng cao quy ước như :

•   Giá trị của A chỉ nằm trong khoảng 0 => 20.
•   Tăng độ dài của Start và Stop..vv

Cũng giống như khi bạn mua hàng online, để hàng có thể đến tận tay thì bạn cần điền đầy đủ thông tin của người nhận, mỗi một thông tin điền vào sẽ giúp cho cửa hàng loại trừ và thu hẹp khu vực của bạn.

Quy ước càng chắc chắn thì dữ liệu càng đáng tin cậy!

Toàn bộ ví dụ sử dụng giao tiếp UART để test.

Nối dây arduino RX của arduino này nối với TX của arduino kia..

Khai báo và sử dụng các hàm

Hàm dựng gói dữ liệu của class DATA_TRANSMIT_PACKET:

DATA_TRANSMIT_PACKET(String name_);

Tạo 1 gói dữ liệu để định tên  (NamePK ) cho gói .

Hàm dựng ( constructor ) của class TRANSMIT_CLASS :

TRANSMIT_CLASS  ( uint8_t (*rb)(),   uint32_t (*av)() , void (*cl)() ,void (*wb)(uint8_t));

• Truyền vào 4 hàm với 4 nhiệm vụ :
• Rb: hàm đọc 1 byte dữ liệu  
• Av: hàm đọc kích thước sẵn có của dữ liệu
• Cl:hàm xóa toàn bộ dữ liệu sẵn có
• Wb: hàm ghi 1 byte dữ liệu ra đường truyền.

Bạn có thể sửa lại các hàm này trong tùy chọn thành viên :

• void ADD_READ_BYTE( uint8_t (*fc)() ;
• void ADD_AVAILABLE( uint32_t (*fc)() ;
• void ADD_CLEAR( void (*fc)() ;
• void ADD_WRITE_BYTE( void(*fc)(uint8_t) ;

 RESET_LABEL_NAME(   uint8_t n0, uint8_t n1,uint8_t n2,uint8_t n3,uint8_t n4,uint8_t n5);

• Khi cần thiết, bạn có thể sửa lại giá trị của LABEL_NAME  bằng hàm trên.

uint8_t LISTEN_LABEL(uint32_t timeout,  DATA_TRANSMIT_PACKET **array_ );

• Dùng để lắng nghe gói tin (bước 1) .
• Timeout: thời gian đợi lâu nhất (milli giây)
• array_ : mảng chứa gói tin tổng hợp

template <class Type>  uint8_t GET_DATA(uint32_t time_out,DATA_TRANSMIT_PACKET x ,Type c, uint16_t Count, ... );

• Lấy dữ liệu nhận được và ghi đè vào từng BIẾN.
• Timout: thời gian đợi lâu nhất (milli giây)
• X: gói tin nhận biết .
• Type c: Kiểu dữ liệu của biến sẽ phân giải.
• Count: số lượng biến sẽ phân giải.
• … : liệt kê biến cần ghi đè vào đây.

template <class Type>  uint8_t GET_DATA_ARRAY(uint32_t time_out,DATA_TRANSMIT_PACKET x ,Type c, uint16_t Count, Type *array_ );

• Lấy dữ liệu biến và ghi đè vào mảng chứa biến dữ liệu.
• Timeout: thời gian đợi lau nhất (mili s)
• X: gói tin nhận biết
• Type c: Kiểu dữ liệu của biến sẽ phân giải
• Count: số lượng biến sẽ phân giải (bằng với kích thước mảng)
• Array_: lưu dữ liệu vào mảng này

uint8_t GET_BINARY_ARRAY(uint32_t time_out,DATA_TRANSMIT_PACKET x , uint16_t SIZE_ARRAY, uint8_t *array_ , uint16_t *number_get);

• Lấy dữ liệu nhị phân và ghi đè vào mảng (từng byte 1).
• Timeout: thời gian đợi lau nhất (mili s)
• X: gói tin nhận biết
• SIZE_ARRAY : kích thước lớn nhất của mảng lưu trữ.
• uint8_t *array_ : mảng (kiểu dữ liệu bắt buộc)
• *number_get: hàm trả về kích thước Payload nhận được (số byte)

template <class Type>   uint8_t SEND_DATA( DATA_TRANSMIT_PACKET x , Type c, uint16_t Count , ...);

• Gửi dữ liệu theo từng biến riêng rẽ
• X:  gói tin lựa chọn
• Type c: kiểu dữ liệu của biến
• Count; số lượng biến
• …: liệt kê biến cần gửi vào đây

template <class Type>uint8_t SEND_DATA_ARRAY( DATA_TRANSMIT_PACKET x , Type c, uint16_t Count, Type *array_);

• Gửi 1 mảng dữ liệu
• X: gói tin lựa chọn
• C: kiểu dữ liệu của mảng
• Count: số lượng phần tử sẽ gửi
• Array_: mảng chứa dữ liệu gửi.

• Các ví dụ của Thư viện sử dụng cổng UART trên arduino để test truyền nhận. Do đó khi bạn sử dụng Serial để làm chung vào việc khác (thường là Serial.print() gì đó để bugcode ) sẽ gây chồng chéo dữ liệu.
• Kiểu float và double trên từng dòng vi điều khiển (8bit / 32bit..) sẽ có cỡ lưu trữ khác nhau.
• Kiểu float hiện không được sử dụng để khai báo trong SEND_DATA() và  GET_DATA(); nhưng có thể sử dụng bình thường trong SEND_DATA_ARRAY() và GET_DATA_ARRAY();
• Như đã nói ở phần đầu , Thư viện không dùng bộ nhớ đệm để lưu trữ dữ liệu PayLoad nhận được,  dữ liệu nhận đến đâu sẽ ghi đè vào mảng hoặc biến đến đó ngay cả khi gói tin đó bị lỗi.
• Tuy nhiên cả 2 hàm đều có  khả năng trả về lỗi mà nó phát hiện, ta sẽ dựa vào đó đế quyết định xem có nên dùng dữ liệu đó hay không. Cách tốt nhất là chỉ xem những biến bị ghi đè như những biến đệm, khi nhận đúng thì mới truyền vào biến thực sự sử dụng.
• Bạn hoàn toàn có thể mở rộng thêm cổng giao tiếp (xem trong ví dụ ) hoặc thay đổi sang kiểu giao tiếp khác (UART, SPI, I2C, IR , sóng RF , ...) bằng việc thay đổi lại 4 hàm khi truyền vào hàm dựng.
• Trong khoảng thời gian Timeout ,máy thu sẽ đợi và ghép các gói tin (ngay cả khi có trễ trên đường truyền ) giúp kích thước nhận gửi có thể lên đến 65535 byte cho 1 gói tin.
• Độ dài tên gói tin (lớn nhất 255 kí tự ) càng lớn sẽ giúp gói có độ tin cậy cao hơn, tuy nhiên nó lại khiến băng thông tốn nhiều hơn, hãy cân nhắc.