Skip to content

[Modulinos Launch] Requested changes How tos / Datasheets #2506

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

[Modulinos Launch] Requested changes How tos / Datasheets #2506

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b144f85
Requested changes
pedromsousalima May 23, 2025
087bb29
Datasheet corrections
pedromsousalima May 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 15 additions & 11 deletions .../hardware/11.accessories/modulino-nodes/modulino-buttons/datasheet/datasheet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,17 +96,20 @@ The Modulino® Buttons node has a dedicated microcontroller (STM32C011F4) which

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

**Additional 1×10 Header (STM32C011F4 Signals)**
| **Pin** | **Function** |
|---------|------------------------|
| PA0 | Button/LED line (MCU) |
| PA1 | Button/LED line (MCU) |
| PA2 | Button/LED line (MCU) |
| RX1 | UART Receive (optional)|
| TX1 | UART Transmit (optional)|
| SWDIO | SWD Data |
| SWCLK | SWD Clock |
| PF2 | NRST (Reset) |
**Additional 1×10 Header**

| **Pin** | **Function** |
|---------|--------------|
| A | Button A |
| GND | Ground |
| 3V3 | 3.3 V Power |
| PF2 | RESET |
| SWCLK | SWD Clock |
| SWDIO | SWD Data |
| TX1 | USART Transmit |
| RX1 | USART Receive |
| B | Button B |
| C | Button C |

**Note:**
- The board can be reprogrammed via SWD to implement custom functionality.
Expand Down Expand Up @@ -258,5 +261,6 @@ Hereby, Arduino S.r.l. declares that this product is in compliance with essentia
# Revision History
| **Date** | **Revision** | **Changes** |
|------------|--------------|--------------------|
| 23/05/2025 | 3 | Fixed pinout table and power info |
| 21/05/2025 | 2 | Fixed info on LEDs |
| 14/05/2025 | 1 | First release |
60 changes: 39 additions & 21 deletions ...dulino-nodes/modulino-buttons/tutorials/how-buttons-ardu/how-to-buttons-ardu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,20 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc

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.


# General Characteristics

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.

| Specification | Details |
|-------------------|-----------------------------|
| Buttons | 3 × Tactile pushbuttons |
| LEDs | 3 × Indicator LEDs (orange) |
| Power Supply | 3.3 V |
| Interface | UART, SWD, I2C |
| Pull-up Resistors | Integrated on button inputs |


The default I²C address for the **Modulino Buttons** module is:

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

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

### Input/Output Headers

| Pin | Function |
|----------|-----------------|
| Button A | Button A Signal |
| Button B | Button B Signal |
| Button C | Button C Signal |
| RX1 | UART Receive |
| TX1 | UART Transmit |
| SWDIO | SWD Data |
| SWCLK | SWD Clock |
| PF2 | NRST |

- **Button A/B/C** – These pins connect directly to the three tactile buttons on the board.
- **RX1: UART Receive** – Used for receiving data over UART communication.
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
### 1x10 Header

| Pin | Function |
|-------|----------------|
| A | Button A |
| GND | Ground |
| 3V3 | 3.3 V Power |
| PF2 | RESET |
| SWCLK | SWD Clock |
| SWDIO | SWD Data |
| TX1 | USART Transmit |
| RX1 | USART Receive |
| B | Button B |
| C | Button C |

- **A: Button A** – This pin connects directly to button A.
- **GND: Ground** – Ground connection for power and signal reference.
- **3V3: Power** – 3.3 V power supply input.
- **PF2: RESET** – The reset pin for the microcontroller, which can be used to reset the system.
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
- **TX1: USART Transmit** – Used for transmitting data over UART communication.
- **RX1: USART Receive** – Used for receiving data over UART communication.
- **B: Button B** – This pin connects directly to button B.
- **C: Button C** – This pin connects directly to button C.

### 1x4 Header (I2C)

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

| Parameter | Condition | Minimum | Typical | Maximum | Unit |
|------------------|-------------------|---------|-------------|---------|------|
| Supply Voltage | - | 2.3 | 3.3 (QWIIC) | 3.6 | V |
| LED Current Draw | Single LED Active | - | 2.5 | - | mA |
| Supply Voltage | - | - | 3.3 (QWIIC) | - | V |
| LED Current Draw | Single LED Active (A,B or C) | - | 2.5 | - | mA |

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:
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:

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

Expand Down
60 changes: 39 additions & 21 deletions ...s/modulino-nodes/modulino-buttons/tutorials/how-buttons-mp/how-to-buttons-mp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,20 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc

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.


# General Characteristics

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.

| Specification | Details |
|-------------------|-----------------------------|
| Buttons | 3 × Tactile pushbuttons |
| LEDs | 3 × Indicator LEDs (orange) |
| Power Supply | 3.3 V |
| Interface | UART, SWD, I2C |
| Pull-up Resistors | Integrated on button inputs |


The default I²C address for the **Modulino Buttons** module is:

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

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

### Input/Output Headers

| Pin | Function |
|----------|-----------------|
| Button A | Button A Signal |
| Button B | Button B Signal |
| Button C | Button C Signal |
| RX1 | UART Receive |
| TX1 | UART Transmit |
| SWDIO | SWD Data |
| SWCLK | SWD Clock |
| PF2 | NRST |

- **Button A/B/C** – These pins connect directly to the three tactile buttons on the board.
- **RX1: UART Receive** – Used for receiving data over UART communication.
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
### 1x10 Header

| Pin | Function |
|-------|----------------|
| A | Button A |
| GND | Ground |
| 3V3 | 3.3 V Power |
| PF2 | RESET |
| SWCLK | SWD Clock |
| SWDIO | SWD Data |
| TX1 | USART Transmit |
| RX1 | USART Receive |
| B | Button B |
| C | Button C |

- **A: Button A** – This pin connects directly to button A.
- **GND: Ground** – Ground connection for power and signal reference.
- **3V3: Power** – 3.3 V power supply input.
- **PF2: RESET** – The reset pin for the microcontroller, which can be used to reset the system.
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
- **TX1: USART Transmit** – Used for transmitting data over UART communication.
- **RX1: USART Receive** – Used for receiving data over UART communication.
- **B: Button B** – This pin connects directly to button B.
- **C: Button C** – This pin connects directly to button C.

### 1x4 Header (I2C)

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

| Parameter | Condition | Minimum | Typical | Maximum | Unit |
|------------------|-------------------|---------|-------------|---------|------|
| Supply Voltage | - | 2.3 | 3.3 (QWIIC) | 3.6 | V |
| LED Current Draw | Single LED Active | - | 2.5 | - | mA |
| Supply Voltage | - | - | 3.3 (QWIIC) | - | V |
| LED Current Draw | Single LED Active (A,B or C) | - | 2.5 | - | mA |

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:
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:

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

Expand Down
43 changes: 21 additions & 22 deletions ...t/hardware/11.accessories/modulino-nodes/modulino-buzzer/datasheet/datasheet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,17 +72,13 @@ This module features an STM32C011F4 microcontroller that drives a PKLCS1212E4001
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.

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

### Pinout

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

**Additional 1×8 Header (Buzzer & MCU Signals)**
| **Pin** | **Function** |
|---------|--------------------|
| PA0 | Buzzer signal (PWM)|
| RX1 | UART Receive |
| TX1 | UART Transmit |
| SWDIO | SWD Data |
| SWCLK | SWD Clock |
| PF2 | NRST (Reset) |
| **Pin** | **Function** |
|---------|----------------|
| GND | Ground |
| 3V3 | 3.3 V Power |
| RESET | Reset |
| SWCLK | SWD Clock |
| SWDIO | SWD Data |
| TX1 | USART Transmit |
| RX1 | USART Receive |
| PA0 | Buzzer |

**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.

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

# Revision History
| **Date** | **Revision** | **Changes** |
|------------ |------------ |------------------------------------------------|
| 14/05/2025 | 1 | First release |
| **Date** | **Revision** | **Changes** |
| ---------- | ------------ | ------------------------------------------------------------- |
| 23/05/2025 | 2 | Fixed pinout table, power info, and unrelated characteristics |
| 14/05/2025 | 1 | First release |
57 changes: 31 additions & 26 deletions ...accessories/modulino-nodes/modulino-buzzer/tutorials/how-buzzer-ardu/content.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,10 @@ The Modulino form factor is shaped with two QWIIC connectors and the I²C protoc

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:

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

## Sensor Details

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

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

### 1x6 Header (LSM6DSOXTR)
| Pin | Function |
|-------|---------------|
| PA0 | Buzzer Signal |
| RX1 | UART Receive |
| TX1 | UART Transmit |
| SWDIO | SWD Data |
| SWCLK | SWD Clock |
| PF2 | NRST |

- **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.
### 1x8 Header

| Pin | Function |
|--------|-----------------|
| GND | Ground |
| 3V3 | 3.3V Power |
| RESET | Reset |
| SWCLK | SWD Clock |
| SWDIO | SWD Data |
| TX1 | USART Transmit |
| RX1 | USART Receive |
| PA0 | Buzzer |

- **GND:** Provides ground reference for the circuit.
- **3V3:** Supplies 3.3 V power to connected components and modules.
- **Reset:** The reset pin for the microcontroller, which can be used to reset the system.
- **SWCLK:** Used for providing the clock signal in the SWD interface.
- **SWDIO:** Used for debugging, as part of the Serial Wire Debug (SWD) interface.
- **TX1:** Used for transmitting data over UART communication.
- **RX1:** Used for receiving data over UART communication.
- **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.
![Direct control via signal](assets/buzzerPA0.gif)
- **RX1: UART Receive** – Used for receiving data over UART communication.
- **TX1: UART Transmit** – Used for transmitting data over UART communication.
- **SWDIO: SWD Data** – Used for debugging, as part of the Serial Wire Debug (SWD) interface.
- **SWCLK: SWD Clock** – Used for providing the clock signal in the SWD interface.
- **PF2: NRST** – The reset pin for the microcontroller, which can be used to reset the system.


### 1x4 Header (I2C)
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.
Expand All @@ -82,12 +87,12 @@ The pinout for the Modulino Buzzer is shown below. While the recommended connect

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

| Parameter | Condition | Minimum | Typical | Maximum | Unit |
|---------------------|-----------------|---------|---------|---------|------|
| Operating Voltage | - | 2.5 | 3.3 | 3.6 | V |
| Current Consumption | @ 3.3V, 2.7 kHz | - | 120 | - | μA |
| Parameter | Condition | Typical | Unit |
|---------------------|-----------|---------|------|
| Operating Voltage | - | 3.3 | V |
| Current Consumption | - | ~6.4 | mA |

The module includes a power LED that draws 1 mA and turns on as soon as it is powered.
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:
![Power Tree Modulino Buzzer](assets/Modulino_Buzzer_Power_Tree.png)

Expand Down
Loading
Loading