##  高级功能

### Guition 自定义函数功能介绍

Guition 提供了一个自定义函数功能，允许用户在函数模块中自定义函数，然后在初始化完成后执行这些函数。用户可以在自定义函数中编写标准 C 语言代码，实现各种自定义功能。

以下是自定义函数功能的使用说明：

#### 自定义函数编写

用户可以在函数模块中编写自己的函数，格式如下：

```c
//USER CODE（请勿删除此行）

void myCustomFunction(){
   // 在这里编写自定义函数的代码
   // 可以是任何标准 C 语言代码
   // 例如：控制输出、执行计算、调用其他函数等
}

//USER CODE END（请勿删除此行）

```

#### 执行自定义函数

在初始化完成后，用户可以在 `//DONE` 和 `//DONE END` 之间的位置直接输入自定义函数名，这些函数将会按顺序执行。

```c
//DONE（请勿删除此行）

myCustomFunction(); // 执行自定义函数

//DONE END（请勿删除此行）

```

#### 示例

假设用户想要在 Guition 初始化完成后执行一个自定义函数 `myCustomFunction`，该函数输出 "Hello, Guition!"，则可以按照以下方式编写代码：

```c
//USER CODE（请勿删除此行）

void myCustomFunction(){
   Serial.println("Hello, Guition!");
}

//USER CODE END（请勿删除此行）

//DONE（请勿删除此行）

myCustomFunction(); // 执行自定义函数

//DONE END（请勿删除此行）

```

在上面的示例中，初始化完成后，串口会输出 "Hello, Guition!"，表示自定义函数已经成功执行。

### 自定义函数高级示例

\
下面是一个复杂示例，其中包含了两个自定义函数，一个用于初始化设置，另一个用于定时更新显示内容。

```c
//USER CODE（请勿删除此行）

// 自定义函数：初始化设置
void initSettings(){
   // 设置串口波特率
   Serial.begin(9600); //实际上不能支持这样设置串口使用，实际需要配置GPIO口
   // 设置屏幕亮度
   setBrightness(80);
   // 显示欢迎消息
   displayWelcomeMessage();
}

// 自定义函数：定时更新显示内容
void updateDisplay(){
   // 获取当前时间
   String currentTime = getCurrentTime();
   // 在屏幕上显示当前时间
   displayText(currentTime, 100, 50, 16, "green");
}

// 用户自定义函数：设置屏幕亮度
void setBrightness(int brightness){
   // 在这里编写设置屏幕亮度的代码
   // 例如：发送命令给 Guition 串口屏设置亮度
   Serial.print("{\"command\": \"set_brightness\", \"params\": {\"brightness\": ");
   Serial.print(brightness);
   Serial.println("}}");
}

// 用户自定义函数：显示欢迎消息
void displayWelcomeMessage(){
   // 在这里编写显示欢迎消息的代码
   // 例如：发送命令给 Guition 串口屏显示欢迎消息
   Serial.println("{\"command\": \"display_text\", \"params\": {\"text\": \"Welcome to Guition!\", \"position\": {\"x\": 50, \"y\": 100}, \"font_size\": 20, \"color\": \"blue\"}}");
}

// 用户自定义函数：获取当前时间
String getCurrentTime(){
   // 在这里编写获取当前时间的代码
   // 例如：获取当前系统时间，并格式化为字符串
   return "12:30 PM"; // 这里假设当前时间是 12:30 PM
}

// 用户自定义函数：在屏幕上显示文本
void displayText(String text, int x, int y, int fontSize, String color){
   // 在这里编写显示文本的代码
   // 例如：发送命令给 Guition 串口屏显示指定文本
   Serial.print("{\"command\": \"display_text\", \"params\": {\"text\": \"");
   Serial.print(text);
   Serial.print("\", \"position\": {\"x\": ");
   Serial.print(x);
   Serial.print(", \"y\": ");
   Serial.print(y);
   Serial.print("}, \"font_size\": ");
   Serial.print(fontSize);
   Serial.print(", \"color\": \"");
   Serial.print(color);
   Serial.println("\"}}");
}

//USER CODE END（请勿删除此行）

//DONE（请勿删除此行）

initSettings(); // 执行初始化设置函数
updateDisplay(); // 执行定时更新显示内容函数

//DONE END（请勿删除此行）

```

在这个示例中，`initSettings()` 函数用于初始化设置，包括设置串口波特率、设置屏幕亮度和显示欢迎消息。`updateDisplay()` 函数用于定时更新显示内容，它获取当前时间并在屏幕上显示。

这个示例展示了如何使用自定义函数在 Guition 串口屏上进行复杂的操作，包括初始化设置和定时更新显示内容。

### Arduino API

使用ESP32 芯片的 Guition 平台硬件支持多数的Arduino API，这意味着您可以直接在 Guition 串口屏上使用 Arduino 的库和函数。通过 Arduino API，您可以轻松地使用串口通信、数字输入输出、模拟输入输出、定时器、中断等功能，实现丰富的应用。

以下是一些 Arduino API 的常见用法示例：

1.  **串口通信**：使用 `Serial.begin()` 和 `Serial.print()` 函数与 Guition 串口屏进行通信，发送命令和接收数据。
2.  **数字输入输出**：使用 `pinMode()` 函数设置引脚模式为输入或输出，使用 `digitalRead()` 和 `digitalWrite()` 函数读取或控制数字引脚的状态。
3.  **模拟输入输出**：使用 `analogRead()` 函数读取模拟引脚的电压值，使用 `analogWrite()` 函数控制模拟输出引脚的 PWM 信号。
4.  **定时器**：使用 `millis()` 函数获取系统运行时间，实现定时功能，例如定时执行某个操作。
5.  **中断**：使用 `attachInterrupt()` 函数设置中断服务程序，响应外部事件，例如按钮按下或传感器触发。

通过 Arduino API，您可以快速、灵活地开发应用程序，利用 Guition 串口屏的丰富功能，实现各种交互式界面和智能控制应用。

关于Arduino API还处在非完全支持状态，我们会提供更多相关信息帮助您使用第三方库实现高级功能，敬请期待...