高级功能

Guition 自定义函数功能介绍

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

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

自定义函数编写

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

//USER CODE(请勿删除此行)

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

//USER CODE END(请勿删除此行)

执行自定义函数

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

//DONE(请勿删除此行)

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

//DONE END(请勿删除此行)

示例

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

//USER CODE(请勿删除此行)

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

//USER CODE END(请勿删除此行)

//DONE(请勿删除此行)

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

//DONE END(请勿删除此行)

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

自定义函数高级示例


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

//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还处在非完全支持状态,我们会提供更多相关信息帮助您使用第三方库实现高级功能,敬请期待…