TeamOpenFIRE/OpenFIRE-Firmware

🎮 OpenFIRE Firmware — Súng bắn ánh sáng mã nguồn mở trên RP2040/RP2350

Firmware tham chiếu cho dự án OpenFIRE, kế thừa từ IR-GUN4ALL, tối ưu cho vi điều khiển RP2040/RP2350 với hai nhân, hỗ trợ force feedback solenoid/rumble, theo dõi IR đa bố cục, và cấu hình trực quan qua OpenFIRE App.

OpenFIRE Firmware là phần mềm nhúng (firmware) tham chiếu của dự án OpenFIRE — Open Four Infa-Red Emitter Light Gun System, một hệ thống súng bắn ánh sáng (light gun) hoàn toàn mã nguồn mở. Dự án là người kế thừa trực tiếp của IR-GUN4ALL (của SeongGino), vốn dựa trên nhánh Prow Enhanced của ir-light-gun, và cuối cùng bắt nguồn từ dự án SAMCO "4IR Beta Big Code Update". Firmware được viết bằng C++ và chạy trên các vi điều khiển RP2040 hoặc RP2350 (Raspberry Pi Pico, Pico W, Adafruit KB2040, ItsyBitsy RP2040, v.v.), tận dụng hai nhân CPU: nhân 0 xử lý camera IR và ngoại vi, nhân 1 lo polling input, hàng đợi và giao tiếp serial.

✨ Điểm nổi bật

• Force Feedback đầy đủ: Hỗ trợ solenoid (độn/giật) và motor rung (rumble) 5V, kèm board driver tham chiếu (OSH Park), cho trải nghiệm arcade thực tế.
• Theo dõi IR đa bố cục, hiệu chỉnh góc nhìn thời gian thực: Hỗ trợ hai thanh IR song song (khuyên dùng) và bố cục kim cương kiểu Xwiigun, tương thích với các hệ thống khác.
• Hệ thống Input linh hoạt: Xuất ra Keyboard, chuột ABS 5 nút (tọa độ tuyệt đối), gamepad hai joystick có D-pad; có hệ thống ánh xạ nút bấm (button mapping) mạnh mẽ tùy chỉnh theo ý muốn.
• Cài đặt cực đơn giản qua UF2: Kéo-thả file .uf2 từ trang Releases vào ổ RPI-RP2 khi board ở chế độ Bootloader (giữ BOOTSEL khi cắm USB).
• Cài đặt lưu trữ trên board: Lưu profile校准 (calibration), bật/tắt tính năng, định danh USB, v.v. — mang theo khi đổi máy.
• Tích hợp OpenFIRE App (Desktop): Ứng dụng đa nền tảng cho cấu hình trực quan, thay đổi thiết lập "on-the-fly" mà không cần nạp lại firmware.
• Tối ưu hai nhân RP2040/RP2350: Nhân thứ hai lo input polling, queuing, serial; nhân chính lo camera và ngoại vi.
• Tương thích trình xử lý Force Feedback PC: Mame Hooker, The Hook Of The Reaper, QMamehook.
• Hỗ trợ màn hình OLED SSD1306 I2C 128x64: Hiển thị menu, máu, đạn, trạng thái trong game.
• Tích hợp MiSTer FPGA: Ánh xạ chuyên biệt cho trải nghiệm mượt mà trên hệ sinh thái MiSTer.
• Miễn phí, mã nguồn mở vĩnh viễn cho cộng đồng light gun.

💡 Vì sao đáng chú ý

OpenFIRE không chỉ là một firmware nạp vào board — nó là toàn bộ hệ sinh thái DIY light gun từ phần cứng (camera IR DFRobot SEN0158, 4 LED IR SFH 4547, solenoid, rumble, NeoPixel, OLED) đến phần mềm (firmware tối ưu dual-core, app desktop cấu hình, tương thích FFB PC, MiSTer). Việc tách xử lý camera/input lên hai nhân RP2040 giải quyết được vấn đề độ trễ (latency) mà các dự án đơn nhân thường gặp. Hệ thống button mapping và profile lưu trên board cho phép người dùng mang súng sang máy khác cắm là chơi ngay. Tích hợp OLED hiển thị máu/đạn trong game là chi tiết nhỏ nhưng nâng trải nghiệm arcade lên tầm cao mới. Dự án phù hợp cho người tự lắp ráp (DIY) muốn súng light gun giá rẻ, mở, tùy biến được, và chạy được trên PC cũng như MiSTer FPGA.

#OpenFIRE #LightGun #RP2040 #RP2350 #DIY #ForceFeedback #OpenSource #TiniX