【得捷 Follow Me 第3期】+ 任务总结帖

ID.LODA · 发表于2023-12-17 00:17

【得捷 Follow Me 第3期】+ 任务总结帖 [复制链接]

<i class="pstatus"> 本帖最后由 ID.LODA 于 2023-12-17 22:44 编辑 </i>

# 项目介绍
本次项目实现的是多功能家用温湿度计，涉及核心控制器是 Seeed Studio XIAO ESP32C3, 主要功能如下：
1. 连接 WIFI 定时同步网络时间至本地，并更新在外置 RTC 模块 BM8563
1. 连接 AHTX0 Sensor，获取室内温湿度值， 连接 Light Sensor 获取当前环境光强度
1. 连接 Round Display for XIAO，显示日期和传感器值
1. 连接 SD 定时保存时间和对应的传感器值
演示视频如下：
<div id="player_4bff6f382f880d791bc199cd4625d0670" class="localvideo-box"></div><div class="localvideo-title">1001577808</div><br/>

## 任务/项目总结报告
主控芯片 [Seeed Studio XIAO ESP32C3](https://wiki.seeedstudio.com/XIAO_ESP32C3_Getting_Started/) 是一款基于express的物联网迷你开发板 ESP32-C3 WiFi/蓝牙双模芯片ESP32-C3是一款32位RISC-V CPU，包含一个FPU(浮点单元)，用于32位单精度运算，具有强大的计算能力。 它具有出色的射频性能，支持IEEE 802.11 b/g/n WiFi和蓝牙5 (LE)协议。该电路板附带一个外部天线，以增加无线应用程序的信号强度。 它还具有小巧精致的外形，并结合了单面表面贴装设计。 它配备了丰富的接口，具有11个数字I/O，可作为PWM引脚和4个模拟I/O，可作为ADC引脚。支持**UART、I2C、SPI等4种串行接口。

![Seeed Studio XIAO ESP32C3](https://files.seeedstudio.com/wiki/XIAO_WiFi/pin_map-2.png)

### 任务1：使用MicroPython系统
按下 BOOT 按键不松手，上电模块之后松手即可进入下载模式

#### 使用esptool升级固件
1. 从 github 下载最新的 esptool 工具
```cmd
https://github.com/espressif/esptool.git
```
1. 下载最新固件
```cmd
https://micropython.org/download/esp32c3/
```
1. 把最新的 firm 放到这个文件位置，用CMD打开这个文件
```cmd
your own file location\esptool-master\esptool
```
1. 在CMD中输入此命令刷新固件(在刷新前进入bootloader模式)
```cmd
esptool.exe --chip esp32c3 --port COM10 --baud 921600 --before default_reset --after hard_reset --no-stub  write_flash --flash_mode dio --flash_freq 80m 0x0 esp32c3-usb-20230426-v1.20.0.bin
```
![Download](https://files.seeedstudio.com/wiki/wiki-ranger/Contributions/C3-MicroPy/C3-MicroPython2.png）

#### 其他方式
参考 https://wiki.seeedstudio.com/cn/XIAO_ESP32C3_MicroPython/ 该篇文章即可

#### 任务代码
```python
from machine import Pin
import time

print("Local time: %s" % str(time.localtime()))

counter = 0
while True:
    counter += 1
```
#### 任务效果

### 任务2：驱动扩展板上的OLED屏幕（必做任务）
扩展板选择的是原厂的 Round Dispaly For XIAO，相比于 Expansion Board Base for XIAO 资源更加丰富，但是接口扩展会比较麻烦，具体资料在如下地址 https://wiki.seeedstudio.com/get_start_round_display/
![Round Dispaly For XIAO](https://files.seeedstudio.com/wiki/round_display_for_xiao/round-pinout.png)
开发使用的是 andruino 方式，需要安装对应的图形驱动库，步骤相对繁琐，直接参考官网教程即可 https://wiki.seeedstudio.com/get_start_round_display/

#### 任务代码
```c
/*
 An example analogue clock using a TFT LCD screen to show the time
 use of some of the drawing commands with the library.

For a more accurate clock, it would be better to use the RTClib library.
 But this is just a demo. 
 
 This sketch uses font 4 only.

Make sure all the display driver and pin connections are correct by
 editing the User_Setup.h file in the TFT_eSPI library folder.

#########################################################################
 ###### DON'T FORGET TO UPDATE THE User_Setup.h FILE IN THE LIBRARY ######
 #########################################################################
 
 Based on a sketch by Gilchrist 6/2/2014 1.0
 */

#include <SPI.h>
#include <TFT_eSPI.h> // Hardware-specific library
#include <PNGdec.h>
#include "panda.h" // Image is stored here in an 8 bit array

#define TFT_GREY 0x5AEB
#define MAX_IMAGE_WIDTH 240 // Adjust for your images

TFT_eSPI tft = TFT_eSPI();       // Invoke custom library
PNG png; // PNG decoder inatance

int16_t xpos = 0;
int16_t ypos = 0;

void setup(void) {
  
  Serial.begin(115200);

// Initialise the TFT
  tft.init();
  tft.setRotation(0);
  // tft.fillScreen(TFT_BLACK);
  // tft.fillScreen(TFT_RED);
  // tft.fillScreen(TFT_GREEN);
  // tft.fillScreen(TFT_BLUE);
  tft.fillScreen(TFT_BLACK);
  // tft.fillScreen(TFT_GREY);
  // tft.setTextColor(TFT_WHITE, TFT_GREY);  // Adding a background colour erases previous text automatically
  tft.setTextColor(TFT_RED);
  
  Serial.println("\r\nInitialisation done.");
}

void loop() {
  int16_t rc = png.openFLASH((uint8_t *)panda, sizeof(panda), pngDraw);
  if (rc == PNG_SUCCESS) {
    Serial.println("Successfully opened png file");
    Serial.printf("image specs: (%d x %d), %d bpp, pixel type: %d\n", png.getWidth(), png.getHeight(), png.getBpp(), png.getPixelType());
    tft.startWrite();
    uint32_t dt = millis();
    rc = png.decode(NULL, 0);
    Serial.print(millis() - dt); Serial.println("ms");
    tft.endWrite();
    // png.close(); // not needed for memory->memory decode
  }

delay(1000);
  tft.fillScreen(random(0x10000));
}

//=========================================v==========================================
//                                      pngDraw
//====================================================================================
// This next function will be called during decoding of the png file to
// render each image line to the TFT.  If you use a different TFT library
// you will need to adapt this function to suit.
// Callback function to draw pixels to the display
void pngDraw(PNGDRAW *pDraw) {
  uint16_t lineBuffer[MAX_IMAGE_WIDTH];
  png.getLineAsRGB565(pDraw, lineBuffer, PNG_RGB565_BIG_ENDIAN, 0xffffffff);
  tft.pushImage(xpos, ypos + pDraw->y, pDraw->iWidth, 1, lineBuffer);
}
```
#### 任务效果

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_764976" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=764976&handlekey=savephoto_764976">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

### 任务3：控制蜂鸣器播放音乐
该任务用到了 [Grove - Buzzer](https://wiki.seeedstudio.com/Grove-Buzzer/) 模块，通过 DI 控制蜂鸣器的开关
根据音符与频率对照表，定义定所需的音符频率，参考 arduino 官方示例 https://docs.arduino.cc/built-in-examples/digital/toneMelody
[音符与频率对照表](https://bbs.eeworld.com.cn/data/attachment/forum/202312/15/154956s1qp3p1z0wpqcoq7.png)
#### 任务代码
```c
/*
 Play a melody
*/

#include "pitches.h"

#define BUZZER_PIN    D2

// 记录曲子的音符
int melody[] = { 0, 0, NOTE_E5, NOTE_D5, NOTE_E5, NOTE_D5, NOTE_E5, NOTE_B4, NOTE_D5, NOTE_C5, 
                 NOTE_A4, 0, NOTE_C4, NOTE_E4, NOTE_A4, NOTE_B4, 0, NOTE_E4, NOTE_G4, NOTE_B4, 
                 NOTE_C5, 0, NOTE_E4, NOTE_E5, NOTE_D5, NOTE_E5, NOTE_D5, NOTE_E5, NOTE_B4, NOTE_D5, NOTE_C5,
                 NOTE_A4, 0, NOTE_C4, NOTE_E4, NOTE_A4, NOTE_B4, 0, NOTE_E4, NOTE_C5, NOTE_B4,
                 NOTE_A4
               };

// 音符持续时间：4为四分音符，8为八分音符
int noteDurations[] = { 4, 4, 8, 8, 8, 8, 8, 8, 8, 8, 
                        4, 8, 8, 8, 8, 4, 8, 8, 8, 8, 
                        4, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 
                        4, 8, 8, 8, 8, 4, 8, 8, 8, 8,
                        4, 4, 8, 8, 8, 8, 8, 8, 8, 8, 
                        4
                      };

void setup() {

// iterate over the notes of the melody:
  for(int thisNote = 0; thisNote < sizeof(melody)/sizeof(melody[0]); thisNote++) {

// to calculate the note duration, take one second divided by the note type.
    //e.g. quarter note = 1000 / 4, eighth note = 1000/8, etc.
    int noteDuration = 1000/noteDurations[thisNote];
    tone(BUZZER_PIN, melody[thisNote], noteDuration);

// to distinguish the notes, set a minimum time between them.
    // the note's duration + 30% seems to work well:
    int pauseBetweenNotes = noteDuration * 1.30;
    delay(pauseBetweenNotes);

// stop the tone playing:
    noTone(BUZZER_PIN);
  }
  
}

void loop() {
  
}

```
```h
/*************************************************

* Public Constants

*************************************************/

#define NOTE_B0  31
#define NOTE_C1  33
#define NOTE_CS1 35
#define NOTE_D1  37
#define NOTE_DS1 39
#define NOTE_E1  41
#define NOTE_F1  44
#define NOTE_FS1 46
#define NOTE_G1  49
#define NOTE_GS1 52
#define NOTE_A1  55
#define NOTE_AS1 58
#define NOTE_B1  62
#define NOTE_C2  65
#define NOTE_CS2 69
#define NOTE_D2  73
#define NOTE_DS2 78
#define NOTE_E2  82
#define NOTE_F2  87
#define NOTE_FS2 93
#define NOTE_G2  98
#define NOTE_GS2 104
#define NOTE_A2  110
#define NOTE_AS2 117
#define NOTE_B2  123
#define NOTE_C3  131
#define NOTE_CS3 139
#define NOTE_D3  147
#define NOTE_DS3 156
#define NOTE_E3  165
#define NOTE_F3  175
#define NOTE_FS3 185
#define NOTE_G3  196
#define NOTE_GS3 208
#define NOTE_A3  220
#define NOTE_AS3 233
#define NOTE_B3  247
#define NOTE_C4  262
#define NOTE_CS4 277
#define NOTE_D4  294
#define NOTE_DS4 311
#define NOTE_E4  330
#define NOTE_F4  349
#define NOTE_FS4 370
#define NOTE_G4  392
#define NOTE_GS4 415
#define NOTE_A4  440
#define NOTE_AS4 466
#define NOTE_B4  494
#define NOTE_C5  523
#define NOTE_CS5 554
#define NOTE_D5  587
#define NOTE_DS5 622
#define NOTE_E5  659
#define NOTE_F5  698
#define NOTE_FS5 740
#define NOTE_G5  784
#define NOTE_GS5 831
#define NOTE_A5  880
#define NOTE_AS5 932
#define NOTE_B5  988
#define NOTE_C6  1047
#define NOTE_CS6 1109
#define NOTE_D6  1175
#define NOTE_DS6 1245
#define NOTE_E6  1319
#define NOTE_F6  1397
#define NOTE_FS6 1480
#define NOTE_G6  1568
#define NOTE_GS6 1661
#define NOTE_A6  1760
#define NOTE_AS6 1865
#define NOTE_B6  1976
#define NOTE_C7  2093
#define NOTE_CS7 2217
#define NOTE_D7  2349
#define NOTE_DS7 2489
#define NOTE_E7  2637
#define NOTE_F7  2794
#define NOTE_FS7 2960
#define NOTE_G7  3136
#define NOTE_GS7 3322
#define NOTE_A7  3520
#define NOTE_AS7 3729
#define NOTE_B7  3951
#define NOTE_C8  4186
#define NOTE_CS8 4435
#define NOTE_D8  4699
#define NOTE_DS8 4978

```

#### 任务效果
编译运行之后可以听到蜂鸣器在播放

### 任务4：连接WiFi网络
该任务的实现用到了板载的 WIFI 功能以及 Round Display for XIAO 的外置 RTC 芯片 BM8563，采用 I2C 通讯

#### 任务代码
```c
#include "I2C_BM8563.h"
#include <WiFi.h>

#define TIME_ZONE   8 * 3600

I2C_BM8563 rtc(I2C_BM8563_DEFAULT_ADDRESS, Wire);

const char* ntpServer = "time.cloudflare.com";
const char *ssid     = ""; // Set before Complie
const char *password = ""; // Set before Complie

void setup() {
  // Init Serial
  Serial.begin(115200);
  delay(50);

// Connect to an access point
  WiFi.begin(ssid, password);
  Serial.print("Connecting to Wi-Fi ");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println(" CONNECTED");

// Set ntp time to local
  configTime(TIME_ZONE, 0, ntpServer);

// Init I2C
  Wire.begin();

// Init RTC
  rtc.begin();

// Get local time
  struct tm timeInfo;
  if (getLocalTime(&timeInfo)) {
    // Set RTC time
    I2C_BM8563_TimeTypeDef timeStruct;
    timeStruct.hours   = timeInfo.tm_hour;
    timeStruct.minutes = timeInfo.tm_min;
    timeStruct.seconds = timeInfo.tm_sec;
    rtc.setTime(&timeStruct);

// Set RTC Date
    I2C_BM8563_DateTypeDef dateStruct;
    dateStruct.weekDay = timeInfo.tm_wday;
    dateStruct.month   = timeInfo.tm_mon + 1;
    dateStruct.date    = timeInfo.tm_mday;
    dateStruct.year    = timeInfo.tm_year + 1900;
    rtc.setDate(&dateStruct);
  }
}

void loop() {
  I2C_BM8563_DateTypeDef dateStruct;
  I2C_BM8563_TimeTypeDef timeStruct;

// Get RTC
  rtc.getDate(&dateStruct);
  rtc.getTime(&timeStruct);

// Print RTC
#if defined(CONFIG_IDF_Td:\trunk\open-source\seeedstudio_xiao_esp32c3\arduino\chapter2\chapter02.inoARGET_ESP32S3) || defined(CONFIG_IDF_TARGET_ESP32C3)
    Serial.printf("%04d/%02d/%02d %02d:%02d:%02d\n",
                dateStruct.year,
                dateStruct.month,
                dateStruct.date,
                timeStruct.hours,
                timeStruct.minutes,
                timeStruct.seconds
               );
#else
     Serial.print(dateStruct.year);
     Serial.print(", ");
     Serial.print(dateStruct.month);
     Serial.print(", ");
     Serial.print(dateStruct.date);
     Serial.print(", ");
     Serial.print(timeStruct.hours);
     Serial.print(", ");
     Serial.print(timeStruct.minutes);
     Serial.print(", ");
     Serial.print(timeStruct.seconds);
     Serial.println();
#endif

// Wait
  delay(1000);
}
```
#### 任务效果

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_764977" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=764977&handlekey=savephoto_764977">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

### 任务5：使用外部传感器
该任务的实现用到了 [Adafruit AHT20](https://learn.adafruit.com/adafruit-aht20/overview)、[Grove - Light Sensor](https://wiki.seeedstudio.com/Grove-Light_Sensor/)、[Grove - Thumb Joystick](https://wiki.seeedstudio.com/Grove-Thumb_Joystick/#play-with-arduino) 三个传感器模块，前者使用的是 I2C 通讯，后两者均采用模拟量读取值

#### 任务代码
```c
/*
 An example analogue clock using a TFT LCD screen to show the time
 use of some of the drawing commands with the library.

For a more accurate clock, it would be better to use the RTClib library.
 But this is just a demo. 
 
 This sketch uses font 4 only.

Make sure all the display driver and pin connections are correct by
 editing the User_Setup.h file in the TFT_eSPI library folder.

#########################################################################
 ###### DON'T FORGET TO UPDATE THE User_Setup.h FILE IN THE LIBRARY ######
 #########################################################################
 
 Based on a sketch by Gilchrist 6/2/2014 1.0
 */

#include <SPI.h>
#include <TFT_eSPI.h> // Hardware-specific library
#include "I2C_BM8563.h"
#include <Adafruit_AHTX0.h>

Adafruit_AHTX0 aht;

#define TFT_GREY 0x5AEB
#define MAX_IMAGE_WIDTH 240 // Adjust for your images
TFT_eSPI tft = TFT_eSPI();       // Invoke custom library

unsigned long previousMillis = 0;  //will store last time LED was blinked
const long period = 1000;         // period at which to blink in ms
sensors_event_t humidity, temp;

void setup(void) {
  
  Serial.begin(115200);

// Initialise the TFT
  tft.init();
  tft.setRotation(0);
  tft.fillScreen(TFT_BLACK);
  // tft.fillScreen(TFT_GREY);
  tft.setTextColor(TFT_WHITE, TFT_GREY);  // Adding a background colour erases previous text automatically
  // tft.setTextColor(TFT_RED);

// Initialise the aht
  if (!aht.begin()) {
    Serial.println("Could not find AHT? Check wiring");
    while (1) delay(10);
  } else {
    Serial.println("AHT10 or AHT20 found");
  }
  
  Serial.println("\r\nInitialisation done.");
}

void loop() {
  unsigned long currentMillis = millis(); // store the current time
  if (currentMillis - previousMillis >= period) { // check if 1000ms passed
    previousMillis = currentMillis;   // save the last time you blinked the LED
    aht.getEvent(&humidity, &temp);// populate temp and humidity objects with fresh data
  }

char buffer[64];
  sprintf(buffer, "Temperature: %.2f degrees C", temp.temperature);
  Serial.println(buffer);
  tft.drawString(buffer, 16, 64);
  sprintf(buffer, "Humidity: %.2f% rH", humidity.relative_humidity);
  Serial.println(buffer);
  tft.drawString(buffer, 16, 76);

int value = analogRead(A0);
  value = map(value, 0, 800, 0, 100);
  sprintf(buffer, "Light Sensor: %d adv", value);
  Serial.println(buffer);
  tft.drawString(buffer, 16, 88);

int xValue = analogRead(A1);
  int yValue = analogRead(A2);
  sprintf(buffer, "The X and Y coordinate is: %d,%d", xValue, yValue);
  Serial.println(buffer);
  tft.drawString(buffer, 16, 100);

delay(200);
  tft.fillScreen(random(0x10000));
}

```

#### 任务效果

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_764978" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=764978&handlekey=savephoto_764978">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

### 任务6：综合实践 - 分任务2：温湿度数据记录仪

#### 任务代码
```c
// Font file is stored on SD card
#include "FS.h"
#include "SD.h"

// Graphics and font library
#include <TFT_eSPI.h>
#include <SPI.h>
#include "I2C_BM8563.h"
#include <Adafruit_AHTX0.h>
#include <WiFi.h>

#define TFT_GREY 0x5AEB
#define MAX_IMAGE_WIDTH 240 // Adjust for your images
#define TIME_ZONE   8 * 3600
#define SHOW_PERIOD_TIME    1000
#define SAVE_PERIOD_TIME    5000
#define NTP_SYNC_TIME       1000 * 60 * 60

Adafruit_AHTX0 aht;
TFT_eSPI tft = TFT_eSPI();  // Invoke library
I2C_BM8563 rtc(I2C_BM8563_DEFAULT_ADDRESS, Wire);

const char *ssid     = "shanghai2014"; // Set before Complie
const char *password = "zafu0828.samw"; // Set before Complie
const char* ntpServer = "time.cloudflare.com";
I2C_BM8563_DateTypeDef dateStruct;
I2C_BM8563_TimeTypeDef timeStruct;
sensors_event_t humidity, temp;
int illuminance = 0;
int xPos = 0;
int yPos = 0;
unsigned long previousShowMillis = 0;  //will store last time
unsigned long previousSaveMillis = 0;  //will store last time
unsigned long previousSyncMillis = 0;  //will store last time

// -------------------------------------------------------------------------
// Setup
// -------------------------------------------------------------------------
void setup(void) {
  Serial.begin(115200); // Used for messages

// Display initialization
  tft.init();
  pinMode(D2, OUTPUT);
  // Initialise the SD library before the TFT so the chip select is defined
  if (!SD.begin(D2)) {
    Serial.println("Card Mount Failed 65");
    return;
  }
  uint8_t cardType = SD.cardType();

if (cardType == CARD_NONE) {
    Serial.println("No SD card attached");
    return;
  }

Serial.print("SD Card Type: ");
  if (cardType == CARD_MMC) {
    Serial.println("MMC");
  } else if (cardType == CARD_SD) {
    Serial.println("SDSC");
  } else if (cardType == CARD_SDHC) {
    Serial.println("SDHC");
  } else {
    Serial.println("UNKNOWN");
  }

uint64_t cardSize = SD.cardSize() / (1024 * 1024);
  Serial.printf("SD Card Size: %lluMB\n", cardSize);

// Initialise the TFT after the SD card!
  tft.init();
  tft.setRotation(0);
  tft.fillScreen(TFT_BLACK);

// listDir(SD, "/", 0);

Serial.println("SD and TFT initialisation done.");

if (!aht.begin()) {
    Serial.println("Could not find AHT? Check wiring");
    while (1) delay(10);
  } else {
    Serial.println("AHT10 or AHT20 found");
  }
  
  // Connect to an access point
  WiFi.begin(ssid, password);
  Serial.print("Connecting to Wi-Fi ");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println(" CONNECTED");

// Set ntp time to local
  configTime(TIME_ZONE, 0, ntpServer);

// Init I2C
  Wire.begin();

// Init RTC
  rtc.begin();

Serial.println("Initialisation done.");

// Wrap test at right and bottom of screen
  // tft.setTextWrap(true, true);
  // Name of font file (library adds leading / and .vlw)
  String fileName = "Final-Frontier-28";
  // Font and background colour, background colour is used for anti-alias blending
  // tft.setTextColor(TFT_BLUE, TFT_BLACK);
  // Load the font
  tft.loadFont(fileName, SD);       // Use font stored on SD
  // Display all characters of the font
  // tft.showFont(2000);

// If the data.txt file doesn't exist
  // Create a file on the SD card and write the data labels
  File file = SD.open("/data.txt");
  if(!file) {
    Serial.println("File doens't exist");
    Serial.println("Creating file...");
    writeFile(SD, "/data.txt", "Reading Time, Temperature, Humidity, Illuminance\r\n");
  }
  else {
    Serial.println("File already exists");  
  }
  file.close();
}

// -------------------------------------------------------------------------
// Main loop
// -------------------------------------------------------------------------
void loop() {
  unsigned long currentMillis = millis(); // store the current time
  if ((currentMillis - previousShowMillis) > SHOW_PERIOD_TIME) { // check if 1000ms passed
    previousShowMillis = currentMillis;   // save the last time
    updateTime();
    updateSensor();
    updateShow();
  }
  if ((currentMillis - previousSyncMillis) > SHOW_PERIOD_TIME) {
    previousSyncMillis = currentMillis;   // save the last time
    syncNTP();
  }

if ((currentMillis - previousSaveMillis) > SAVE_PERIOD_TIME) {
    previousSaveMillis = currentMillis;   // save the last time
    logSDCard();
  }
  delay(200);
}

void syncNTP(void) {
  // Get local time
  struct tm timeInfo;
  if (getLocalTime(&timeInfo)) {
    // Set RTC time
    I2C_BM8563_TimeTypeDef timeStruct;
    timeStruct.hours   = timeInfo.tm_hour;
    timeStruct.minutes = timeInfo.tm_min;
    timeStruct.seconds = timeInfo.tm_sec;
    rtc.setTime(&timeStruct);

// Set RTC Date
    I2C_BM8563_DateTypeDef dateStruct;
    dateStruct.weekDay = timeInfo.tm_wday;
    dateStruct.month   = timeInfo.tm_mon + 1;
    dateStruct.date    = timeInfo.tm_mday;
    dateStruct.year    = timeInfo.tm_year + 1900;
    rtc.setDate(&dateStruct);
  }
}

void updateTime(void) {
  // Get RTC
  rtc.getDate(&dateStruct);
  rtc.getTime(&timeStruct);

// Print RTC
  Serial.printf("%04d/%02d/%02d %02d:%02d:%02d\n",
                dateStruct.year,
                dateStruct.month,
                dateStruct.date,
                timeStruct.hours,
                timeStruct.minutes,
                timeStruct.seconds
               );
}

void updateSensor(void) {
  aht.getEvent(&humidity, &temp);// populate temp and humidity objects with fresh data
  Serial.print("Temperature: "); Serial.print(temp.temperature); Serial.println(" degrees C");
  Serial.print("Humidity: "); Serial.print(humidity.relative_humidity); Serial.println("% rH");

illuminance = analogRead(A0);
  illuminance = map(illuminance, 0, 800, 0, 100);
  Serial.print("Illuminance: "); Serial.print(illuminance); Serial.println(" lux");

// xPos = analogRead(A1);
  // yPos = analogRead(A2);
}

void updateShow() {
  // delay(200);
  // tft.fillScreen(TFT_WHITE);
  tft.fillRect(16, 60, 224, 84, TFT_BLACK);
  tft.fillRect(50, 144, 140, 56, TFT_BLACK);
  tft.setTextColor(TFT_BLUE, TFT_BLACK);
  tft.drawString("temp:", 16, 60); tft.drawFloat(temp.temperature, 2, 112, 60);
  tft.drawString("humi:", 16, 88); tft.drawFloat(humidity.relative_humidity, 2, 112, 88);
  tft.setTextColor(TFT_GREEN, TFT_BLACK);
  tft.drawString("illu:", 16, 116); tft.drawNumber(illuminance, 112, 116);
  tft.setTextColor(TFT_WHITE, TFT_BLACK);
  char dataMessage[128];
  sprintf(dataMessage, "%04d/%02d/%02d", dateStruct.year, dateStruct.month, dateStruct.date);
  tft.drawString(dataMessage, 50, 144);
  sprintf(dataMessage, "%02d:%02d:%02d", timeStruct.hours, timeStruct.minutes, timeStruct.seconds);
  tft.drawString(dataMessage, 50, 172);
}

// Write the sensor readings on the SD card
void logSDCard() {
  char dataMessage[256];
  sprintf(dataMessage, "%04d/%02d/%02d %02d:%02d:%02d temp:%.2f humi:%.2f lux:%d\r\n",
                dateStruct.year, dateStruct.month, dateStruct.date,
                timeStruct.hours, timeStruct.minutes, timeStruct.seconds,
                temp.temperature, humidity.relative_humidity, illuminance);
  Serial.print("Save data: ");
  Serial.print(dataMessage);
  appendFile(SD, "/data.txt", dataMessage);
}

// Write to the SD card (DON'T MODIFY THIS FUNCTION)
void writeFile(fs::FS &fs, const char * path, const char * message) {
  Serial.printf("Writing file: %s\n", path);

File file = fs.open(path, FILE_WRITE);
  if(!file) {
    Serial.println("Failed to open file for writing");
    return;
  }
  if(file.print(message)) {
    Serial.println("File written");
  } else {
    Serial.println("Write failed");
  }
  file.close();
}

// Append data to the SD card (DON'T MODIFY THIS FUNCTION)
void appendFile(fs::FS &fs, const char * path, const char * message) {
  Serial.printf("Appending to file: %s\n", path);

File file = fs.open(path, FILE_APPEND);
  if(!file) {
    Serial.println("Failed to open file for appending");
    return;
  }
  if(file.print(message)) {
    Serial.println("Message appended");
  } else {
    Serial.println("Append failed");
  }
  file.close();
}

```

#### 任务效果
运行日志如下，效果如开头视频所见。
```bash
21:22:24.135 -> ESP-ROM:esp32c3-api1-20210207
21:22:24.771 -> SD Card Type: SDHC
21:22:24.772 -> SD Card Size: 30436MB
21:22:24.772 -> SD and TFT initialisation done.
21:22:24.772 -> AHT10 or AHT20 found
21:22:24.772 -> Connecting to Wi-Fi .. CONNECTED
21:22:24.772 -> Initialisation done.
21:22:24.772 -> File already exists
21:22:24.772 -> 2023/12/17 21:22:24
21:22:24.772 -> Temperature: 15.56 degrees C
21:22:24.772 -> Humidity: 41.90% rH
21:22:24.772 -> Illuminance2023/12/17 21:22:26
21:22:24.807 -> Temperature: 15.55 degrees C
21:22:24.807 -> Humidity: 41.66% rH
21:22:24.807 -> Illuminance: 35 lux
21:22:25.806 -> 2023/12/17 21:22:27
21:22:25.845 -> Temperature: 15.56 degrees C
21:22:25.845 -> Humidity: 41.38% rH
21:22:25.845 -> Illuminance: 19 lux
21:22:26.608 -> Save data: 2023/12/17 21:22:27 temp:15.56 humi:41.38 lux:19
21:22:26.608 -> Appending to file: /data.txt
21:22:26.608 -> Message appended
```

## 可编译下载的代码
示例代码如下，将 libraris 内容拷贝至 Arduino IDE 的库目录，或手动安装库。遇到使用 WIFI 的章节，需要填入对应的 SSID 和 Password。

<ignore_js_op>

<em class="xg1">(3.84 MB, 下载次数: 1)</em>
</span>
<div class="tip tip_4" id="attach_764986_menu" style="position: absolute; display: none" disautofocus="true">
<div class="tip_c xs0">
<div class="y">2023-12-17 22:41 上传</div>
点击文件名下载附件

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

## 心得体会
首先非常感谢 EEWorld 和 Digikey 提供这么好的活动机会，让我有机会接触使用新的板卡，学习新的知识。本次任务的时间相比之前感觉更紧凑些，我选择了更有意思的显示模块，也更费时间去研究，但最终显示效果还是比较差，比较遗憾。
最后的最后，再次感谢社区，感谢得捷！