Haptic Pad

Haptic Pad

Một macropad 6 nút có màn hình để hiển thị nhãn nút và icon, kèm núm xoay chuột có phản hồi haptic!

Link video dự án

Tính năng

• 6 nút Macro lập trình được

• Màn hình OLED 128x64 để hiển thị nhãn nút và icon

• Hỗ trợ tối đa 256 profile, tổng cộng 1536 Macro!

• Cấu hình XML dễ làm, không cần driver đặc biệt!

• Có thể cấu hình tổ hợp Macro với tối đa 3 nút nhấn đồng thời, hoặc 3 lần nhấn tách rời với độ trễ giữa các lần nhấn có thể chỉnh.

• Lưu trữ Micro SD cho nhãn nút và file cấu hình.

• Núm cuộn chuột phản hồi haptic với 3 chế độ: Clicky, Twist và Momentum

• Vòng RGB chỉnh được màu và 5 chế độ hiển thị: Halo, Bands, Breath, Rainbow, Solid và Off.

• Chuyển profile dễ dàng bằng nút lên/xuống profile hoặc hiển thị danh sách profile.

• Profile dùng lần cuối sẽ được lưu vào thẻ SD để macropad khởi động đúng profile đang dùng trước đó.

Bill of Materials

1x Màn hình OLED 128x64 - https://www.waveshare.com/2.42inch-oled-module.htm

1x Magnetic Encoder Board - https://www.aliexpress.com/item/1005007469177411.html

1x Motor brushless gimbal 2804 100kv - https://www.aliexpress.com/item/1005006008489660.html

6x Kailh Low Profile Switches - https://www.aliexpress.com/item/1005005066585322.html

1x RP2040-Plus Board - https://www.waveshare.com/rp2040-plus.htm

1x TMC6300 Motor Driver Board - https://www.sparkfun.com/sparkfun-brushless-motor-driver-3-phase-tmc6300.html

1x Module Micro SD - https://www.aliexpress.com/item/1005010587984346.html

4x Nam châm 6x1mm - https://www.aliexpress.com/item/1005009894772141.html

2x Nút tactile - https://www.digikey.com/en/products/detail/panasonic-electronic-components/EVQ-Q2B03W/762882

Các món sau là tuỳ chọn nếu bạn muốn gắn LED:

20x WS2811 LED's - https://www.aliexpress.com/item/32776731877.html

20x Tụ 0.1uF (100nF) 0603 - https://www.aliexpress.com/item/32966526545.html

Phần cứng (Hardware)

9x Insert ren M3x5x5 (chỉ cần nếu dùng vỏ in 3D)

3x Ốc M3x6 SHCS

2x Ốc M3x10 SHCS

10x Ốc M2.5x4 SHCS

4x Ốc M3x6 CSK

Hướng dẫn in (Printing Instructions)

- Bản in 3D (Printed version)

In tất cả file trong thư mục 3D Files/STL's. Bạn sẽ cần 6 cái file keycap, 2 cái file Menu button và 2 cái file PCB spacer.

- Bản gia công (Machined Version)

In tất cả file trong thư mục 3D Files/STL's, trừ: "Custom Keycap.STL", "Macro Pad - Printed Version.STL" và "Menu Button Printed.STL". Mang toàn bộ file .STEP trong thư mục 3D Files/STEP đi gia công. Đừng lấy file Macropad Assembly .STEP trong thư mục gốc vì đó là model tổng của Macro Pad chứ không phải từng chi tiết rời. Nếu bạn gửi kèm file MacroPad Housing.PDF với phần vỏ, bạn có thể nhờ họ ta-rô (tapped) luôn các lỗ bắt vít.

Lắp motor (Motor Assembly)

Mình làm hình nhanh để minh hoạ cách lắp motor cho bánh xe:

Phần "Encoder Mount.STL" có 2 lỗ nhỏ, dự kiến ta-rô ren M2 để bắt encoder. Nếu bạn không có taro M2, bạn có thể dán encoder vào mount, hoặc dùng vít tự ren cỡ nhỏ để cố định.

Cái giá giữ nam châm nên khít vừa trong trục motor rỗng. Nếu chưa khít, mình khuyên nhỏ một giọt keo 502 (super glue) để đảm bảo về lâu dài không bị tuột.

PCB's

Phần mềm (Software)

Cảnh báo

Phần mềm vẫn đang trong quá trình hoàn thiện. Hiện tại mọi thứ chạy được, nhưng chắc chắn mình sẽ còn sót bug vì mới test giới hạn. Mình sẽ cố gắng xử lý càng nhiều bug càng tốt trong vài tuần tới, nhưng nếu bạn gặp lỗi thì báo mình biết nha! Nếu bạn định gửi issue về bug, vui lòng mô tả lại các bước để tái hiện lỗi vì như vậy sẽ dễ sửa hơn nhiều.

Nếu bạn không muốn tự compile code, chỉ cần copy bản mới nhất của file MacroPad.UF2 trong thư mục software và nạp trực tiếp vào bộ nhớ Pico bằng cách vào boot như trong video.

Bạn cũng cần chuẩn bị thẻ SD đúng cách để dùng macropad. Trước tiên, hãy copy toàn bộ nội dung trong thư mục "Example SD Card" vào thẻ SD để kiểm tra mọi thứ hoạt động ổn, rồi hẵng bắt đầu tuỳ biến file của bạn.

Cấu hình XML (XML Config)

Trong thẻ <Settings> của file XML bạn sẽ thấy toàn bộ thiết lập cho LED, cùng với thông số tuning P và I cho các chế độ bánh xe.

Có 6 giá trị hợp lệ cho thẻ <LED_Mode>. Nếu bạn gõ sai chính tả thì lệnh sẽ không chạy, nên tốt nhất copy/paste từ đây:

Breath, Bands, Halo, Rainbow, Solid, Off

<LED_Primary> và <LED_Secondary> là 2 màu dùng trong hiệu ứng, định dạng theo thứ tự Red, Green, Blue với giá trị từ 0-255. Rainbow và Off hiển nhiên không dùng các tuỳ chọn màu này; còn Solid thì chỉ đặt màu theo <LED_Primary> và bỏ qua <LED_Secondary>.

Phần tuning motor cho bản bánh xe in 3D nhìn chung đã khá ổn, nên bạn cứ thử dùng các giá trị P và I mặc định của mình trước khi tự tuning. Mình bỏ tuỳ chọn D vì với kiểu feedback này có vẻ không cần, và chỉ làm việc tuning phức tạp hơn.

Trong thẻ <Profiles> là nơi lưu từng profile.

Mỗi profile bắt đầu bằng một giá trị tên kiểu như: <Profile name="Solidworks"> Sau đó sẽ có thẻ <WheelMode> và <WheelKey>. <WheelKey> có thể là bất kỳ key value nào từ website này https://keycode-visualizer.netlify.app/ và sẽ được giữ (held down) khi bánh xe đang xoay. <WheelMode> chỉ có thể là 1 trong 3 giá trị: Clicky, Twist hoặc Momentum. Mấy chữ này cũng phải đúng y chang, nên hãy copy/paste từ đây để chắc chắn hoạt động.

Tiếp theo là thẻ <MacroButtons> chứa toàn bộ nút Macro cho profile.

Mỗi nút macro sẽ có dạng như sau:

<MacroButton>
    <Action>0,68</Action>
    <Action>0,0</Action>
    <Action>0,0</Action>
    <Label>Dimension</Label>
</MacroButton>

Mỗi profile sẽ có 6 đoạn như vậy. Mỗi Action có 2 giá trị: giá trị đầu là độ trễ (tính bằng milliseconds) trước khi thực hiện action, sau đó là keycode bạn muốn nhấn (dùng cùng website mình đã link ở trên). Nếu bạn đặt cả hai giá trị này thành 0 cho bất kỳ trong 3 action thì action đó sẽ không làm gì. Label đơn giản là tên sẽ hiện trên màn hình cho nút đó.

Vậy là xong! Bạn chỉ cần nhân bản profile mẫu đầu tiên đó bao nhiêu lần tuỳ thích (tối đa 256 lần), và mỗi cái sẽ tạo ra một profile mới để bạn lưu macro của mình.