Skip to content

Commit e777211

Browse files
committed
fix: typo raised by codespell
Signed-off-by: Frederic Pillon <[email protected]>
1 parent 18a492c commit e777211

File tree

9 files changed

+54
-37
lines changed

9 files changed

+54
-37
lines changed

HardwareTimer-library.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Each timer may provide several channels, nevertheless it is important to underst
4646
void setOverflow(uint32_t val, TimerFormat_t format = TICK_FORMAT); // set AutoReload register depending on format provided
4747
uint32_t getOverflow(TimerFormat_t format = TICK_FORMAT); // return overflow depending on format provided
4848

49-
void setPWM(uint32_t channel, PinName pin, uint32_t frequency, uint32_t dutycycle, callback_function_t PeriodCallback = nullptr, callback_function_t CompareCallback = nullptr); // Set all in one command freq in HZ, Duty in percentage. Including both interrup.
49+
void setPWM(uint32_t channel, PinName pin, uint32_t frequency, uint32_t dutycycle, callback_function_t PeriodCallback = nullptr, callback_function_t CompareCallback = nullptr); // Set all in one command freq in HZ, Duty in percentage. Including both interrupt.
5050
void setPWM(uint32_t channel, uint32_t pin, uint32_t frequency, uint32_t dutycycle, callback_function_t PeriodCallback = nullptr, callback_function_t CompareCallback = nullptr);
5151

5252
void setCount(uint32_t val, TimerFormat_t format = TICK_FORMAT); // set timer counter to value 'val' depending on format provided
@@ -74,12 +74,12 @@ Each timer may provide several channels, nevertheless it is important to underst
7474
bool hasInterrupt(uint32_t channel); //returns true if an interrupt has already been set on the channel compare match
7575
void timerHandleDeinit(); // Timer deinitialization
7676

77-
// Refresh() is usefull while timer is running after some registers update
77+
// Refresh() is useful while timer is running after some registers update
7878
void refresh(void); // Generate update event to force all registers (Autoreload, prescaler, compare) to be taken into account
7979

8080
uint32_t getTimerClkFreq(); // return timer clock frequency in Hz.
8181

82-
static void captureCompareCallback(TIM_HandleTypeDef *htim); // Generic Caputre and Compare callback which will call user callback
82+
static void captureCompareCallback(TIM_HandleTypeDef *htim); // Generic Capture and Compare callback which will call user callback
8383
static void updateCallback(TIM_HandleTypeDef *htim); // Generic Update (rollover) callback which will call user callback
8484

8585
// The following function(s) are available for more advanced timer options

Libraries.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ or have a look hereafter to see which one is available:
3030

3131
## Dedicated
3232

33-
Some libraries have been developped to support specific features (hardware or not):
33+
Some libraries have been developed to support specific features (hardware or not):
3434

3535
* [STM32Ethernet](https://github.com/stm32duino/STM32Ethernet): for on board Ethernet port (ex: Nucleo-F429ZI). This library is fully compatible with Arduino [Ethernet](https://www.arduino.cc/en/Reference/Ethernet) API. It depends on the following libraries:
3636
* [LwIP](https://github.com/stm32duino/LwIP): lightweight TCP/IP stack (LwIP) is a small independent implementation of the TCP/IP protocol suite
@@ -52,9 +52,9 @@ Some libraries have been developped to support specific features (hardware or no
5252
* [LIS2MDL](https://github.com/stm32duino/LIS2MDL): to support the LIS2MDL high-performance 3-axis magnetometer
5353
* [LIS3DHH](https://github.com/stm32duino/LIS3DHH): to support the LIS3DHH 3D accelerometer
5454
* [LIS3MDL](https://github.com/stm32duino/LIS3MDL): to support the LIS3MDL high-performance 3-axis magnetometer. Dedicated [[Wiki page|LIS3MDL]]
55-
* [LPS22HB](https://github.com/stm32duino/LPS22HB): to support the LPS22HB 260-1260 hPa absolute digital ouput barometer. Dedicated [[Wiki page|LPS22HB]]
56-
* [LPS25HB](https://github.com/stm32duino/LPS25HB): to support the LPS25HB 260-1260 hPa absolute digital ouput barometer
57-
* [LPS22HH](https://github.com/stm32duino/LPS22HH): to support the LPS22HH 260-1260 hPa absolute digital ouput barometer
55+
* [LPS22HB](https://github.com/stm32duino/LPS22HB): to support the LPS22HB 260-1260 hPa absolute digital output barometer. Dedicated [[Wiki page|LPS22HB]]
56+
* [LPS25HB](https://github.com/stm32duino/LPS25HB): to support the LPS25HB 260-1260 hPa absolute digital output barometer
57+
* [LPS22HH](https://github.com/stm32duino/LPS22HH): to support the LPS22HH 260-1260 hPa absolute digital output barometer
5858
* [LSM303AGR](https://github.com/stm32duino/LSM303AGR): to support the LSM303AGR 3D accelerometer and 3D magnetometer
5959
* [LSM6DSO](https://github.com/stm32duino/LSM6DSO): to support the LSM6DSO 3D accelerometer and 3D gyroscope
6060
* [LSM6DSOX](https://github.com/stm32duino/LSM6DSOX): to support the LSM6DSOX 3D accelerometer and 3D gyroscope

Upload-methods.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ The `hid-flash` tool is available on Windows, Linux and MacOS.
161161

162162
Details of HID bootloader v2.2 (and newer) hid-flash tool as well as ready-to-use binary files can be found at the GitHub repository: https://github.com/Serasidis/STM32_HID_Bootloader
163163

164-
[[/img/Warning-icon.png|alt="Warning"]] **USB CDC have to be enable else you will not be able to upload automatically as bootloader reset sequence are manged through the USB CDC communication port.**
164+
[[/img/Warning-icon.png|alt="Warning"]] **USB CDC have to be enable else you will not be able to upload automatically as bootloader reset sequence are managed through the USB CDC communication port.**
165165

166166
## Maple DFU Bootloader
167167

@@ -186,7 +186,7 @@ Details about the STM32duino-bootloader as well as ready to use binary files can
186186
* Maple bootloader 2.0 consumes 8KB of flash.
187187
* Maple bootloader original consumes 20kb of flash and some of the SRAM.
188188

189-
[[/img/Warning-icon.png|alt="Warning"]] **USB CDC have to be enable else you will not be able to upload automatically as bootloader reset sequence are manged through the USB CDC communication port.**
189+
[[/img/Warning-icon.png|alt="Warning"]] **USB CDC have to be enable else you will not be able to upload automatically as bootloader reset sequence are managed through the USB CDC communication port.**
190190

191191

192192
[Discovery]: https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-mpu-eval-tools/stm32-mcu-mpu-eval-tools/stm32-discovery-kits.html

_cmake/Functions-reference.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,8 @@ This is the main function that encapsulates most of the automation of Arduino. I
3535
- `targetName` is the name of the [binary target](https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html#binary-executables) that will be created as a result of this function; this is a handle that may be reused in later calls, to e.g., `insights()`.
3636
- `sourcefile...` is a list of sources files to be compiled. This does not comprise header files (`.h`).
3737
You are strongly advised to hard-code the list of files directly in the CMakeLists.txt. Using [wildcards](https://cmake.org/cmake/help/latest/command/file.html#glob) is possible, but not guaranteed to work in all cases.
38-
- the optional `dependencies` are targets, usually Arduino libraries such as created by `external_library()`, that the sketch depdends on.
39-
The CMake build model makes it awkward at best to automatically handle dependencies the way Arduino does, so they have to be specified explicitely.
38+
- the optional `dependencies` are targets, usually Arduino libraries such as created by `external_library()`, that the sketch dedends on.
39+
The CMake build model makes it awkward at best to automatically handle dependencies the way Arduino does, so they have to be specified explicitly.
4040

4141
What this function does is the following:
4242

@@ -94,8 +94,8 @@ insights(TARGET <targetName>
9494

9595
This function lets you produce insights about the build process.
9696
It uses Graphviz to generate SVG files in order to better understand what happens throughout the build: configuration, compilation, linking.
97-
The mandatory TARGET argument is the name of the element to analyze, usually your sketch target (crated with `build_sketch()`).
98-
Each insight keyword is optional; even when provided, they are not built by default, you have to explicitely generate them with the build tool (e.g., `ninja symbols.svg`).
97+
The mandatory TARGET argument is the name of the element to analyze, usually your sketch target (created with `build_sketch()`).
98+
Each insight keyword is optional; even when provided, they are not built by default, you have to explicitly generate them with the build tool (e.g., `ninja symbols.svg`).
9999

100100
| Keyword | Generated file | Description |
101101
| :------ | :------------- | :---------- |

_cmake/Introduction-to-CMake.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Both these kinds of files are written using CMake's own language; cf. below.
1616
Whatever the user interface (system shell, cmake-gui, IDE, ...), there always are two main steps: configuration and build.
1717
- In the __configuration step__, CMake reads the build description (CMakeLists.txt) and generates files for the build tool to use (e.g., `Makefile` or `build.ninja`).
1818
- In the __build step__, the build tool is called, either directly or indirectly, to perform the build and generate the required build artifacts.
19-
In case CMake needs to be re-run (maybe because one of the CMakeLists.txt has been edited), this is handled automatically without requiring the user to go through another configuration step. This means the _configuration step needs only to be invoked once_ explicitely, even when rebuilding an updated project.
19+
In case CMake needs to be re-run (maybe because one of the CMakeLists.txt has been edited), this is handled automatically without requiring the user to go through another configuration step. This means the _configuration step needs only to be invoked once_ explicitly, even when rebuilding an updated project.
2020

2121
CMake projects are usually built "out-of-source", meaning the build artifacts end up in a parallel directory tree,
2222
as opposed to "in-source" builds, where they are mixed with the source files.
@@ -40,7 +40,7 @@ The syntax of the CMake language is very simple: the only statement is the funct
4040
You may want to read [the CMake tutorial](https://cmake.org/cmake/help/latest/guide/tutorial/index.html) to get a comprehensive overview of the features CMake offers.
4141

4242
For a detailed list of the functions this project provides, please refer to [[Functions reference]].
43-
Below is an introduction to general-purpose CMake; most of it is abstracted away in said funtions.
43+
Below is an introduction to general-purpose CMake; most of it is abstracted away in said functions.
4444

4545
Here are some key points about the structure of a `CMakeLists.txt` (Also read [the documentation](https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html)):
4646
- The main file must start with a call to [`cmake_minimum_required()`](https://cmake.org/cmake/help/latest/command/cmake_minimum_required.html), to make sure the version of CMake meets the expectations;

_cmake/Quickstart-guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ optional arguments:
5353
--cli CLI, -x CLI path to arduino-cli
5454
--board BOARD, -b BOARD
5555
board name
56-
--fire lauch the build immediately (use with caution!)
56+
--fire launch the build immediately (use with caution!)
5757
--output OUTPUT, -o OUTPUT
5858
output file (CMake) with placeholders
5959
--sketch SKETCH, -s SKETCH

_cmake/Setup.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ We demand version >= 3.9. Please browse the official [Python download page](http
2929

3030
These are available on [PyPi](https://pypi.org/), meaning you can install them with `pip install <package>`. When using third-party modules, in order not to impact any other project you may be working on, it is customary (but not mandatory!) to set up a [virtual environment](https://packaging.python.org/en/latest/tutorials/installing-packages/#creating-virtual-environments) (Look up `virtualenv`, `virtualenvwrapper` on PyPi for more information on this process).
3131

32-
The following modules are used througout the project:
32+
The following modules are used throughout the project:
3333
- `jinja2`, a templating engine to autogenerate some CMake configuration files.
3434
- `graphviz`, a rendering engine to generate graphs as insights into the project
3535

_dev/How-to-debug.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ Two standard tools are required in order to debug the code:
105105

106106
### 3.2 Setting up debug configuration
107107

108-
If you are using sloeber directly, not CDT with the plugin. The you probaly will not find the below mentiones menue "Debug Configurations" under "Run". This is, because you are in the arduino view. In this view, all "unneccessary" menues are hidden. To overcome this, you can change the view:
108+
If you are using sloeber directly, not CDT with the plugin. The you probably will not find the below mentioned menu "Debug Configurations" under "Run". This is, because you are in the arduino view. In this view, all "unnecessary" menus are hidden. To overcome this, you can change the view:
109109

110110
You can choose the regular C/C++ view.
111111
Alternatively you can also reach the debug configurations menu by right-click on your project under the arduino view.

_libs/_dedicated/VL53L0X.md

Lines changed: 36 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -9,20 +9,23 @@ directional (left/right) swipe gesture detection and single tap gesture detectio
99

1010
### VL53L0X class
1111

12-
* **VL53L0X(TwoWire\*, int, int, uint8_t)**: class constructor
12+
* **VL53L0X(TwoWire\*, int, int, uint8_t)**: class constructor
13+
1314
_Params_ pointer to I2C instance
1415
_Params_ sensor shutdown pin
1516
_Params_ sensor interrupt pin
1617
_Params_ (optional) device address (0x29 by default)
1718

18-
* **VL53L0X_On**: power on the sensor
19+
* **VL53L0X_On**: power on the sensor
20+
21+
* **VL53L0X_Off**: power off the sensor
1922

20-
* **VL53L0X_Off**: power off the sensor
23+
* **InitSensor**: initialize the sensor with default values
2124

22-
* **InitSensor**: initialize the sensor with default values
2325
_Return_ 0 on Success, error code otherwise
2426

25-
* **StartMeasurementSimplified(OperatingMode, void(*)(void))**: Start the measure indicated by operating mode
27+
* **StartMeasurementSimplified(OperatingMode, void(*)(void))**: Start the measure indicated by operating mode
28+
2629
_Params_ specifies requested measure (range_single_shot_polling,
2730
range_continuous_polling,
2831
range_continuous_interrupt,
@@ -35,7 +38,8 @@ _Params_ specifies requested measure (range_single_shot_polling,
3538
_Params_ pointer to callback function. Must be not NULL in case of interrupt measure
3639
_Return_ 0 on Success, error code otherwise
3740

38-
* **GetMeasurementSimplified(OperatingMode, VL53L0X_RangingMeasurementData_t\*)**: Get results for the measure indicated by operating mode
41+
* **GetMeasurementSimplified(OperatingMode, VL53L0X_RangingMeasurementData_t\*)**: Get results for the measure indicated by operating mode
42+
3943
_Params_ specifies requested measure (range_single_shot_polling,
4044
range_continuous_polling,
4145
range_continuous_interrupt,
@@ -48,7 +52,8 @@ _Params_ specifies requested measure (range_single_shot_polling,
4852
_Params_ Data pointer to the MeasureData_t structure to read data in to
4953
_Return_ 0 on Success, error code otherwise
5054

51-
* **StopMeasurementSimplified(OperatingMode)**: Stop the currently running measure indicate by operating_mode
55+
* **StopMeasurementSimplified(OperatingMode)**: Stop the currently running measure indicate by operating_mode
56+
5257
_Params_ specifies requested measure (range_single_shot_polling,
5358
range_continuous_polling,
5459
range_continuous_interrupt,
@@ -60,17 +65,21 @@ _Params_ specifies requested measure (range_single_shot_polling,
6065
range_continuous_interrupt_out_of_window)
6166
_Return_ 0 on Success, error code otherwise
6267

63-
* **WaitDeviceBooted**: Wait for device booted after chip enable (hardware standby)
68+
* **WaitDeviceBooted**: Wait for device booted after chip enable (hardware standby)
69+
6470
_Return_ 0 on Success, error code otherwise
6571

66-
* **Prepare**: Prepare device for operation. Does static initialization and reprogram common default setting.
72+
* **Prepare**: Prepare device for operation. Does static initialization and reprogram common default setting.
73+
6774
_Return_ 0 on Success, error code otherwise
6875

69-
* **GetDistance(uint32_t\*)**: Get ranging result and only that
76+
* **GetDistance(uint32_t\*)**: Get ranging result and only that
77+
7078
_Params_ pointer to range distance (value in millimeter)
7179
_Return_ 0 on Success, error code otherwise
7280

73-
* **SetDeviceAddress(int)**: Set new device i2c address
81+
* **SetDeviceAddress(int)**: Set new device i2c address
82+
7483
_Params_ The new i2c address (7bit)
7584
_Return_ 0 on Success, error code otherwise
7685

@@ -89,43 +98,51 @@ _You can find a complete description of the following functions in the API user
8998

9099
### ToF gestures
91100

92-
* **tof_gestures_initDIRSWIPE_1(int32_t, long, long, Gesture_DIRSWIPE_1_Data_t\*)**: Initialize directional (left/right) gesture dectection
101+
* **tof_gestures_initDIRSWIPE_1(int32_t, long, long, Gesture_DIRSWIPE_1_Data_t\*)**: Initialize directional (left/right) gesture detection
102+
93103
_Params_ swipe threshold
94104
_Params_ Minimum duration of a swipe to be detected
95105
_Params_ Maximum duration of a swipe to be detected
96106
_Params_ pointer to Gesture_DIRSWIPE_1_Data_t structure
97107
_Return_ 0 on Success, error code otherwise
98108

99-
* **tof_gestures_detectDIRSWIPE_1(int32_t, int32_t, Gesture_DIRSWIPE_1_Data_t\*)**: Detect directional (left/right) gesture
109+
* **tof_gestures_detectDIRSWIPE_1(int32_t, int32_t, Gesture_DIRSWIPE_1_Data_t\*)**: Detect directional (left/right) gesture
110+
100111
_Params_ left range value in millimeter
101112
_Params_ right range value in millimeter
102113
_Params_ pointer to Gesture_DIRSWIPE_1_Data_t structure
103114
_Return_ One of these gestures code: GESTURES_SWIPE_LEFT_RIGHT, GESTURES_SWIPE_RIGHT_LEFT, GESTURES_NULL, GESTURES_DISCARDED_TOO_SLOW or GESTURES_DISCARDED_TOO_FAST
104115

105-
* **tof_gestures_initSWIPE_1(Gesture_SWIPE_1_Data_t\*)**: Initialize single swipe gesture dectection
116+
* **tof_gestures_initSWIPE_1(Gesture_SWIPE_1_Data_t\*)**: Initialize single swipe gesture detection
117+
106118
_Params_ pointer to Gesture_SWIPE_1_Data_t structure
107119
_Return_ 0 on Success, error code otherwise
108120

109-
* **tof_gestures_detectSWIPE_1(int32_t, Gesture_SWIPE_1_Data_t\*)**: Detect single swipe gesture
121+
* **tof_gestures_detectSWIPE_1(int32_t, Gesture_SWIPE_1_Data_t\*)**: Detect single swipe gesture
122+
110123
_Params_ range value in millimeter
111124
_Params_ pointer to Gesture_SWIPE_1_Data_t structure
112125
_Return_ One of these gestures code: GESTURES_HAND_ENTERING, GESTURES_HAND_LEAVING, GESTURES_SINGLE_SWIPE or GESTURES_NULL, GESTURES_DISCARDED, GESTURES_DISCARDED_TOO_SLOW
113126

114-
* **tof_gestures_initTAP_1(Gesture_TAP_1_Data_t\*)**: Initialize single tap gesture dectection
127+
* **tof_gestures_initTAP_1(Gesture_TAP_1_Data_t\*)**: Initialize single tap gesture detection
128+
115129
_Params_ pointer to Gesture_TAP_1_Data_t structure
116130
_Return_ 0 on Success, error code otherwise
117131

118-
* **tof_gestures_detectTAP_1(int32_t, Gesture_TAP_1_Data_t\*)**: Detect single tap gesture
132+
* **tof_gestures_detectTAP_1(int32_t, Gesture_TAP_1_Data_t\*)**: Detect single tap gesture
133+
119134
_Params_ range value in millimeter
120135
_Params_ pointer to Gesture_TAP_1_Data_t structure
121136
_Return_ One of these gestures code: GESTURES_SINGLE_TAP or GESTURES_NULL
122137

123-
* **tof_initMotion(int, MotionData_t\*)**: Initialize motion dectector
138+
* **tof_initMotion(int, MotionData_t\*)**: Initialize motion detector
139+
124140
_Params_ range threshold
125141
_Params_ pointer to MotionData_t structure
126142
_Return_ 0 on Success, error code otherwise
127143

128-
* **tof_getMotion(int32_t, MotionData_t\*)**: return current motion state
144+
* **tof_getMotion(int32_t, MotionData_t\*)**: return current motion state
145+
129146
_Params_ range value in millimeter
130147
_Params_ pointer to MotionData_t structure
131148
_Return_ One of these gestures code: GESTURES_MOTION_NULL, GESTURES_MOTION_DOWN_STATE, GESTURES_MOTION_UP_STATE, GESTURES_MOTION_RAISE_UP or GESTURES_MOTION_DROP_DOWN

0 commit comments

Comments
 (0)