System-End/hackpad
1
0
Fork 0
mirror of https://github.com/System-End/hackpad.git synced 2026-04-20 00:35:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add Yet Another Hackpad

Browse source
This commit is contained in:
wlmchen 2025-02-16 11:29:48 -08:00
parent 0b6e49ffb4
commit 4bfd8dbb38
20 changed files with 224526 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

113365
hackpads/Yet Another Hackpad/CAD/Yet Another Hackpad_v1.0.step Normal file
View file

File diff suppressed because it is too large Load diff

27675
hackpads/Yet Another Hackpad/PCB/3D Models/EC11_Rotary_Encoder_Switched.step Normal file
View file

File diff suppressed because it is too large Load diff

44921
hackpads/Yet Another Hackpad/PCB/3D Models/Seeed Studio XIAO RP2040 v26.step Normal file
View file

File diff suppressed because it is too large Load diff

4003
hackpads/Yet Another Hackpad/PCB/3D Models/switch.step Normal file
View file

File diff suppressed because it is too large Load diff

4707
hackpads/Yet Another Hackpad/PCB/macropad.kicad_pcb Normal file
View file

File diff suppressed because it is too large Load diff

83
hackpads/Yet Another Hackpad/PCB/macropad.kicad_prl Normal file
View file

@ -0,0 +1,83 @@
{
"board": {
"active_layer": 31,
"active_layer_preset": "All Layers",
"auto_track_width": true,
"hidden_netclasses": [],
"hidden_nets": [],
"high_contrast_mode": 0,
"net_color_mode": 1,
"opacity": {
"images": 0.6,
"pads": 1.0,
"tracks": 1.0,
"vias": 1.0,
"zones": 0.6
},
"selection_filter": {
"dimensions": true,
"footprints": true,
"graphics": true,
"keepouts": true,
"lockedItems": false,
"otherItems": true,
"pads": true,
"text": true,
"tracks": true,
"vias": true,
"zones": true
},
"visible_items": [
0,
1,
2,
3,
4,
5,
8,
9,
10,
11,
12,
13,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30,
32,
33,
34,
35,
36,
39,
40
],
"visible_layers": "fffffff_ffffffff",
"zone_display_mode": 0
},
"git": {
"repo_password": "",
"repo_type": "",
"repo_username": "",
"ssh_key": ""
},
"meta": {
"filename": "macropad.kicad_prl",
"version": 3
},
"project": {
"files": []
}
}

596
hackpads/Yet Another Hackpad/PCB/macropad.kicad_pro Normal file
View file

@ -0,0 +1,596 @@
{
"board": {
"3dviewports": [],
"design_settings": {
"defaults": {
"apply_defaults_to_fp_fields": false,
"apply_defaults_to_fp_shapes": false,
"apply_defaults_to_fp_text": false,
"board_outline_line_width": 0.05,
"copper_line_width": 0.2,
"copper_text_italic": false,
"copper_text_size_h": 1.5,
"copper_text_size_v": 1.5,
"copper_text_thickness": 0.3,
"copper_text_upright": false,
"courtyard_line_width": 0.05,
"dimension_precision": 4,
"dimension_units": 3,
"dimensions": {
"arrow_length": 1270000,
"extension_offset": 500000,
"keep_text_aligned": true,
"suppress_zeroes": false,
"text_position": 0,
"units_format": 1
},
"fab_line_width": 0.1,
"fab_text_italic": false,
"fab_text_size_h": 1.0,
"fab_text_size_v": 1.0,
"fab_text_thickness": 0.15,
"fab_text_upright": false,
"other_line_width": 0.1,
"other_text_italic": false,
"other_text_size_h": 1.0,
"other_text_size_v": 1.0,
"other_text_thickness": 0.15,
"other_text_upright": false,
"pads": {
"drill": 0.762,
"height": 1.524,
"width": 1.524
},
"silk_line_width": 0.1,
"silk_text_italic": false,
"silk_text_size_h": 1.0,
"silk_text_size_v": 1.0,
"silk_text_thickness": 0.1,
"silk_text_upright": false,
"zones": {
"min_clearance": 0.5
}
},
"diff_pair_dimensions": [],
"drc_exclusions": [],
"meta": {
"version": 2
},
"rule_severities": {
"annular_width": "error",
"clearance": "error",
"connection_width": "warning",
"copper_edge_clearance": "error",
"copper_sliver": "warning",
"courtyards_overlap": "error",
"diff_pair_gap_out_of_range": "error",
"diff_pair_uncoupled_length_too_long": "error",
"drill_out_of_range": "error",
"duplicate_footprints": "warning",
"extra_footprint": "warning",
"footprint": "error",
"footprint_symbol_mismatch": "warning",
"footprint_type_mismatch": "ignore",
"hole_clearance": "error",
"hole_near_hole": "error",
"holes_co_located": "warning",
"invalid_outline": "error",
"isolated_copper": "warning",
"item_on_disabled_layer": "error",
"items_not_allowed": "error",
"length_out_of_range": "error",
"lib_footprint_issues": "warning",
"lib_footprint_mismatch": "warning",
"malformed_courtyard": "error",
"microvia_drill_out_of_range": "error",
"missing_courtyard": "ignore",
"missing_footprint": "warning",
"net_conflict": "warning",
"npth_inside_courtyard": "ignore",
"padstack": "warning",
"pth_inside_courtyard": "ignore",
"shorting_items": "error",
"silk_edge_clearance": "warning",
"silk_over_copper": "warning",
"silk_overlap": "warning",
"skew_out_of_range": "error",
"solder_mask_bridge": "error",
"starved_thermal": "error",
"text_height": "warning",
"text_thickness": "warning",
"through_hole_pad_without_hole": "error",
"too_many_vias": "error",
"track_dangling": "warning",
"track_width": "error",
"tracks_crossing": "error",
"unconnected_items": "error",
"unresolved_variable": "error",
"via_dangling": "warning",
"zones_intersect": "error"
},
"rules": {
"max_error": 0.005,
"min_clearance": 0.0,
"min_connection": 0.0,
"min_copper_edge_clearance": 0.5,
"min_hole_clearance": 0.25,
"min_hole_to_hole": 0.25,
"min_microvia_diameter": 0.2,
"min_microvia_drill": 0.1,
"min_resolved_spokes": 2,
"min_silk_clearance": 0.0,
"min_text_height": 0.8,
"min_text_thickness": 0.08,
"min_through_hole_diameter": 0.3,
"min_track_width": 0.0,
"min_via_annular_width": 0.1,
"min_via_diameter": 0.5,
"solder_mask_to_copper_clearance": 0.0,
"use_height_for_length_calcs": true
},
"teardrop_options": [
{
"td_onpadsmd": true,
"td_onroundshapesonly": false,
"td_ontrackend": false,
"td_onviapad": true
}
],
"teardrop_parameters": [
{
"td_allow_use_two_tracks": true,
"td_curve_segcount": 0,
"td_height_ratio": 1.0,
"td_length_ratio": 0.5,
"td_maxheight": 2.0,
"td_maxlen": 1.0,
"td_on_pad_in_zone": false,
"td_target_name": "td_round_shape",
"td_width_to_size_filter_ratio": 0.9
},
{
"td_allow_use_two_tracks": true,
"td_curve_segcount": 0,
"td_height_ratio": 1.0,
"td_length_ratio": 0.5,
"td_maxheight": 2.0,
"td_maxlen": 1.0,
"td_on_pad_in_zone": false,
"td_target_name": "td_rect_shape",
"td_width_to_size_filter_ratio": 0.9
},
{
"td_allow_use_two_tracks": true,
"td_curve_segcount": 0,
"td_height_ratio": 1.0,
"td_length_ratio": 0.5,
"td_maxheight": 2.0,
"td_maxlen": 1.0,
"td_on_pad_in_zone": false,
"td_target_name": "td_track_end",
"td_width_to_size_filter_ratio": 0.9
}
],
"track_widths": [],
"tuning_pattern_settings": {
"diff_pair_defaults": {
"corner_radius_percentage": 80,
"corner_style": 1,
"max_amplitude": 1.0,
"min_amplitude": 0.2,
"single_sided": false,
"spacing": 1.0
},
"diff_pair_skew_defaults": {
"corner_radius_percentage": 80,
"corner_style": 1,
"max_amplitude": 1.0,
"min_amplitude": 0.2,
"single_sided": false,
"spacing": 0.6
},
"single_track_defaults": {
"corner_radius_percentage": 80,
"corner_style": 1,
"max_amplitude": 1.0,
"min_amplitude": 0.2,
"single_sided": false,
"spacing": 0.6
}
},
"via_dimensions": [],
"zones_allow_external_fillets": false
},
"ipc2581": {
"dist": "",
"distpn": "",
"internal_id": "",
"mfg": "",
"mpn": ""
},
"layer_presets": [],
"viewports": []
},
"boards": [],
"cvpcb": {
"equivalence_files": []
},
"erc": {
"erc_exclusions": [],
"meta": {
"version": 0
},
"pin_map": [
[
0,
0,
0,
0,
0,
0,
1,
0,
0,
0,
0,
2
],
[
0,
2,
0,
1,
0,
0,
1,
0,
2,
2,
2,
2
],
[
0,
0,
0,
0,
0,
0,
1,
0,
1,
0,
1,
2
],
[
0,
1,
0,
0,
0,
0,
1,
1,
2,
1,
1,
2
],
[
0,
0,
0,
0,
0,
0,
1,
0,
0,
0,
0,
2
],
[
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
2
],
[
1,
1,
1,
1,
1,
0,
1,
1,
1,
1,
1,
2
],
[
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
2
],
[
0,
2,
1,
2,
0,
0,
1,
0,
2,
2,
2,
2
],
[
0,
2,
0,
1,
0,
0,
1,
0,
2,
0,
0,
2
],
[
0,
2,
1,
1,
0,
0,
1,
0,
2,
0,
0,
2
],
[
2,
2,
2,
2,
2,
2,
2,
2,
2,
2,
2,
2
]
],
"rule_severities": {
"bus_definition_conflict": "error",
"bus_entry_needed": "error",
"bus_to_bus_conflict": "error",
"bus_to_net_conflict": "error",
"conflicting_netclasses": "error",
"different_unit_footprint": "error",
"different_unit_net": "error",
"duplicate_reference": "error",
"duplicate_sheet_names": "error",
"endpoint_off_grid": "warning",
"extra_units": "error",
"global_label_dangling": "warning",
"hier_label_mismatch": "error",
"label_dangling": "error",
"lib_symbol_issues": "warning",
"missing_bidi_pin": "warning",
"missing_input_pin": "warning",
"missing_power_pin": "error",
"missing_unit": "warning",
"multiple_net_names": "warning",
"net_not_bus_member": "warning",
"no_connect_connected": "warning",
"no_connect_dangling": "warning",
"pin_not_connected": "error",
"pin_not_driven": "error",
"pin_to_pin": "warning",
"power_pin_not_driven": "error",
"similar_labels": "warning",
"simulation_model_issue": "ignore",
"unannotated": "error",
"unit_value_mismatch": "error",
"unresolved_variable": "error",
"wire_dangling": "error"
}
},
"libraries": {
"pinned_footprint_libs": [],
"pinned_symbol_libs": []
},
"meta": {
"filename": "macropad.kicad_pro",
"version": 1
},
"net_settings": {
"classes": [
{
"bus_width": 12,
"clearance": 0.2,
"diff_pair_gap": 0.25,
"diff_pair_via_gap": 0.25,
"diff_pair_width": 0.2,
"line_style": 0,
"microvia_diameter": 0.3,
"microvia_drill": 0.1,
"name": "Default",
"pcb_color": "rgba(0, 0, 0, 0.000)",
"schematic_color": "rgba(0, 0, 0, 0.000)",
"track_width": 0.2,
"via_diameter": 0.6,
"via_drill": 0.3,
"wire_width": 6
}
],
"meta": {
"version": 3
},
"net_colors": null,
"netclass_assignments": null,
"netclass_patterns": []
},
"pcbnew": {
"last_paths": {
"gencad": "",
"idf": "",
"netlist": "",
"plot": "gerbers/",
"pos_files": "",
"specctra_dsn": "",
"step": "macropad.step",
"svg": "",
"vrml": ""
},
"page_layout_descr_file": ""
},
"schematic": {
"annotate_start_num": 0,
"bom_export_filename": "",
"bom_fmt_presets": [],
"bom_fmt_settings": {
"field_delimiter": ",",
"keep_line_breaks": false,
"keep_tabs": false,
"name": "CSV",
"ref_delimiter": ",",
"ref_range_delimiter": "",
"string_delimiter": "\""
},
"bom_presets": [],
"bom_settings": {
"exclude_dnp": false,
"fields_ordered": [
{
"group_by": false,
"label": "Reference",
"name": "Reference",
"show": true
},
{
"group_by": true,
"label": "Value",
"name": "Value",
"show": true
},
{
"group_by": false,
"label": "Datasheet",
"name": "Datasheet",
"show": true
},
{
"group_by": false,
"label": "Footprint",
"name": "Footprint",
"show": true
},
{
"group_by": false,
"label": "Qty",
"name": "${QUANTITY}",
"show": true
},
{
"group_by": true,
"label": "DNP",
"name": "${DNP}",
"show": true
},
{
"group_by": false,
"label": "#",
"name": "${ITEM_NUMBER}",
"show": false
},
{
"group_by": false,
"label": "Description",
"name": "Description",
"show": false
}
],
"filter_string": "",
"group_symbols": true,
"name": "",
"sort_asc": true,
"sort_field": "Reference"
},
"connection_grid_size": 50.0,
"drawing": {
"dashed_lines_dash_length_ratio": 12.0,
"dashed_lines_gap_length_ratio": 3.0,
"default_line_thickness": 6.0,
"default_text_size": 50.0,
"field_names": [],
"intersheets_ref_own_page": false,
"intersheets_ref_prefix": "",
"intersheets_ref_short": false,
"intersheets_ref_show": false,
"intersheets_ref_suffix": "",
"junction_size_choice": 3,
"label_size_ratio": 0.375,
"operating_point_overlay_i_precision": 3,
"operating_point_overlay_i_range": "~A",
"operating_point_overlay_v_precision": 3,
"operating_point_overlay_v_range": "~V",
"overbar_offset_ratio": 1.23,
"pin_symbol_size": 25.0,
"text_offset_ratio": 0.15
},
"legacy_lib_dir": "",
"legacy_lib_list": [],
"meta": {
"version": 1
},
"net_format_name": "",
"page_layout_descr_file": "",
"plot_directory": "",
"spice_current_sheet_as_root": false,
"spice_external_command": "spice \"%I\"",
"spice_model_current_sheet_as_root": true,
"spice_save_all_currents": false,
"spice_save_all_dissipations": false,
"spice_save_all_voltages": false,
"subpart_first_id": 65,
"subpart_id_separator": 0
},
"sheets": [
[
"0af5a7ac-2ebe-4b07-b046-3ef4da363265",
"Root"
]
],
"text_variables": {}
}

3379
hackpads/Yet Another Hackpad/PCB/macropad.kicad_sch Normal file
View file

File diff suppressed because it is too large Load diff

BIN
hackpads/Yet Another Hackpad/PCB/silkscreen/gopher.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 17 KiB

52
hackpads/Yet Another Hackpad/README.md Normal file
View file

@ -0,0 +1,52 @@
# Yet Another Hackpad
Yet Another Hackpad is a 4 key macropad with a rotary encoder and LEDs.
## Features
- 4 Keys
- 4 SK6812 Mini Addressable RGB LEDs
- EC11 Rotary Encoder
## CAD Model
<img src=assets/cad.png alt="CAD" width="500"/>
<img src=assets/cad2.png alt="CAD" width="500"/>
## PCB
Schematic
<img src=assets/schematic.png alt="Schematic" width="500"/>
PCB
<img src=assets/pcb.png alt="PCB" width="500"/>
<img src=assets/rendered_pcb.png alt="Rendered PCB" width="500" />
Silkscreen Credit: [Go Gopher](https://go.googlesource.com/website/+/refs/heads/master/_content/doc/gopher/frontpage.png) by Renee French, used under [CC BY 4.0](http://creativecommons.org/licenses/by/4.0/)
## Firmware
The firmware is written using kmk
## Inspiration
I usually have my laptop docked to an external keyboard when working, but the keyboard doesn't have the function keys that the laptop keyboard does. I also often find myself forgetting shortcuts, so I made this so I could work more efficiently.
## Challenges
I haven't done any PCB design before, so it took a while to get accustomed to KiCAD, and figure out to import all the necessary libraries and export the board to my CAD program.
## BOM
- 1 Seeed XIAO RP2040
- 1 EC11 Rotary Encoder
- 4 MX-Style switches
- 4 White Keycaps
- 4 Reverse Mount SK6812 MINI-E LEDs
- 4 M3 hex nuts
- 4 M3x16mm screws
- 1 3D Printed Case (2 parts)

BIN
hackpads/Yet Another Hackpad/assets/cad.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 204 KiB

BIN
hackpads/Yet Another Hackpad/assets/cad2.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 132 KiB

BIN
hackpads/Yet Another Hackpad/assets/pcb.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 102 KiB

BIN
hackpads/Yet Another Hackpad/assets/rendered_pcb.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 311 KiB

BIN
hackpads/Yet Another Hackpad/assets/schematic.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 53 KiB

49
hackpads/Yet Another Hackpad/firmware/main.py Normal file
View file

@ -0,0 +1,49 @@
import board
from kmk.kmk_keyboard import KMKKeyboard
from kmk.scanners.keypad import KeysScanner
from kmk.keys import KC
from kmk.modules.macros import Press, Release, Tap, Macros
from kmk.modules.encoder import EncoderHandler
from kmk.extensions.RGB import RGB
from kmk.extensions.media_keys import MediaKeys
keyboard.extensions.append(MediaKeys())
keyboard = KMKKeyboard()
macros = Macros()
keyboard.modules.append(macros)
encoder_handler = EncoderHandler()
keyboard.modules.append(encoder_handler)
rgb = RGB(pixel_pin=board.D4, num_pixels=4, hue_default=100, sat_default=255, val_default=15)
keyboard.extensions.append(rgb)
PINS = [board.D10, board.D9, board.D8, board.D7]
keyboard.matrix = KeysScanner(
pins=PINS,
value_when_pressed=False,
)
encoder_handler.pins = (
(board.D2, board.D1, board.D0,)
)
encoder_handler.map = [
((KC.VOLD, KC.VOLU, KC.MUTE),),
]
keyboard.keymap = [
[
KC.MEDIA_PLAY_PAUSE,
KC.MEDIA_NEXT_TRACK,
KC.MACRO(Press(KC.LGUI), Tap(KC.ENTER), Release(KC.LGUI)), # Open Terminal
KC.MACRO(Press(KC.LALT), Tap(KC.E), Release(KC.LALT)), # Open Nautilus
]
]
if __name__ == '__main__':
keyboard.go()

12612
hackpads/Yet Another Hackpad/production/Bottom.step Normal file
View file

File diff suppressed because it is too large Load diff

13035
hackpads/Yet Another Hackpad/production/Top.step Normal file
View file

File diff suppressed because it is too large Load diff

BIN
hackpads/Yet Another Hackpad/production/gerbers.zip Normal file
View file

Binary file not shown.

49
hackpads/Yet Another Hackpad/production/main.py Normal file
View file

@ -0,0 +1,49 @@
import board
from kmk.kmk_keyboard import KMKKeyboard
from kmk.scanners.keypad import KeysScanner
from kmk.keys import KC
from kmk.modules.macros import Press, Release, Tap, Macros
from kmk.modules.encoder import EncoderHandler
from kmk.extensions.RGB import RGB
from kmk.extensions.media_keys import MediaKeys
keyboard.extensions.append(MediaKeys())
keyboard = KMKKeyboard()
macros = Macros()
keyboard.modules.append(macros)
encoder_handler = EncoderHandler()
keyboard.modules.append(encoder_handler)
rgb = RGB(pixel_pin=board.D4, num_pixels=4, hue_default=100, sat_default=255, val_default=15)
keyboard.extensions.append(rgb)
PINS = [board.D10, board.D9, board.D8, board.D7]
keyboard.matrix = KeysScanner(
pins=PINS,
value_when_pressed=False,
)
encoder_handler.pins = (
(board.D2, board.D1, board.D0,)
)
encoder_handler.map = [
((KC.VOLD, KC.VOLU, KC.MUTE),),
]
keyboard.keymap = [
[
KC.MEDIA_PLAY_PAUSE,
KC.MEDIA_NEXT_TRACK,
KC.MACRO(Press(KC.LGUI), Tap(KC.ENTER), Release(KC.LGUI)), # Open Terminal
KC.MACRO(Press(KC.LALT), Tap(KC.E), Release(KC.LALT)), # Open Nautilus
]
]
if __name__ == '__main__':
keyboard.go()