esp-arduino-libs · Lzw655 · Jul 7, 2024 · Jul 1, 2024
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # ChangeLog
 
+## v0.1.5 - 2024-07-01
+
+### Bugfixes:
+
+* fix(panel): init expander host with correct macro (#65)
+
 ## v0.1.4 - 2024-06-17
 
 ### Enhancements:

diff --git a/README.md b/README.md
@@ -309,7 +309,7 @@ To port the SquareLine project (v1.3.x), please refer to [here](#porting-squarel
 
 ### Configuring Supported Development Boards
 
-For details on how to configure the supported development boards in the Arduino IDE, see [Board_Instructions.md](./src/board/Board_Instructions.md).
+For details on how to configure the supported development boards in the Arduino IDE, see [Board_Instructions.md](./src/board/Board_Instructions.md#recommended-configurations-in-the-arduino-ide).
 
 ### Configuring LVGL
 

diff --git a/README_CN.md b/README_CN.md
@@ -309,7 +309,7 @@ ESP32_Display_Panel 会根据 [ESP_Panel_Board_Custom.h](./ESP_Panel_Board_Custo
 
 ### 配置支持的开发板
 
-关于如何在 Arduino IDE 中配置支持的开发板，请参考 [Board_Instructions.md](./src/board/Board_Instructions.md).
+关于如何在 Arduino IDE 中配置支持的开发板，请参考 [Board_Instructions.md](./src/board/Board_Instructions.md#recommended-configurations-in-the-arduino-ide).
 
 ### 配置 LVGL
 

diff --git a/examples/LVGL/v8/Porting/Porting.ino b/examples/LVGL/v8/Porting/Porting.ino
@@ -11,16 +11,22 @@
  *
  * Then follow the steps below to configure:
  *
+ * Follow the steps below to configure:
+ *
  * 1. For **ESP32_Display_Panel**:
  *
- *    - [Configure drivers](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) if needed.
- *    - If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
- *    - If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) to configure drivers if needed.
+ *     - If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
+ *     - If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
+ *
+ * 2. For **lvgl**:
+ *
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-lvgl) to add *lv_conf.h* file and change the configurations.
+ *     - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
  *
- * 2. Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-lvgl) to configure the **lvgl**.
- * 3. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
- * 4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
- * 5. Verify and upload the example to your ESP board.
+ * 3. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported
+ *    boards, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
+ * 4. Verify and upload the example to your ESP board.
  *
  * ## Serial Output
  *

diff --git a/examples/LVGL/v8/Porting/README.md b/examples/LVGL/v8/Porting/README.md
@@ -8,18 +8,21 @@ To use this example, please firstly install the following dependent libraries:
 
 - lvgl (v8.3.x)
 
-Then follow the steps below to configure:
+Follow the steps below to configure:
 
 1. For **ESP32_Display_Panel**:
 
-    - [Configure drivers](../../../README.md#configuring-drivers) if needed.
-    - If using a supported development board, follow the [steps](../../../../README.md#using-supported-development-boards) to configure it.
-    - If using a custom board, follow the [steps](../../../../README.md#using-custom-development-boards) to configure it.
+    - Follow the [steps](../../README.md#configuring-drivers) to configure drivers if needed.
+    - If using a supported development board, follow the [steps](../../README.md#using-supported-development-boards) to configure it.
+    - If using a custom board, follow the [steps](../../README.md#using-custom-development-boards) to configure it.
 
-2. Follow the [steps](../../../../README.md#configuring-lvgl) to configure the **lvgl**.
-3. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
-4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](../../../../README.md#configuring-supported-development-boards)
-5. Verify and upload the example to your ESP board.
+2. For **lvgl**:
+
+    - Follow the [steps](../../README.md#configuring-lvgl) to add *lv_conf.h* file and change the configurations.
+    - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
+
+3. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported boards, please refter to [Configuring Supported Development Boards](../../README.md#configuring-supported-development-boards)
+4. Verify and upload the example to your ESP board.
 
 ## Serial Output
 

diff --git a/examples/LVGL/v8/Rotation/README.md b/examples/LVGL/v8/Rotation/README.md
@@ -12,14 +12,17 @@ Then follow the steps below to configure:
 
 1. For **ESP32_Display_Panel**:
 
-    - [Configure drivers](../../../README.md#configuring-drivers) if needed.
-    - If using a supported development board, follow the [steps](../../../../README.md#using-supported-development-boards) to configure it.
-    - If using a custom board, follow the [steps](../../../../README.md#using-custom-development-boards) to configure it.
-
-2. Follow the [steps](../../../../README.md#configuring-lvgl) to configure the **lvgl**.
-3. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
-4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](../../../../README.md#configuring-supported-development-boards)
-5. Verify and upload the example to your ESP board.
+    - Follow the [steps](../../README.md#configuring-drivers) to configure drivers if needed.
+    - If using a supported development board, follow the [steps](../../README.md#using-supported-development-boards) to configure it.
+    - If using a custom board, follow the [steps](../../README.md#using-custom-development-boards) to configure it.
+
+2. For **lvgl**:
+
+    - Follow the [steps](../../README.md#configuring-lvgl) to add *lv_conf.h* file and change the configurations.
+    - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
+
+3. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported boards, please refter to [Configuring Supported Development Boards](../../README.md#configuring-supported-development-boards)
+4. Verify and upload the example to your ESP board.
 
 ## Serial Output
 

diff --git a/examples/LVGL/v8/Rotation/Rotation.ino b/examples/LVGL/v8/Rotation/Rotation.ino
@@ -9,18 +9,22 @@
  *
  * - lvgl (v8.3.x)
  *
- * Then follow the steps below to configure:
+ * Follow the steps below to configure:
  *
  * 1. For **ESP32_Display_Panel**:
  *
- *     - [Configure drivers](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) if needed.
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) to configure drivers if needed.
  *     - If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
  *     - If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
  *
- * 2. Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-lvgl) to configure the **lvgl**.
- * 3. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
- * 4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
- * 5. Verify and upload the example to your ESP board.
+ * 2. For **lvgl**:
+ *
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-lvgl) to add *lv_conf.h* file and change the configurations.
+ *     - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
+ *
+ * 3. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported
+ *    boards, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
+ * 4. Verify and upload the example to your ESP board.
  *
  * ## Serial Output
  *

diff --git a/examples/Panel/PanelTest/PanelTest.ino b/examples/Panel/PanelTest/PanelTest.ino
@@ -7,11 +7,15 @@
  *
  * Follow the steps below to configure:
  *
- * 1. [Configure drivers](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) if needed.
- * 2. If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
- * 3. If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
- * 4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
- * 5. Verify and upload the example to your ESP board.
+ * 1. For **ESP32_Display_Panel**:
+ *
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) to configure drivers if needed.
+ *     - If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
+ *     - If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
+ *
+ * 2. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported
+ *    boards, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
+ * 3. Verify and upload the example to your ESP board.
  *
  * ## Serial Output
  *

diff --git a/examples/Panel/PanelTest/README.md b/examples/Panel/PanelTest/README.md
@@ -6,11 +6,14 @@ The example demonstrates how to develop built-in or custom development boards us
 
 Follow the steps below to configure:
 
-1. [Configure drivers](../../../README.md#configuring-drivers) if needed.
-2. If using a supported development board, follow the [steps](../../../README.md#using-supported-development-boards) to configure it.
-3. If using a custom board, follow the [steps](../../../README.md#using-custom-development-boards) to configure it.
-4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](../../../README.md#configuring-supported-development-boards)
-5. Verify and upload the example to your ESP board.
+1. For **ESP32_Display_Panel**:
+
+    - Follow the [steps](../../README.md#configuring-drivers) to configure drivers if needed.
+    - If using a supported development board, follow the [steps](../../README.md#using-supported-development-boards) to configure it.
+    - If using a custom board, follow the [steps](../../README.md#using-custom-development-boards) to configure it.
+
+3. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported boards, please refter to [Configuring Supported Development Boards](../../README.md#configuring-supported-development-boards)
+4. Verify and upload the example to your ESP board.
 
 ## Serial Output
 

diff --git a/examples/SquareLine/v8/Porting/Porting.ino b/examples/SquareLine/v8/Porting/Porting.ino
@@ -9,19 +9,22 @@
  *
  * - lvgl (v8.3.x)
  *
- * Then follow the steps below to configure:
+ * Follow the steps below to configure:
  *
  * 1. For **ESP32_Display_Panel**:
  *
- *    - [Configure drivers](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) if needed.
- *    - If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
- *    - If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-drivers) to configure drivers if needed.
+ *     - If using a supported development board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-supported-development-boards) to configure it.
+ *     - If using a custom board, follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#using-custom-development-boards) to configure it.
  *
- * 2. Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-lvgl) to configure the **lvgl**.
- * 3. To directly use the example, please copy the [ui](./libraries/ui/) folder from `libraries` to [Arduino Library directory](https://github.com/esp-arduino-libs/ESP32_Display_Panel#where-is-the-directory-for-arduino-libraries). What's more, you can follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#porting-squareline-project) to port your own **SquareLine** project.
- * 4. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
- * 5. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
- * 6. Verify and upload the example to your ESP board.
+ * 2. For **lvgl**:
+ *
+ *     - Follow the [steps](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-lvgl) to add *lv_conf.h* file and change the configurations.
+ *     - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
+ *
+ * 3. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported
+ *    boards, please refter to [Configuring Supported Development Boards](https://github.com/esp-arduino-libs/ESP32_Display_Panel#configuring-supported-development-boards)
+ * 4. Verify and upload the example to your ESP board.
  *
  * ## Serial Output
  *

diff --git a/examples/SquareLine/v8/Porting/README.md b/examples/SquareLine/v8/Porting/README.md
@@ -12,15 +12,18 @@ Then follow the steps below to configure:
 
 1. For **ESP32_Display_Panel**:
 
-    - [Configure drivers](../../../README.md#configuring-drivers) if needed.
-    - If using a supported development board, follow the [steps](../../../../README.md#using-supported-development-boards) to configure it.
-    - If using a custom board, follow the [steps](../../../../README.md#using-custom-development-boards) to configure it.
+   - [Configure drivers](../../../../README.md#configuring-drivers) if needed.
+   - If using a supported development board, follow the [steps](../../../../README.md#using-supported-development-boards) to configure it.
+   - If using a custom board, follow the [steps](../../../../README.md#using-custom-development-boards) to configure it.
+
+2. For **lvgl**:
+
+    - Follow the [steps](../../README.md#configuring-lvgl) to add *lv_conf.h* file and change the configurations.
+    - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
 
-2. Follow the [steps](../../../../README.md#configuring-lvgl) to configure the **lvgl**.
 3. To directly use the example, please copy the [ui](./libraries/ui/) folder from `libraries` to [Arduino Library directory](../../../../README.md#where-is-the-directory-for-arduino-libraries). What's more, you can follow the [steps](../../../../README.md#porting-squareline-project) to port your own **SquareLine** project.
-4. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
-5. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters, please refter to [Configuring Supported Development Boards](../../../../README.md#configuring-supported-development-boards)
-6. Verify and upload the example to your ESP board.
+4. Navigate to the `Tools` menu in the Arduino IDE to choose a ESP board and configure its parameters. For supported boards, please refter to [Configuring Supported Development Boards](../../README.md#configuring-supported-development-boards)
+5. Verify and upload the example to your ESP board.
 
 ## Serial Output
 

diff --git a/examples/SquareLine/v8/WiFiClock/README.md b/examples/SquareLine/v8/WiFiClock/README.md
@@ -14,20 +14,24 @@ Then follow the steps below to configure the example.
 
 1. For **ESP32_Display_Panel**:
 
-    - [Configure drivers](../../../README.md#configuring-drivers) if needed.
-    - If using a supported development board, follow the [steps](../../../../README.md#using-supported-development-boards) to configure it.
-    - If using a custom board, follow the [steps](../../../../README.md#using-custom-development-boards) to configure it.
+   - [Configure drivers](../../../../README.md#configuring-drivers) if needed.
+   - If using a supported development board, follow the [steps](../../../../README.md#using-supported-development-boards) to configure it.
+   - If using a custom board, follow the [steps](../../../../README.md#using-custom-development-boards) to configure it.
 
 2. Copy the [ui](./libraries/ui/) folder from `libraries` to [Arduino Library directory](../../../../README.md#where-is-the-directory-for-arduino-libraries).
 
-3. Follow the [steps](../../../../README.md#configuring-lvgl) to configure the **lvgl**. Additionally, set the following configurations to `1`:
+3. For **lvgl**:
 
-   - `LV_FONT_MONTSERRAT_12`
-   - `LV_FONT_MONTSERRAT_14`
-   - `LV_FONT_MONTSERRAT_16`
-   - `LV_FONT_MONTSERRAT_32`
-   - `LV_FONT_MONTSERRAT_48`
-   - `LV_USE_LARGE_COORD`
+   - Follow the [steps](../../../../README.md#configuring-lvgl) to add *lv_conf.h* file and change the configurations. Additionally, set the following configurations to `1`:
+
+      - `LV_FONT_MONTSERRAT_12`
+      - `LV_FONT_MONTSERRAT_14`
+      - `LV_FONT_MONTSERRAT_16`
+      - `LV_FONT_MONTSERRAT_32`
+      - `LV_FONT_MONTSERRAT_48`
+      - `LV_USE_LARGE_COORD`
+
+   - Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
 
 4. Modify the macros in the [lvgl_port_v8.h](./lvgl_port_v8.h) file to configure the LVGL porting parameters.
 5. To obtain weather information after connecting to Wi-Fi, please follow these steps to configure the example:
@@ -59,4 +63,4 @@ wifi_list_switch: false
 
 ## Troubleshooting
 
-Please check the [FAQ](../../../../README.md#faq) first to see if the same question exists. If not, please create a [Github issue](https://github.com/esp-arduino-libs/ESP32_Display_Panel/issues). We will get back to you as soon as possible.
+Please check the [FAQ](../../../../README.md#faq) first to see if the same question exists. If not, please create a [Github issue](../../../../README.md/issues). We will get back to you as soon as possible.