Skip to content

Enables an analog joystick and assistive switches to emulate an HID Mouse or HID Gamepad. Open source assistive technology.

Notifications You must be signed in to change notification settings

makersmakingchange/Forest-Joystick-Mouse-Hub

Repository files navigation

Forest Joystick Mouse Hub

The Forest Hub enables a user to connect an analog joystick and up to four assistive switches to emulate a USB Mouse or USB Gamepad. As a USB Mouse, the joystick controls cursor movement and the assistive switches activate the left mouse button, right mouse button, middle mouse button, and scroll. As a USB Mouse, the joystick maps to the joystick/thumbstick and the assistive switches map to the joystick buttons. An additional assistive switch can be attached to the Hub to cycle between three setting slots and change the output mode between USB Mouse mode and USB Gamepad mode.

The device is comprised of a custom printed circuit board, off-the-shelf electronics, and 3D printed parts. The overall cost of materials for a single build is about $100. The individual unit cost cost is closer to $55.

The Forest Hub is open assistive technology (OpenAT). Under the terms of the open source licenses, the device may be built, used, and improved upon by anyone.

Last updated: 2024-Apr-17 The latest version (V2.1) includes a new easier to use LED jig, updated firmware with center calibration, and updated documentation. An updated version of the PCB and enclosure has been released (V2.0.1, 2024-Feb-20). The last version of the Forest Hub (v2.0.1) has been built and tested.

A Forest Hub in a red enclosure.

MMC Assistive Device Library Listing: https://makersmakingchange.com/s/product/forest-joystick-mouse-hub/01tJR000000E4bdYAC

OpenAT Joysticks

This design is part of the OpenAT Joystick Project, a collection of open source designs for digital access and adapted gaming.

How to Obtain the Device

1. Do-it-Yourself (DIY) or Do-it-Together (DIT)

This is an open-source assistive technology, so anyone is free to build it. All of the files and instructions required to build the device are contained within this repository. Refer to the Maker Guide below.

2. Request a build of this device

If you would like to obtain a Forest Hub, you may submit a build request through the MMC Assistive Device Library Listing to have a volunteer maker build the device. As the requestor, you are responsible for reimbursing the maker for the cost of materials and any shipping.

3. Build this device for someone else

If you have the skills and equipment to build this device, and would like to donate your time to create the switch for someone who needs it, visit the MMC Maker Wanted section.

Build Instructions

1. Read through the Maker Guide

The Maker Guide contains all the necessary information to build the device.

2. Use the Maker Checklist

Use the Maker Checklist in the Maker Guide to confirm details and customization options with the user.

3. Order the Custom Printed Circuit Board (PCB)

The manufacturing files for the PCB are located in the PCB_Build_Files folder.

4. Order the Off-The-Shelf Components

The Bill of Materials lists all of the parts and 3D printed components required to build the device.

5. Print the 3D Printable components

The print files can be found in the /Build_Files/3D_Printing_Files folder.

6. Assemble the Device

Reference the Assembly Guide section in the Maker Guide for the tools and steps required to build the device.

Files

Documentation

Document Version Link
Design Rationale 2.1 Forest_Hub_Design_Rationale
Maker Guide 2.1 Forest_Hub_Maker_Guide
Bill of Materials 2.1 Forest_Hub_Bill_of_Materials
User Guide 2.1 Forest_Hub_User_Guide
Changelog 2.1 Changes

Design Files

Build Files

License

Copyright (c) 2023 Neil Squire Society.

This repository describes Open Hardware:

You may redistribute and modify this documentation and make products using it under the terms of the CERN-OHL-W v2. This documentation is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY, INCLUDING OF MERCHANTABILITY, SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE. Please see the CERN-OHL-W v2 for applicable conditions.

Source Location: https://github.com/makersmakingchange/Forest-Joystick-Mouse-Hub

List of open source licenses. Hardware: CERN-OHL-W-2.0, Software: GPL-3.0-or-later, Documentation: CC-BY-SA-4.0.

Attribution

The Adafruit QT Py development board was designed by Limor Fried/Ladyada from Adafruit. The PCB design is available open source under a CC-BY-SA license.

The concept for the Forest Hub was based on the Enabled Controller Mini by Milador.

Contributors

  • Jake McIvor, Neil Squire Society. Concept generation, enclosure design, schematic and PCB design, coding, documentation, testing.
  • Milad Ha, Neil Squire Society. Schematic and PCB design, coding.
  • Josie Versloot, Neil Squire Society. Concept generation, coding, documentation.
  • Derrick Andrews, Neil Squire Society. Schematic design.
  • Stephen Moyer, Neil Squire Society. Concept generation.
  • Tyler Fentie, Neil Squire Society. Concept generation

Open Source Hardware Certification

The Forest Hub has been certified as open source hardware by the Open Source Hardware Association under the OSHWA UID CA000033.

Open Source Hardware Certification Mark for Forest Hub: CA000033

---

About Makers Making Change

Makers Making Change Logo

Makers Making Change is a program of Neil Squire, a Canadian non-profit that uses technology, knowledge, and passion to empower people with disabilities.

Makers Making Change leverages the capacity of community based Makers, Disability Professionals and Volunteers to develop and deliver affordable Open Source Assistive Technologies.

Contact Us

For technical questions, to get involved, or to share your experience we encourage you to visit our website or contact us.

About

Enables an analog joystick and assistive switches to emulate an HID Mouse or HID Gamepad. Open source assistive technology.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published