Bài đăng kỹ thuật
Triển khai và phân tích hệ thống
STM32F103C8T6 làm Modbus RTU master đọc nhiệt độ, độ ẩm từ cảm biến XY-MD02 qua module RS485-TTL01 (9600 8N1, hàm 0x04, kiểm tra CRC16), hiển thị trên màn hình TFT 2.8 inch ST7789 SPI. Mô hình thật, có code mẫu, khung truyền và hướng dẫn đấu nối.
Dự án dùng STM32F103C8T6 đọc nhiệt độ và độ ẩm từ cảm biến công nghiệp XY-MD02 qua chuẩn RS485 – Modbus RTU, rồi hiển thị trực tiếp lên màn hình TFT 2.8 inch ST7789 giao tiếp SPI. Đây là bài toán nền tảng của mọi hệ giám sát công nghiệp: vi điều khiển làm Modbus master, hỏi dữ liệu từ thiết bị trường qua đường truyền xa, chống nhiễu.
1. Video demo
Xem video trên TikTok TechVis Automation: STM32 đọc cảm biến XY-MD02 Modbus RTU, hiển thị TFT 2.8 inch (69 giây). Trong video, khi đặt tay lên cảm biến, độ ẩm trên màn hình tăng dần, cho thấy dữ liệu được đọc liên tục.

2. Mục tiêu
- Cấu hình UART của STM32 làm Modbus RTU master qua module RS485-TTL.
- Gửi yêu cầu đọc thanh ghi, kiểm tra CRC16 và địa chỉ của phản hồi.
- Đổi giá trị thô (×10) ra °C và %RH, xử lý nhiệt độ âm.
- Hiển thị giao diện trên TFT ST7789: tiêu đề, nhiệt độ, độ ẩm, thanh mức; báo lỗi khi mất kết nối.
3. Phần cứng

| Thiết bị | Thông số chính | Vai trò |
|---|---|---|
| STM32F103C8T6 Blue Pill | 72 MHz, 3 UART, 2 SPI | Modbus master, điều khiển màn hình |
| Module RS485-TTL01 | Chuyển TTL ↔ RS485, tự động chuyển chiều | Giao tiếp bus RS485 |
| Cảm biến XY-MD02 | Nhiệt độ + độ ẩm, Modbus RTU, nguồn 5–30 VDC | Thiết bị trường (slave) |
| TFT 2.8 inch ST7789 | SPI, 240×320, màu | Hiển thị |
| Nguồn | 5 V cho STM32/TFT, 5–24 V cho cảm biến | Chung GND |
Bảng chân gợi ý
| Chân STM32 | Kết nối | Ghi chú |
|---|---|---|
| PA2 (USART2_TX) | TXD / DI của RS485-TTL | 9600 baud, 8N1 |
| PA3 (USART2_RX) | RXD / RO của RS485-TTL | |
| PA5 / PA7 | SCL(SCK) / SDA(MOSI) của TFT | SPI1 Transmit Only |
| PA4, PB0, PB1 | CS, DC, RES của TFT | GPIO output |
| A+ / B− | A+ / B− của XY-MD02 | Dây xoắn đôi; ngược A/B sẽ không nhận được dữ liệu |
4. Giao thức Modbus RTU với XY-MD02
XY-MD02 mặc định địa chỉ 1, 9600 baud, 8 bit dữ liệu, không parity, 1 stop bit. Nhiệt độ ở thanh ghi input 0x0001, độ ẩm ở 0x0002, đọc bằng mã hàm 0x04; giá trị là số nguyên đã nhân 10 (nhiệt độ có dấu). Hãy kiểm tra lại tài liệu đi kèm cảm biến vì một số lô dùng địa chỉ/baud khác và có thể đổi qua thanh ghi giữ (holding register).


Mỗi khung kết thúc bằng CRC16 (đa thức 0xA001, byte thấp gửi trước). Master phải kiểm tra địa chỉ, mã hàm, số byte và CRC trước khi dùng dữ liệu; nếu cảm biến trả mã hàm có bit 7 = 1 (0x84) là phản hồi lỗi.
5. Chương trình (các phần chính, minh họa)
Code HAL tạo từ CubeMX. Hàm vẽ TFT (ST7789_WriteString, ST7789_FillRect) lấy từ thư viện ST7789 cho STM32 HAL phổ biến; tên hàm có thể khác theo thư viện bạn dùng.
Hàm CRC16 Modbus và gửi yêu cầu đọc (UART2, timeout có giới hạn):
#define MD02_ADDR 0x01
#define MD02_FUNC 0x04 /* Read Input Registers */
static uint16_t Modbus_CRC16(const uint8_t *buf, uint16_t len)
{
uint16_t crc = 0xFFFF;
for (uint16_t i = 0; i < len; i++) {
crc ^= buf[i];
for (uint8_t b = 0; b < 8; b++)
crc = (crc & 1) ? (uint16_t)((crc >> 1) ^ 0xA001) : (uint16_t)(crc >> 1);
}
return crc;
}
/* Đọc nhiệt độ (x10 °C) và độ ẩm (x10 %RH). Trả 1 nếu thành công. */
uint8_t MD02_Read(int16_t *temp_x10, uint16_t *hum_x10)
{
uint8_t req[8] = {MD02_ADDR, MD02_FUNC, 0x00, 0x01, 0x00, 0x02, 0, 0};
uint16_t crc = Modbus_CRC16(req, 6);
req[6] = crc & 0xFF; /* CRC: byte thấp trước */
req[7] = crc >> 8;
uint8_t rsp[9] = {0};
HAL_UART_AbortReceive(&huart2); /* bỏ rác còn trong bộ đệm */
HAL_UART_Transmit(&huart2, req, 8, 20);
if (HAL_UART_Receive(&huart2, rsp, 9, 200) != HAL_OK) return 0; /* hết thời gian */
if (rsp[0] != MD02_ADDR || rsp[1] != MD02_FUNC || rsp[2] != 4) return 0;
crc = Modbus_CRC16(rsp, 7);
if (rsp[7] != (crc & 0xFF) || rsp[8] != (crc >> 8)) return 0; /* sai CRC */
*temp_x10 = (int16_t)((rsp[3] << 8) | rsp[4]); /* có dấu: nhiệt độ âm */
*hum_x10 = (uint16_t)((rsp[5] << 8) | rsp[6]);
return 1;
}Vòng lặp chính: đọc mỗi giây, cập nhật TFT, báo lỗi khi mất kết nối:
int16_t t10; uint16_t h10;
uint8_t fail = 0;
uint32_t last = 0;
char buf[16];
while (1)
{
if (HAL_GetTick() - last >= 1000) {
last = HAL_GetTick();
if (MD02_Read(&t10, &h10)) {
fail = 0;
snprintf(buf, sizeof buf, "%d.%d C ", t10 / 10, (t10 < 0 ? -t10 : t10) % 10);
ST7789_WriteString(20, 90, buf, Font_16x26, WHITE, BLACK);
snprintf(buf, sizeof buf, "%u.%u %% ", h10 / 10, h10 % 10);
ST7789_WriteString(20, 200, buf, Font_16x26, WHITE, BLACK);
ST7789_FillRect(20, 240, (uint16_t)(h10 * 200U / 1000U), 6, RED); /* thanh độ ẩm */
} else if (++fail >= 3) {
ST7789_WriteString(20, 290, "MAT KET NOI RS485", Font_11x18, RED, BLACK);
}
}
}
6. Các bước thực hiện
- CubeMX: HSE 72 MHz; USART2 Asynchronous 9600 8N1; SPI1 Transmit Only Master (tốc độ 18 MHz trở xuống); PA4, PB0, PB1 là output.
- Thêm thư viện ST7789, khởi tạo màn hình, vẽ khung giao diện tĩnh (tiêu đề, nhãn) một lần trong setup.
- Thử Modbus trước bằng USB-RS485 + phần mềm Modbus Poll/QModMaster trên máy tính để chắc chắn địa chỉ và baud của cảm biến.
- Nối STM32, nạp code, quan sát giá trị; thổi hơi hoặc đặt tay lên cảm biến để thấy độ ẩm thay đổi.
7. Lỗi thường gặp
- Không có phản hồi: đảo A/B, sai địa chỉ hoặc baud, cảm biến chưa cấp nguồn, quên nối GND chung.
- Sai CRC thường xuyên: dây dài không xoắn, thiếu điện trở đầu cuối 120 Ω ở hai đầu bus dài.
- Nhận được dữ liệu cũ hoặc lệch byte: phải xóa bộ đệm UART trước khi gửi và dùng timeout cho mỗi lần nhận.
- TFT trắng hoặc lệch màu: sai chân DC/RES, sai chế độ SPI hoặc kích thước khởi tạo (240×320).
8. Hướng mở rộng
- Đọc nhiều cảm biến trên cùng bus bằng cách đổi địa chỉ (ghi thanh ghi địa chỉ của XY-MD02).
- Ghi log lên thẻ SD, vẽ đồ thị trên TFT, cảnh báo bằng relay khi vượt ngưỡng.
- Làm gateway Modbus RTU → MQTT với ESP32 để giám sát từ xa (xem series ESP32 trên blog).
9. Bộ tài liệu khi mua dự án (59.000đ)
- Project STM32CubeMX + Keil hoàn chỉnh, code đọc XY-MD02 qua Modbus RTU và giao diện TFT ST7789.
- File nạp (.hex) cho STM32F103C8T6, sơ đồ đấu nối.