The One Key Module is a modular building block for the Framework Laptop 16 input system. It allows developers to create custom keyboard layouts, macropads, or individual input triggers using a standardized mechanical and electrical footprint. This module is designed to be mounted underneath a rigid carrier PCB, with electrical and mechanical connections made via castellated pads soldered upwards into the lattice and secured using four mechanical solder lugs.

Warning

This documentation is subject to change before the One Key Module launches.

License

Technical Specifications

Mechanical

Key Pitch/Area: 19.20mm * 19.20mm
Keycap Size: 15.76mm * 15.76mm
Key Travel: 1.50mm +/- 0.2mm
PCB Thickness: 0.15mm
Backlight: 1x White mini-LED
Max Z-Height: 3.65mm (including Mylar).
- Note: To ensure the laptop closes correctly, the total height of the switch and PCB must not exceed 3.70mm. Please refer to here.
3D Reference: One_Key_Module_CAD.stp

Electrical

Switch Type: Membrane Switch.
Backlight: Integrated LED support with a dedicated 5V rail and PWM-capable brightness control (BL_LOW).
Connectivity: Designed for Signal Chaining

Pinout and Signal Mapping

The module features a 10-pin interface designed for daisy chaining multiple keys into a larger keyboard matrix.

Pin	Signal	Description
1	COL in	Matrix Column Input
2	GND	Ground
3	ROW in	Matrix Row Input
4	ROW Out	Matrix Row Pass-through
5	LED_5V	5V Backlight Power
6	LED_5V	5V Backlight Power
7	BL_LOW	Backlight Control
8	BL_LOW	Backlight Control
9	COL Out	Matrix Column Pass-through
10	GND	Ground

Mounting & Assembly

Direct-Solder Lattice Method

This module is designed for a PCB-over-module assembly:

Alignment: The module is positioned underneath a rigid carrier PCB.
Mechanical Retention: Four mechanical solder lugs lock into the carrier board to provide structural stability.
Soldering: The 10 castellated signal pads and the 4 mechanical lugs(optional) are soldered "upwards." This creates a shared electrical and mechanical bond.
Signal Chaining: Use the ROW Out and COL Out signals to daisy-chain multiple modules across the carrier PCB to form a complete keyboard scanning matrix. LEDs will be parallel.

Adding Legends / Key Markings

There are several methods to add custom legends or graphics to the One Key Module (OKM) keycap.

1. 1064 nm Laser Engraving

Equipment: 2W 1064 nm Infrared Laser.
Settings: 1% Power, 4000 mm/s Speed (fastest speed).
Process: Run approximately 7 passes.
Result: This combination effectively ablates the black coating to expose the translucent material underneath, allowing the backlight to shine through without melting the keycap.

Note

Lighting & Diffusion: For large engraved patterns, the LED underneath may not diffuse evenly. Additionally, 5V input may be too bright for these legends. We recommend running the LEDs at 3V if you plan to use laser engraved graphics.

Caution

Do not use a standard diode laser (blue light). Only proceed with this method if you are experienced with laser equipment.

2. UV Printing

Direct UV printing allows for durable, high-resolution, and full-color legends.

3. Paint

For manual customization, you can use model paints (acrylic or enamel) applied with a fine brush or stencils. We recommend applying a clear matte or satin topcoat after painting to protect the design from finger oils and abrasion.

4. Stickers / Decals

High-quality vinyl stickers or waterslide decals are an accessible, non-destructive way to add legends. Ensure the keycap surface is thoroughly cleaned with isopropyl alcohol before application to ensure the best adhesion.