Skip to content

Commit b144f85

Browse files
pedromsousalimapedromsousalima
committed
Requested changes
Added requested initial changes
1 parent cbc9952 commit b144f85

File tree

14 files changed

+414
-271
lines changed

14 files changed

+414
-271
lines changed

‎content/hardware/11.accessories/modulino-nodes/modulino-buttons/tutorials/how-buttons-ardu/how-to-buttons-ardu.md

Lines changed: 39 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,20 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc
1919

2020
Pressing a button pulls the signal LOW, and each button has an onboard pull-up resistor. The LEDs can be controlled independently through the onboard microcontroller.
2121

22+
23+
# General Characteristics
24+
2225
The **Modulino Buttons** module uses three tactile buttons and LEDs, which do not have native I²C capabilities. Instead, the buttons and LEDs are controlled by the Modulino's onboard microcontroller (STM32C011F4U6TR). This microcontroller provides I²C communication, allowing for flexible reading of button states and control of the LEDs. One unique feature of this setup is the ability to change the I²C address via software. This means the address can be modified based on your application needs, making it adaptable to different system configurations.
2326

27+
| Specification | Details |
28+
|-------------------|-----------------------------|
29+
| Buttons | 3 × Tactile pushbuttons |
30+
| LEDs | 3 × Indicator LEDs (orange) |
31+
| Power Supply | 3.3 V |
32+
| Interface | UART, SWD, I2C |
33+
| Pull-up Resistors | Integrated on button inputs |
34+
35+
2436
The default I²C address for the **Modulino Buttons** module is:
2537

2638
| Modulino I²C Address | Hardware I²C Address | Editable Addresses (HEX) |
@@ -36,25 +48,31 @@ The tactile buttons and LEDs are the core components of this module. These input
3648

3749
![Arduino Buttons Pinout](assets/ButtonsPinouts.png)
3850

39-
### Input/Output Headers
40-
41-
| Pin | Function |
42-
|----------|-----------------|
43-
| Button A | Button A Signal |
44-
| Button B | Button B Signal |
45-
| Button C | Button C Signal |
46-
| RX1 | UART Receive |
47-
| TX1 | UART Transmit |
48-
| SWDIO | SWD Data |
49-
| SWCLK | SWD Clock |
50-
| PF2 | NRST |
51-
52-
- **Button A/B/C** – These pins connect directly to the three tactile buttons on the board.
53-
- **RX1: UART Receive** – Used for receiving data over UART communication.
54-
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
55-
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
51+
### 1x10 Header
52+
53+
| Pin | Function |
54+
|-------|----------------|
55+
| A | Button A |
56+
| GND | Ground |
57+
| 3V3 | 3.3 V Power |
58+
| PF2 | RESET |
59+
| SWCLK | SWD Clock |
60+
| SWDIO | SWD Data |
61+
| TX1 | USART Transmit |
62+
| RX1 | USART Receive |
63+
| B | Button B |
64+
| C | Button C |
65+
66+
- **A: Button A** – This pin connects directly to button A.
67+
- **GND: Ground** – Ground connection for power and signal reference.
68+
- **3V3: Power** – 3.3 V power supply input.
69+
- **PF2: RESET** – The reset pin for the microcontroller, which can be used to reset the system.
5670
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
57-
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.
71+
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
72+
- **TX1: USART Transmit** – Used for transmitting data over UART communication.
73+
- **RX1: USART Receive** – Used for receiving data over UART communication.
74+
- **B: Button B** – This pin connects directly to button B.
75+
- **C: Button C** – This pin connects directly to button C.
5876

5977
### 1x4 Header (I2C)
6078

@@ -73,10 +91,10 @@ The board is typically powered by +3.3 VDC when using the QWIIC interface as per
7391

7492
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
7593
|------------------|-------------------|---------|-------------|---------|------|
76-
| Supply Voltage | - | 2.3 | 3.3 (QWIIC) | 3.6 | V |
77-
| LED Current Draw | Single LED Active | - | 2.5 | - | mA |
94+
| Supply Voltage | - | - | 3.3 (QWIIC) | - | V |
95+
| LED Current Draw | Single LED Active (A,B or C) | - | 2.5 | - | mA |
7896

79-
The module includes a power LED that draws 1 mA and turns on as soon as it is powered. J1 (Qwiic connector), J2 (Qwiic connector), and the headers all share the same power branch. The power distribution of the module is therefore as follows:
97+
The module additionally includes a power LED that draws 1 mA and turns on as soon as it is powered. J1 (Qwiic connector), J2 (Qwiic connector), and the headers all share the same power branch. The power distribution of the module is therefore as follows:
8098

8199
![Power Tree Modulino Buttons](assets/Modulino_Buttons_Power_Tree.png)
82100

‎content/hardware/11.accessories/modulino-nodes/modulino-buttons/tutorials/how-buttons-mp/how-to-buttons-mp.md

Lines changed: 39 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,20 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc
1919

2020
Pressing a button pulls the signal LOW, and each button has an onboard pull-up resistor. The LEDs can be controlled independently through the onboard microcontroller.
2121

22+
23+
# General Characteristics
24+
2225
The **Modulino Buttons** module uses three tactile buttons and LEDs, which do not have native I²C capabilities. Instead, the buttons and LEDs are controlled by the Modulino's onboard microcontroller (STM32C011F4U6TR). This microcontroller provides I²C communication, allowing for flexible reading of button states and control of the LEDs. One unique feature of this setup is the ability to change the I²C address via software. This means the address can be modified based on your application needs, making it adaptable to different system configurations.
2326

27+
| Specification | Details |
28+
|-------------------|-----------------------------|
29+
| Buttons | 3 × Tactile pushbuttons |
30+
| LEDs | 3 × Indicator LEDs (orange) |
31+
| Power Supply | 3.3 V |
32+
| Interface | UART, SWD, I2C |
33+
| Pull-up Resistors | Integrated on button inputs |
34+
35+
2436
The default I²C address for the **Modulino Buttons** module is:
2537

2638
| Modulino I²C Address | Hardware I²C Address | Editable Addresses (HEX) |
@@ -36,25 +48,31 @@ The tactile buttons and LEDs are the core components of this module. These input
3648

3749
![Arduino Buttons Pinout](assets/ButtonsPinouts.png)
3850

39-
### Input/Output Headers
40-
41-
| Pin | Function |
42-
|----------|-----------------|
43-
| Button A | Button A Signal |
44-
| Button B | Button B Signal |
45-
| Button C | Button C Signal |
46-
| RX1 | UART Receive |
47-
| TX1 | UART Transmit |
48-
| SWDIO | SWD Data |
49-
| SWCLK | SWD Clock |
50-
| PF2 | NRST |
51-
52-
- **Button A/B/C** – These pins connect directly to the three tactile buttons on the board.
53-
- **RX1: UART Receive** – Used for receiving data over UART communication.
54-
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
55-
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
51+
### 1x10 Header
52+
53+
| Pin | Function |
54+
|-------|----------------|
55+
| A | Button A |
56+
| GND | Ground |
57+
| 3V3 | 3.3 V Power |
58+
| PF2 | RESET |
59+
| SWCLK | SWD Clock |
60+
| SWDIO | SWD Data |
61+
| TX1 | USART Transmit |
62+
| RX1 | USART Receive |
63+
| B | Button B |
64+
| C | Button C |
65+
66+
- **A: Button A** – This pin connects directly to button A.
67+
- **GND: Ground** – Ground connection for power and signal reference.
68+
- **3V3: Power** – 3.3 V power supply input.
69+
- **PF2: RESET** – The reset pin for the microcontroller, which can be used to reset the system.
5670
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
57-
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.
71+
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
72+
- **TX1: USART Transmit** – Used for transmitting data over UART communication.
73+
- **RX1: USART Receive** – Used for receiving data over UART communication.
74+
- **B: Button B** – This pin connects directly to button B.
75+
- **C: Button C** – This pin connects directly to button C.
5876

5977
### 1x4 Header (I2C)
6078

@@ -73,10 +91,10 @@ The board is typically powered by +3.3 VDC when using the QWIIC interface as per
7391

7492
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
7593
|------------------|-------------------|---------|-------------|---------|------|
76-
| Supply Voltage | - | 2.3 | 3.3 (QWIIC) | 3.6 | V |
77-
| LED Current Draw | Single LED Active | - | 2.5 | - | mA |
94+
| Supply Voltage | - | - | 3.3 (QWIIC) | - | V |
95+
| LED Current Draw | Single LED Active (A,B or C) | - | 2.5 | - | mA |
7896

79-
The module includes a power LED that draws 1 mA and turns on as soon as it is powered. J1 (Qwiic connector), J2 (Qwiic connector), and the headers all share the same power branch. The power distribution of the module is therefore as follows:
97+
The module additionally includes a power LED that draws 1 mA and turns on as soon as it is powered. J1 (Qwiic connector), J2 (Qwiic connector), and the headers all share the same power branch. The power distribution of the module is therefore as follows:
8098

8199
![Power Tree Modulino Buttons](assets/Modulino_Buttons_Power_Tree.png)
82100

‎content/hardware/11.accessories/modulino-nodes/modulino-buzzer/tutorials/how-buzzer-ardu/content.md

Lines changed: 31 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,10 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc
2020

2121
The Modulino Buzzer based on the buzzer (PKLCS1212E4001-R1) is capable of generating different tones and sound patterns. Take a look at the following table to know more about its characteristics:
2222

23-
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
24-
|----------------------|-------------------|---------|---------|---------|------|
25-
| Frequency Range | - | 2,000 | - | 4,000 | Hz |
26-
| Resonant Frequency | - | 2,400 | 2,700 | 3,000 | Hz |
27-
| Sound Pressure Level | @ 2.7 kHz, 3.3Vpp | - | 75 | - | dB |
23+
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
24+
|----------------------|-----------|---------|---------|---------|------|
25+
| Frequency | - | - | 4,000 | - | Hz |
26+
| Sound Pressure Level | - | 75 | 85 | - | dB |
2827

2928
## Sensor Details
3029

@@ -49,23 +48,29 @@ The PKLCS1212E4001-R1 buzzer is the core component of this module. This audio ou
4948

5049
![Arduino Buzzer Pinout](assets/BuzzerPinouts.png)
5150

52-
### 1x6 Header (LSM6DSOXTR)
53-
| Pin | Function |
54-
|-------|---------------|
55-
| PA0 | Buzzer Signal |
56-
| RX1 | UART Receive |
57-
| TX1 | UART Transmit |
58-
| SWDIO | SWD Data |
59-
| SWCLK | SWD Clock |
60-
| PF2 | NRST |
61-
62-
- **PA0: Buzzer Signal** – This pin is used to control the buzzer's output signal. In fact, this pin can be used to bypass the I²C interface and control the buzzer directly using a square wave.
51+
### 1x8 Header
52+
53+
| Pin | Function |
54+
|--------|-----------------|
55+
| GND | Ground |
56+
| 3V3 | 3.3V Power |
57+
| RESET | Reset |
58+
| SWCLK | SWD Clock |
59+
| SWDIO | SWD Data |
60+
| TX1 | USART Transmit |
61+
| RX1 | USART Receive |
62+
| PA0 | Buzzer |
63+
64+
- **GND:** Provides ground reference for the circuit.
65+
- **3V3:** Supplies 3.3 V power to connected components and modules.
66+
- **Reset:** The reset pin for the microcontroller, which can be used to reset the system.
67+
- **SWCLK:** Used for providing the clock signal in the SWD interface.
68+
- **SWDIO:** Used for debugging, as part of the Serial Wire Debug (SWD) interface.
69+
- **TX1:** Used for transmitting data over UART communication.
70+
- **RX1:** Used for receiving data over UART communication.
71+
- **PA0:** This pin is used to control the buzzer's output signal. In fact, this pin can be used to bypass the I²C interface and control the buzzer directly using a square wave.
6372
![Direct control via signal](assets/buzzerPA0.gif)
64-
- **RX1: UART Receive** – Used for receiving data over UART communication.
65-
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
66-
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
67-
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
68-
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.
73+
6974

7075
### 1x4 Header (I2C)
7176
The pinout for the Modulino Buzzer is shown below. While the recommended connection method is via the QWIIC connectors, this solderable header provides a connection option when using the modulino with a non-QWIIC compatible board.
@@ -82,12 +87,12 @@ The pinout for the Modulino Buzzer is shown below. While the recommended connect
8287

8388
The board is typically powered by +3.3 VDC when using the QWIIC interface as per the I²C standard.
8489

85-
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
86-
|---------------------|-----------------|---------|---------|---------|------|
87-
| Operating Voltage | - | 2.5 | 3.3 | 3.6 | V |
88-
| Current Consumption | @ 3.3V, 2.7 kHz | - | 120 | - | μA |
90+
| Parameter | Condition | Typical | Unit |
91+
|---------------------|-----------|---------|------|
92+
| Operating Voltage | - | 3.3 | V |
93+
| Current Consumption | - | ~6.4 | mA |
8994

90-
The module includes a power LED that draws 1 mA and turns on as soon as it is powered.
95+
The module additionally includes a power LED that draws 1 mA and turns on as soon as it is powered.
9196
J1 (Qwiic connector), J2 (Qwiic connector), and the headers all share the same power branch. The power distribution of the module is therefore as follows:
9297
![Power Tree Modulino Buzzer](assets/Modulino_Buzzer_Power_Tree.png)
9398

‎content/hardware/11.accessories/modulino-nodes/modulino-buzzer/tutorials/how-buzzer-mp/content.md

Lines changed: 33 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,10 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc
2020

2121
The Modulino Buzzer based on the buzzer (PKLCS1212E4001-R1) is capable of generating different tones and sound patterns. Take a look at the following table to know more about its characteristics:
2222

23-
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
24-
|----------------------|-------------------|---------|---------|---------|------|
25-
| Frequency Range | - | 2,000 | - | 4,000 | Hz |
26-
| Resonant Frequency | - | 2,400 | 2,700 | 3,000 | Hz |
27-
| Sound Pressure Level | @ 2.7 kHz, 3.3Vpp | - | 75 | - | dB |
23+
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
24+
|----------------------|-----------|---------|---------|---------|------|
25+
| Frequency | - | - | 4,000 | - | Hz |
26+
| Sound Pressure Level | - | 75 | 85 | - | dB |
2827

2928
## Sensor Details
3029

@@ -34,37 +33,42 @@ One unique feature of this setup is the ability to change the I²C address via s
3433

3534
The default I²C address for the **Modulino Buzzer** module is:
3635

37-
| Modulino I²C Address | Hardware I²C Address | Editable Addresses (HEX) |
38-
|----------------------|----------------------|-------------------------------------------------|
39-
| 0x3C | 0x1E | Any custom address (via software configuration) |
36+
| Modulino I²C Address | Hardware I²C Address |Editable Addresses (HEX)|
37+
|----------------------|----------------------|----------------------|
38+
| 0x3C | 0x1E |Any custom address (via software configuration)
4039

4140

4241
When scanning for I²C address on the bus, you might find the modulino using the **Hardware I²C Address**. However, you should always use the **Modulino I²C Address** when using the official Modulino library.
4342
Later in this article we teach how to [change the address](#how-to-change-i2c-address).
4443

44+
4545
## Pinout
4646

4747
The PKLCS1212E4001-R1 buzzer is the core component of this module. This audio output device is controlled by an onboard STM32 microcontroller, which supports digital communication (I²C), meaning it connects directly to the I²C bus on the module without requiring additional conversion circuitry.
4848

4949
![Arduino Buzzer Pinout](assets/BuzzerPinouts.png)
5050

51-
### 1x6 Header (LSM6DSOXTR)
52-
| Pin | Function |
53-
|-------|---------------|
54-
| PA0 | Buzzer Signal |
55-
| RX1 | UART Receive |
56-
| TX1 | UART Transmit |
57-
| SWDIO | SWD Data |
58-
| SWCLK | SWD Clock |
59-
| PF2 | NRST |
60-
61-
- **PA0: Buzzer Signal** – This pin is used to control the buzzer's output signal. In fact, this pin can be used to bypass the I²C interface and control the buzzer directly using a square wave.
51+
| Pin | Function |
52+
|--------|-----------------|
53+
| GND | Ground |
54+
| 3V3 | 3.3V Power |
55+
| RESET | Reset |
56+
| SWCLK | SWD Clock |
57+
| SWDIO | SWD Data |
58+
| TX1 | USART Transmit |
59+
| RX1 | USART Receive |
60+
| PA0 | Buzzer |
61+
62+
- **GND:** Provides ground reference for the circuit.
63+
- **3V3:** Supplies 3.3 V power to connected components and modules.
64+
- **Reset:** The reset pin for the microcontroller, which can be used to reset the system.
65+
- **SWCLK:** Used for providing the clock signal in the SWD interface.
66+
- **SWDIO:** Used for debugging, as part of the Serial Wire Debug (SWD) interface.
67+
- **TX1:** Used for transmitting data over UART communication.
68+
- **RX1:** Used for receiving data over UART communication.
69+
- **PA0:** This pin is used to control the buzzer's output signal. In fact, this pin can be used to bypass the I²C interface and control the buzzer directly using a square wave.
6270
![Direct control via signal](assets/buzzerPA0.gif)
63-
- **RX1: UART Receive** – Used for receiving data over UART communication.
64-
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
65-
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
66-
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
67-
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.
71+
6872

6973
### 1x4 Header (I2C)
7074
The pinout for the Modulino Buzzer is shown below. While the recommended connection method is via the QWIIC connectors, this solderable header provides a connection option when using the modulino with a non-QWIIC compatible board.
@@ -81,12 +85,12 @@ The pinout for the Modulino Buzzer is shown below. While the recommended connect
8185

8286
The board is typically powered by +3.3 VDC when using the QWIIC interface as per the I²C standard.
8387

84-
| Parameter | Condition | Minimum | Typical | Maximum | Unit |
85-
|---------------------|-----------------|---------|---------|---------|------|
86-
| Operating Voltage | - | 2.5 | 3.3 | 3.6 | V |
87-
| Current Consumption | @ 3.3V, 2.7 kHz | - | 120 | - | μA |
88+
| Parameter | Condition | Typical | Unit |
89+
|---------------------|-----------|---------|------|
90+
| Operating Voltage | - | 3.3 | V |
91+
| Current Consumption | - | ~6.4 | mA |
8892

89-
The module includes a power LED that draws 1 mA and turns on as soon as it is powered.
93+
The module additionally includes a power LED that draws 1 mA and turns on as soon as it is powered.
9094
J1 (Qwiic connector), J2 (Qwiic connector), and the headers all share the same power branch. The power distribution of the module is therefore as follows:
9195
![Power Tree Modulino Buzzer](assets/Modulino_Buzzer_Power_Tree.png)
9296

0 commit comments

Comments
 (0)