Modulino Batch 2 public

content/hardware/11.modulino/modulino-nodes/modulino-joystick/compatibility.yml

@@ -0,0 +1,17 @@
+software:
+  - arduino-ide
+  - arduino-cli
+  - web-editor
+hardware:
+  boards:
+    - nano-33-iot
+    - nano-33-ble
+    - nano-33-ble-sense
+    - nano-rp2040-connect
+    - nano-esp32
+    - nano-matter
+    - uno-r4-wifi
+    - uno-q
+  shields: ~
+  carriers:
+    - nano-connector-carrier

content/hardware/11.modulino/modulino-nodes/modulino-joystick/datasheet/datasheet.md

@@ -0,0 +1,242 @@
+---
+identifier: ABX00135
+title: Arduino® Modulino® Joystick
+type: maker
+author: Pedro Sousa Lima
+---
+
+![](assets/featured.png)
+
+# Description
+
+The Arduino® Modulino Joystick features a FJN10K-S1B10KD0N analogue joystick with an integrated pushbutton, powered by an on-board STM32C011F4 microcontroller. This dual-axis input device with centre-click functionality enables precise directional control and user interaction for gaming, robotics, and interface applications.
+
+# Target Areas
+
+Maker, beginner, education
+
+# Contents
+## Application Examples
+
+- **Gaming Controllers**
+  Create custom game controllers or remote control interfaces with precise analogue input and pushbutton functionality for enhanced gaming experiences.
+
+- **Robotics Control**
+  Control robot movement, camera positioning, or servo motors with smooth analogue input across horizontal and vertical axes for precise control.
+
+- **Interactive Interfaces**
+  Design menu navigation systems, parameter adjustment interfaces, or interactive art installations with intuitive joystick-based user input.
+
+<div style="page-break-after: always;"></div>
+
+## Features
+- **Analogue joystick** (FJN10K-S1B10KD0N) with dual-axis control and integrated pushbutton.
+- **60° movement angle** providing smooth analogue control across both horizontal and vertical axes.
+- Integrated **STM32C011F4** microcontroller providing I2C interface by default.
+- **Optional SWD** interface for custom firmware and advanced features.
+- Designed for **3.3V** operation via the Qwiic connector (I2C).
+- **Breadboard compatible** with 900mil header spacing for prototyping.
+
+### Contents
+| **SKU**    | **Name**              | **Purpose**                            | **Quantity** |
+| ---------- | --------------------- | -------------------------------------- | ------------ |
+| ABX00135   | Modulino® Joystick    | Dual-axis analogue joystick with button | 1            |
+|            | I2C Qwiic cable       | Compatible with the Qwiic standard     | 1            |
+
+## Related Products
+- *SKU: ASX00027* - [Arduino® Sensor Kit](https://store.arduino.cc/products/arduino-sensor-kit)
+- *SKU: K000007* - [Arduino® Starter Kit](https://store.arduino.cc/products/arduino-starter-kit-multi-language)
+- *SKU: AKX00026* - [Arduino® Oplà IoT Kit](https://store.arduino.cc/products/opla-iot-kit)
+- *SKU: AKX00069* - [Arduino® Plug and Make Kit](https://store.arduino.cc/products/plug-and-make-kit)
+
+## Rating
+
+### Recommended Operating Conditions
+- **Powered at 3.3 V** through the Qwiic interface (in accordance with the Qwiic standard)
+- **Operating temperature:** -40 °C to +85 °C
+
+**Typical current consumption:**
+- Microcontroller + joystick: ~3.4 mA
+
+## Power Tree
+The power tree for the Modulino® node can be consulted below:
+
+![Modulino® Joystick Power Tree](assets/Modulino_Joystick_Power_Tree.png)
+
+## Block Diagram
+This module includes an STM32C011F4 microcontroller that reads the analogue joystick potentiometers for horizontal and vertical axes, plus the integrated pushbutton. It communicates via I2C by default, but can be reprogrammed via SWD for custom functionality.
+
+![Modulino® Joystick Block Diagram](assets/Modulino_Joystick_Block_Diagram.png)
+
+## Functional Overview
+The Modulino® Joystick reads the FJN10K-S1B10KD0N analogue joystick's dual potentiometers (horizontal and vertical axes) and the integrated pushbutton state. The STM32C011F4 microcontroller processes these analogue signals and provides digital values via I2C. The joystick offers 60° movement range in both directions with smooth analogue control and reliable centre positioning.
+
+### Technical Specifications (Module-Specific)
+| **Specification**       | **Details**                                     |
+| ----------------------- | ----------------------------------------------- |
+| **Microcontroller**     | STM32C011F4                                     |
+| **Joystick Model**      | FJN10K-S1B10KD0N                               |
+| **Movement Range**      | 60° in both horizontal and vertical axes       |
+| **Pushbutton**          | Integrated centre-click button                 |
+| **Supply Voltage**      | Rec: 3.3 V                           |
+| **Power Consumption**   | ~3.4 mA (microcontroller + joystick)            |
+| **Resolution**          | 12-bit ADC for both axes                       |
+| **Communication**       | I2C (Qwiic), SWD (reprogramming), UART (option) |
+
+### Pinout
+
+**Qwiic / I2C (1×4 Header)**  
+| **Pin** | **Function**              |
+|---------|---------------------------|
+| GND     | Ground                   |
+| 3.3 V    | Power Supply (3.3 V)     |
+| SDA     | I2C Data                 |
+| SCL     | I2C Clock                |
+
+These pads and the Qwiic connectors share the same I2C bus at 3.3 V.
+
+**Additional 1×4 Header (MCU Debug Signals)**
+| **Pin** | **Function**      |
+|---------|-------------------|
+| PF2     | RESET (NRST)      |
+| SWCLK   | SWD Clock (PA14)  |
+| SWDIO   | SWD Data (PA13)   |
+| TX1     | USART Transmit (PA9) |
+
+**1×4 Header (Joystick & MCU Signals)**
+| **Pin** | **Function**              |
+|---------|---------------------------|
+| RX1     | USART Receive (PA10)      |
+| PA0     | Joystick Horizontal Axis  |
+| PA1     | Joystick Vertical Axis    |
+| PA2     | Joystick Pushbutton       |
+
+**Note:** The board is breadboard compatible with 1×4 headers spaced by 900 mil (22.86 mm). The joystick axes provide analogue values from 0-4095 (12-bit resolution), with centre position at approximately 2048.
+
+![Pinout Overview](assets/JoystickPinout.png)
+
+### Power Specifications
+- **Nominal operating voltage:** 3.3 V via Qwiic
+
+### Mechanical Information
+![Modulino® Joystick Mechanical Information](assets/JoyMec.png)
+
+- Board dimensions: 41 mm × 25.36 mm
+- Thickness: 1.6 mm (±0.2 mm)
+- Four mounting holes (⌀ 3.2 mm)
+  - Hole spacing: 16 mm vertically, 32 mm horizontally
+- **Breadboard compatible:** 1×4 headers spaced by 900 mil (22.86 mm)
+
+![Modulino® Node Shape](assets/GenMech.png)
+
+### I2C Address Reference
+| **Board Silk Name** | **Sensor/Actuator**     | **Modulino® I2C Address (HEX)** | **Editable Addresses (HEX)**                | **Hardware I2C Address (HEX)** |
+|---------------------|-------------------------|--------------------------------|---------------------------------------------|--------------------------------|
+| MODULINO JOYSTICK   | Analogue Joystick + MCU | 0x40                           | Any custom address (via software config.)   | 0x20                           |
+
+ **Note:**
+ - Default I2C address is **0x40**.
+ - A white rectangle on the bottom silk allows users to write a new address after reconfiguration.
+  ![Blank silk for identification](assets/I2CTag.png)
+
+#### Pull-up Resistors
+
+This module has pads for optional I2C pull-up mounting in both data lines. No resistors are mounted by default but in case the resistors are needed 4.7 K resistors in an SMD 0402 format are recommended.
+
+These are positioned near the Qwiic connector on the power LED side.
+![Generic pull-up resistor position](assets/ResistorsPullupGen.png)
+
+## Device Operation
+By default, the board is an I2C target device. It continuously monitors the joystick's horizontal and vertical potentiometers plus the pushbutton state, providing digital values via I2C registers. The joystick returns to centre position when released, with values ranging from 0-4095 for each axis. Simply connect it to a 3.3 V Qwiic interface and read the axis positions and button state via I2C.
+
+### Getting Started
+Use any standard Arduino workflow-desktop IDE or Arduino Cloud Editor. The official Modulino library provides simple functions to read joystick X/Y coordinates and button state. The joystick values are automatically centred and scaled for easy use in gaming or control applications.
+
+### Joystick Output Values
+- **Horizontal Axis (X):** 0-4095 (left to right), centre ≈ 2048
+- **Vertical Axis (Y):** 0-4095 (down to up), centre ≈ 2048  
+- **Pushbutton:** Boolean state (pressed/released)
+- **Centre Position:** Joystick returns to centre when released
+
+# Certifications
+
+## Certifications Summary
+
+| **Certification** | **Status** |
+|:-----------------:|:----------:|
+|  CE/RED (Europe)  |     Yes    |
+|     UKCA (UK)     |     Yes    |
+|     FCC (USA)     |     Yes    |
+|    IC (Canada)    |     Yes    |
+|        RoHS       |     Yes    |
+|       REACH       |     Yes    |
+|        WEEE       |     Yes    |
+
+## Declaration of Conformity CE DoC (EU)
+
+<p style="text-align: justify;">We declare under our sole responsibility that the products above are in conformity with the essential requirements of the following EU Directives and therefore qualify for free movement within markets comprising the European Union (EU) and European Economic Area (EEA).</p>
+
+## Declaration of Conformity to EU RoHS & REACH 211 01/19/2021
+
+<p style="text-align: justify;">Arduino boards are in compliance with RoHS 2 Directive 2011/65/EU of the European Parliament and RoHS 3 Directive 2015/863/EU of the Council of 4 June 2015 on the restriction of the use of certain hazardous substances in electrical and electronic equipment.</p>
+
+| Substance                              | **Maximum limit (ppm)** |
+|----------------------------------------|-------------------------|
+| Lead (Pb)                              | 1000                    |
+| Cadmium (Cd)                           | 100                     |
+| Mercury (Hg)                           | 1000                    |
+| Hexavalent Chromium (Cr6+)             | 1000                    |
+| Poly Brominated Biphenyls (PBB)        | 1000                    |
+| Poly Brominated Diphenyl ethers (PBDE) | 1000                    |
+| Bis(2-Ethylhexyl) phthalate (DEHP)     | 1000                    |
+| Benzyl butyl phthalate (BBP)           | 1000                    |
+| Dibutyl phthalate (DBP)                | 1000                    |
+| Diisobutyl phthalate (DIBP)            | 1000                    |
+
+Exemptions: No exemptions are claimed.
+
+<p style="text-align: justify;">Arduino Boards are fully compliant with the related requirements of European Union Regulation (EC) 1907 /2006 concerning the Registration, Evaluation, Authorization and Restriction of Chemicals (REACH). We declare none of the SVHCs (https://echa.europa.eu/web/guest/candidate-list-table), the Candidate List of Substances of Very High Concern for authorization currently released by ECHA, is present in all products (and also package) in quantities totaling in a concentration equal or above 0.1%. To the best of our knowledge, we also declare that our products do not contain any of the substances listed on the "Authorization List" (Annex XIV of the REACH regulations) and Substances of Very High Concern (SVHC) in any significant amounts as specified by the Annex XVII of Candidate list published by ECHA (European Chemical Agency) 1907 /2006/EC.</p>
+
+## FCC WARNING
+
+This device complies with part 15 of the FCC Rules.
+
+Operation is subject to the following two conditions: 
+
+(1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
+
+## IC Caution
+
+This device complies with Industry Canada licence-exempt RSS standard(s). 
+
+Operation is subject to the following two conditions: 
+
+(1) This device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device.
+
+## Conflict Minerals Declaration
+
+<p style="text-align: justify;">As a global supplier of electronic and electrical components, Arduino is aware of our obligations with regard to laws and regulations regarding Conflict Minerals, specifically the Dodd-Frank Wall Street Reform and Consumer Protection Act, Section 1502. Arduino does not directly source or process conflict minerals such as Tin, Tantalum, Tungsten, or Gold. Conflict minerals are contained in our products in the form of solder or as a component in metal alloys. As part of our reasonable due diligence, Arduino has contacted component suppliers within our supply chain to verify their continued compliance with the regulations. Based on the information received thus far we declare that our products contain Conflict Minerals sourced from conflict-free areas.</p>
+
+# Company Information
+
+| Company name    | Arduino SRL                                   |
+|-----------------|-----------------------------------------------|
+| Company Address | Via Andrea Appiani, 25 - 20900 MONZA（Italy)  |
+
+# Reference Documentation
+
+| Ref                       | Link                                                                                                                                                                                           |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Arduino IDE (Desktop)     | [https://www.arduino.cc/en/software/](https://www.arduino.cc/en/software/)                                                                                                             |
+| Arduino Courses           | [https://www.arduino.cc/education/courses](https://www.arduino.cc/education/courses)                                                                                                           |
+| Arduino Documentation     | [https://docs.arduino.cc/](https://docs.arduino.cc/)                                                                                                           |
+| Arduino IDE (Cloud)       | [https://create.arduino.cc/editor](https://create.arduino.cc/editor)                                                                                                                           |
+| Cloud IDE Getting Started | [https://docs.arduino.cc/cloud/web-editor/tutorials/getting-started/getting-started-web-editor](https://docs.arduino.cc/cloud/web-editor/tutorials/getting-started/getting-started-web-editor) |
+| Project Hub               | [https://projecthub.arduino.cc/](https://projecthub.arduino.cc/)                                                                                                                          |
+| Library Reference         | [https://github.com/arduino-libraries/](https://github.com/arduino-libraries/)                                                                                                            |
+| Online Store              | [https://store.arduino.cc/](https://store.arduino.cc/)                                                                                                                                    |
+
+# Revision History
+| **Date**   | **Revision** | **Changes**                       |
+|------------|--------------|-----------------------------------|
+| 14/10/2025 | 1            | First release                     |

content/hardware/11.modulino/modulino-nodes/modulino-joystick/essentials.md

@@ -0,0 +1,11 @@
+<EssentialsColumn title="Suggested Libraries">
+
+<EssentialElement title="Arduino Modulino® Library" type="library" link="https://www.arduino.cc/reference/en/libraries/modulino/">
+This library allows you to communicate with the Arduino Modulino® nodes.
+  </EssentialElement>
+
+<EssentialElement title="Modulino MicroPython Package" type="library" link="https://github.com/arduino/arduino-modulino-mpy">
+This library allows you to communicate with the Arduino Modulino® nodes in MicroPython.
+  </EssentialElement>
+
+</EssentialsColumn>

content/hardware/11.modulino/modulino-nodes/modulino-joystick/features.md

@@ -0,0 +1,14 @@
+<FeatureDescription>
+The Modulino® Joystick module features a dual-axis analogue joystick with an integrated pushbutton, perfect for gaming, robotics control, and interactive interfaces. It is designed to be used with any compatible board with Qwiic, allowing you to build interactive projects without making complicated connections. The module also includes example projects for you to learn important programming concepts and get inspired.
+</FeatureDescription>
+
+
+<FeatureList>
+<Feature title="Dual-Axis Control" image="configurability">
+This module provides smooth analogue control across both horizontal and vertical axes with a 60° movement range, perfect for gaming controllers and robotics navigation.
+</Feature>
+<Feature title="Qwiic Connectors" image="connection">
+The Modulino® Joystick module connects to your UNO R4 WiFi with Qwiic cables, letting you focus on learning programming without building complex circuits.
+</Feature>
+
+</FeatureList>