You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: projects/Edgi-Talk_ADC/Edgi_Talk_M33_ADC/README.md
+66-20Lines changed: 66 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,39 +1,85 @@
1
1
# Edgi-Talk_ADC Example Project
2
2
3
+
[**中文**](./README_zh.md) | **English**
4
+
3
5
## Introduction
4
6
5
-
This example project is based on the **Edgi-Talk platform** and runs on the **RT-Thread real-time operating system**.
6
-
It demonstrates how to use the **ADC (Analog-to-Digital Converter)**.
7
-
Through this project, users can quickly experience ADC data acquisition and processing functions, providing a reference for developing analog signal acquisition applications.
8
-
During operation, the blue indicator LED blinks periodically, indicating that the system has started and is running normally.
7
+
This example project is based on the **Edgi-Talk platform**, running on the **RT-Thread real-time operating system**, and demonstrates how to use the **ADC (Analog-to-Digital Converter)**.
8
+
Through this project, users can quickly experience ADC data acquisition and processing, providing a reference for developing analog signal acquisition applications.
9
+
During runtime, the blue indicator LED blinks periodically, indicating that the system has started and is running properly.
10
+
11
+
### 1. Overview of ADC
12
+
13
+
**ADC (Analog-to-Digital Converter)** is a device or module that converts continuous analog signals into discrete digital signals, serving as a core component in modern digital control, signal processing, and measurement systems.
14
+
15
+
***Function**: Converts continuous signals such as voltage or current into digital values for processing by a microcontroller (MCU), DSP, or FPGA.
16
+
***Key Specifications**:
17
+
18
+
***Resolution**: The number of bits in the ADC output, representing the number of distinguishable levels. Edgi uses **12-bit** resolution, i.e., 2^12 = 4096 levels.
19
+
***Sampling Rate**: The number of samples the ADC takes per second, determining the range of detectable signal frequencies.
20
+
***Input Range**: The range of analog voltages the ADC can handle.
21
+
***Accuracy**: Indicates how closely the ADC output matches the actual input signal, affected by noise, nonlinearity, and offset errors.
22
+
23
+
### 2. ADC Working Principle
24
+
25
+
ADC operation typically involves the following stages:
26
+
27
+
1.**Sampling and Holding (Sample & Hold, S/H)**
28
+
29
+
* Captures the analog signal at a specific moment and holds it steady to ensure stability during conversion.
30
+
2.**Quantization**
31
+
32
+
* Divides the analog signal into discrete levels, each corresponding to a digital code.
33
+
* A 12-bit ADC divides the input voltage range into 4096 levels, with quantization precision expressed as ΔV = VREF / 4096.
34
+
3.**Encoding**
35
+
36
+
* Converts the quantized level into binary code for output.
37
+
38
+
## Hardware Description
39
+
40
+
### Connection Interface
41
+
42
+
43
+
44
+
### BTB Connector
45
+
46
+
47
+
48
+
### MCU Pins
49
+
50
+
51
+
52
+
### Physical Board Location
53
+
54
+
9
55
10
56
## Software Description
11
57
12
58
* The project is developed based on the **Edgi-Talk** platform.
13
59
14
-
*It uses**RT-Thread** as the operating system kernel.
60
+
*Uses**RT-Thread** as the operating system kernel.
15
61
16
62
* Example features:
17
63
18
64
* ADC initialization and sampling
19
65
* LED indicator blinking
20
-
* ADC sampling results printed through the serial port
66
+
* ADC sampling results printed via serial port
21
67
22
-
* The project structure is clear, making it easy for users to understand the ADC driver and RT-Thread thread mechanism.
68
+
* The project has a clear structure, making it easy for users to understand the ADC driver and RT-Thread threading mechanism.
23
69
24
70
## Usage Instructions
25
71
26
72
### Compilation and Download
27
73
28
-
1. Open the project and complete the build process.
29
-
2. Connect the development boardto the PC using the **onboard DAP downloader** via USB.
30
-
3. Use the programming tool to flash the generated firmware onto the development board.
74
+
1. Open the project and complete the compilation.
75
+
2. Connect the board’s USB port to the PC using the **onboard debugger (DAP)**.
76
+
3. Use the programming tool to flash the generated firmware onto the board.
31
77
32
-
### Running Results
78
+
### Runtime Behavior
33
79
34
-
* After flashing, power on the development board to run the example project.
35
-
* The **blue indicator LED** blinks every 500ms, indicating normal system scheduling.
36
-
*The ADC sampling results of the battery voltage will be printed through the serial port, as shown below:
80
+
* After flashing, power on the board to run the example.
81
+
* The **blue indicator LED** blinks every 500 ms, indicating normal system operation.
82
+
* ADC samples battery voltage and prints results to the serial port as shown below:
37
83
38
84
```
39
85
Value is: 3.123 V
@@ -43,22 +89,22 @@ During operation, the blue indicator LED blinks periodically, indicating that th
43
89
44
90
## Notes
45
91
46
-
* To modify the project’s **graphical configuration**, open the configuration file with the following tool:
92
+
* To modify the **graphical configuration** of the project, open the configuration file using the following tool:
* After making changes, save the configuration and regenerate the code.
53
99
54
-
## Boot Process
100
+
## Boot Sequence
55
101
56
102
The system boot sequence is as follows:
57
103
58
104
```
59
105
+------------------+
60
106
| Secure M33 |
61
-
| (Secure Core) |
107
+
| (Secure Core) |
62
108
+------------------+
63
109
|
64
110
v
@@ -74,12 +120,12 @@ The system boot sequence is as follows:
74
120
+-------------------+
75
121
```
76
122
77
-
⚠️ Please strictly follow the above flashing sequence; otherwise, the system may fail to run properly.
123
+
⚠️ Please strictly follow the boot sequence above when flashing firmware, or the system may fail to start properly.
78
124
79
125
---
80
126
81
-
* If the example project does not run properly, it is recommended to first build and flash the **Edgi-Talk_M33_S_Template** project to ensure that the initialization and core startup process works correctly before running this example.
82
-
* To enable the M55 core, open the configuration in the **M33 project**:
127
+
* If the example project does not run correctly, compile and flash the **Edgi-Talk_M33_S_Template** project first to ensure proper initialization and core startup sequence before running this example.
128
+
* To enable the M55 core, configure the **M33 project** as follows:
Copy file name to clipboardExpand all lines: projects/Edgi-Talk_AHT20/Edgi_Talk_M33_AHT20/README.md
+48-19Lines changed: 48 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,35 +1,64 @@
1
1
# Edgi-Talk_M33_AHT20 Example Project
2
2
3
+
[**中文**](./README_zh.md) | **English**
4
+
3
5
## Introduction
4
6
5
7
This example project is based on the **Edgi-Talk platform** and demonstrates how to drive and use the **AHT20 temperature and humidity sensor**.
6
-
Through this project, users can quickly experience AHT20 data acquisition and processing, and view the sampled results via the serial terminal on the development board.
8
+
Through this project, users can quickly experience AHT20 data acquisition and processing, and view the sampled results via the serial port on the development board.
9
+
10
+
### AHT10 Software Package Overview
11
+
12
+
The AHT10 software package provides basic functions for using the AHT10 temperature and humidity sensor, and also includes an optional software-based moving average filter.
13
+
For more details, please refer to the README file in the AHT10 software package.
14
+
15
+
## Hardware Description
16
+
17
+
### Sensor Connection Interface
18
+
19
+
20
+
21
+
### Level Shifting
22
+
23
+
24
+
25
+
### BTB Connector
26
+
27
+
28
+
29
+
### MCU Pins
30
+
31
+
32
+
33
+
### Physical Board Location
34
+
35
+
7
36
8
37
## Software Description
9
38
10
39
* The project is developed based on the **Edgi-Talk** platform.
11
40
12
-
*The example includes the following features:
41
+
*Example functionalities include:
13
42
14
43
* AHT20 initialization and communication via I²C
15
-
* Temperature and humidity data reading and parsing
16
-
*Serial printing of sampled data
44
+
* Temperature and humidity data acquisition and parsing
45
+
*Displaying sampled data via serial output
17
46
18
-
* The project structure is clear, making it easy for users to understand I²C driver implementation and sensor interfacing.
47
+
* The project has a clear structure, helping users understand I²C driver usage and sensor interfacing.
19
48
20
49
## Usage Instructions
21
50
22
51
### Compilation and Download
23
52
24
-
1. Open the project and complete the build process.
25
-
2. Connect the development boardto the PC via the **onboard DAP downloader (USB interface)**.
26
-
3. Use a programming tool to flash the generated firmware onto the development board.
53
+
1. Open the project and complete the compilation.
54
+
2. Connect the board’s USB port to the PC using the **onboard debugger (DAP)**.
55
+
3. Use the programming tool to flash the generated firmware onto the development board.
27
56
28
-
### Running Results
57
+
### Runtime Behavior
29
58
30
-
* After flashing, power on the development board to run the example project.
31
-
* The system will initialize the AHT20 and start sampling temperature and humidity data.
32
-
* The sampling results will be printed through the serial terminal, as shown below:
59
+
* After flashing, power on the board to run the example project.
60
+
* The system will initialize the AHT20 sensor and begin sampling temperature and humidity data.
61
+
* The sampled data will be printed via the serial terminal, as shown below:
33
62
34
63
```
35
64
\ | /
@@ -47,23 +76,23 @@ msh >[I/aht10] AHT10 has been initialized!
47
76
48
77
## Notes
49
78
50
-
* To modify the project’s **graphical configuration**, open the configuration file using the following tool:
79
+
* To modify the **graphical configuration** of the project, open the configuration file using the following tool:
* After making changes, save the configuration and regenerate the code.
86
+
* After editing, save the configuration and regenerate the code.
58
87
59
-
## Boot Process
88
+
## Boot Sequence
60
89
61
90
The system boot sequence is as follows:
62
91
63
92
```
64
93
+------------------+
65
94
| Secure M33 |
66
-
| (Secure Core) |
95
+
| (Secure Core) |
67
96
+------------------+
68
97
|
69
98
v
@@ -79,12 +108,12 @@ The system boot sequence is as follows:
79
108
+-------------------+
80
109
```
81
110
82
-
⚠️ Please strictly follow the above flashing sequence; otherwise, the system may fail to run properly.
111
+
⚠️ Please strictly follow the boot sequence above when flashing firmware; otherwise, the system may fail to start properly.
83
112
84
113
---
85
114
86
-
* If the example project does not run properly, it is recommended to first build and flash the **Edgi-Talk_M33_S_Template** project to ensure the initialization and core startup process works correctly before running this example.
87
-
* To enable the M55 core, open the configuration in the **M33 project**:
115
+
* If the example project does not run correctly, compile and flash the **Edgi-Talk_M33_S_Template** project first to ensure proper initialization and core startup sequence before running this example.
116
+
* To enable the M55 core, configure the **M33 project** as follows:
0 commit comments