Skip to content

Commit 928376c

Browse files
Merge 087bb29 into 7ea951d
2 parents 7ea951d + 087bb29 commit 928376c

File tree

21 files changed

+521
-367
lines changed

21 files changed

+521
-367
lines changed

content/hardware/11.accessories/modulino-nodes/modulino-buttons/datasheet/datasheet.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -96,17 +96,20 @@ The Modulino® Buttons node has a dedicated microcontroller (STM32C011F4) which
9696

9797
These pads and the Qwiic connectors share the same I2C bus at 3.3 V.
9898

99-
**Additional 1×10 Header (STM32C011F4 Signals)**
100-
| **Pin** | **Function** |
101-
|---------|------------------------|
102-
| PA0 | Button/LED line (MCU) |
103-
| PA1 | Button/LED line (MCU) |
104-
| PA2 | Button/LED line (MCU) |
105-
| RX1 | UART Receive (optional)|
106-
| TX1 | UART Transmit (optional)|
107-
| SWDIO | SWD Data |
108-
| SWCLK | SWD Clock |
109-
| PF2 | NRST (Reset) |
99+
**Additional 1×10 Header**
100+
101+
| **Pin** | **Function** |
102+
|---------|--------------|
103+
| A | Button A |
104+
| GND | Ground |
105+
| 3V3 | 3.3 V Power |
106+
| PF2 | RESET |
107+
| SWCLK | SWD Clock |
108+
| SWDIO | SWD Data |
109+
| TX1 | USART Transmit |
110+
| RX1 | USART Receive |
111+
| B | Button B |
112+
| C | Button C |
110113

111114
**Note:**
112115
- The board can be reprogrammed via SWD to implement custom functionality.
@@ -258,5 +261,6 @@ Hereby, Arduino S.r.l. declares that this product is in compliance with essentia
258261
# Revision History
259262
| **Date** | **Revision** | **Changes** |
260263
|------------|--------------|--------------------|
264+
| 23/05/2025 | 3 | Fixed pinout table and power info |
261265
| 21/05/2025 | 2 | Fixed info on LEDs |
262266
| 14/05/2025 | 1 | First release |

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/datasheet/datasheet.md

Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -72,17 +72,13 @@ This module features an STM32C011F4 microcontroller that drives a PKLCS1212E4001
7272
The Modulino® Buzzer node receives sound commands or frequency/tone data via I2C. The STM32C011F4 microcontroller then drives the buzzer, producing audible tones or beeps. For more advanced usage, users can re-flash the firmware via SWD to generate custom waveforms or integrate additional logic.
7373

7474
### Technical Specifications (Module-Specific)
75-
| **Specification** | **Details** |
76-
| ----------------------- | -------------------------------------------- |
77-
| **Microcontroller** | STM32C011F4 |
78-
| **Accuracy** | ADC: ±2 LSB typical INL |
79-
| **Resolution** | 12-bit ADC |
80-
| **Actuator** | PKLCS1212E4001 buzzer |
81-
| **Supply Voltage** | Min: 2.0 V, Max: 3.6 V |
82-
| **Power Consumption** | ~6.4 mA (buzzer active) |
83-
| **Accuracy** | ADC: ±2 LSB typical INL (for advanced usage) |
84-
| **Resolution** | 12-bit ADC (potential for custom expansions) |
85-
| **Communication** | I2C (Qwiic), SWD, optional UART if reprogrammed |
75+
| **Specification** | **Details** |
76+
| --------------------- | ----------------------------------------------- |
77+
| **Microcontroller** | STM32C011F4 |
78+
| **Actuator** | PKLCS1212E4001 buzzer |
79+
| **Supply Voltage** | Min: 2.0 V, Max: 3.6 V |
80+
| **Power Consumption** | ~6.4 mA (buzzer active) |
81+
| **Communication** | I2C (Qwiic), SWD, optional UART if reprogrammed |
8682

8783
### Pinout
8884

@@ -97,14 +93,16 @@ The Modulino® Buzzer node receives sound commands or frequency/tone data via I2
9793
These pads and the Qwiic connectors share the same I2C bus at 3.3 V.
9894

9995
**Additional 1×8 Header (Buzzer & MCU Signals)**
100-
| **Pin** | **Function** |
101-
|---------|--------------------|
102-
| PA0 | Buzzer signal (PWM)|
103-
| RX1 | UART Receive |
104-
| TX1 | UART Transmit |
105-
| SWDIO | SWD Data |
106-
| SWCLK | SWD Clock |
107-
| PF2 | NRST (Reset) |
96+
| **Pin** | **Function** |
97+
|---------|----------------|
98+
| GND | Ground |
99+
| 3V3 | 3.3 V Power |
100+
| RESET | Reset |
101+
| SWCLK | SWD Clock |
102+
| SWDIO | SWD Data |
103+
| TX1 | USART Transmit |
104+
| RX1 | USART Receive |
105+
| PA0 | Buzzer |
108106

109107
**Note:** You can drive the buzzer with custom signals (PWM supplied to the PA0 pin) or reprogram the STM32C011F4 via SWD for alternate modes or advanced functionality.
110108

@@ -249,6 +247,7 @@ Hereby, Arduino S.r.l. declares that this product is in compliance with essentia
249247
| Online Store | [https://store.arduino.cc/](https://store.arduino.cc/) |
250248

251249
# Revision History
252-
| **Date** | **Revision** | **Changes** |
253-
|------------ |------------ |------------------------------------------------|
254-
| 14/05/2025 | 1 | First release |
250+
| **Date** | **Revision** | **Changes** |
251+
| ---------- | ------------ | ------------------------------------------------------------- |
252+
| 23/05/2025 | 2 | Fixed pinout table, power info, and unrelated characteristics |
253+
| 14/05/2025 | 1 | First release |

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

0 commit comments

Comments
 (0)