From 8a01d89bb75b2a4dc565d74d29661a72f53a2b6b Mon Sep 17 00:00:00 2001
From: JohhnGoblin <35317840+JohnDGodwin@users.noreply.github.com>
Date: Sun, 5 Jan 2025 01:08:05 -0600
Subject: [PATCH] Add files via upload
---
.../ArduinoJoystickLibrary/CONTRIBUTING.md | 28 +
.../ArduinoJoystickLibrary/LICENSE | 165 ++++
.../ArduinoJoystickLibrary/README.md | 234 ++++++
.../ArcadeStickExample/ArcadeStickExample.ino | 173 +++++
.../DrivingControllerTest.ino | 153 ++++
.../FlightControllerTest.ino | 181 +++++
.../FunduinoJoystickShield.ino | 85 +++
.../GamepadExample/GamepadExample.ino | 91 +++
.../examples/HatSwitchTest/HatSwitchTest.ino | 95 +++
.../JoystickButton/JoystickButton.ino | 50 ++
.../JoystickKeyboard/JoystickKeyboard.ino | 63 ++
.../examples/JoystickTest/JoystickTest.ino | 265 +++++++
.../MultipleJoystickTest.ino | 180 +++++
.../ArduinoJoystickLibrary/library.properties | 9 +
.../src/DynamicHID/DynamicHID.cpp | 169 +++++
.../src/DynamicHID/DynamicHID.h | 144 ++++
.../src/JoystickMHX.cpp | 716 ++++++++++++++++++
.../ArduinoJoystickLibrary/src/JoystickMHX.h | 241 ++++++
.../photo_2023-03-30_04-58-32.jpg | Bin 0 -> 91648 bytes
.../sbus-to-usb-joystick/readme.md | 13 +
.../sbus-inverter-diagram-schematics.jpg | Bin 0 -> 70917 bytes
.../sbus-to-usb-joystick.ino | 73 ++
.../sbus-to-usb-joystick/sbus.cpp | 291 +++++++
.../sbus-to-usb-joystick/sbus.h | 149 ++++
.../translated_readme.txt | 13 +
25 files changed, 3581 insertions(+)
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/CONTRIBUTING.md
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/LICENSE
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/README.md
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/ArcadeStickExample/ArcadeStickExample.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/DrivingControllerTest/DrivingControllerTest.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FlightControllerTest/FlightControllerTest.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FunduinoJoystickShield/FunduinoJoystickShield.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/GamepadExample/GamepadExample.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/HatSwitchTest/HatSwitchTest.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickButton/JoystickButton.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickKeyboard/JoystickKeyboard.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickTest/JoystickTest.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/MultipleJoystickTest/MultipleJoystickTest.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/library.properties
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.cpp
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.h
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.cpp
create mode 100644 translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.h
create mode 100644 translated_sandbox/sbus-to-usb-joystick/photo_2023-03-30_04-58-32.jpg
create mode 100644 translated_sandbox/sbus-to-usb-joystick/readme.md
create mode 100644 translated_sandbox/sbus-to-usb-joystick/sbus-inverter-diagram-schematics.jpg
create mode 100644 translated_sandbox/sbus-to-usb-joystick/sbus-to-usb-joystick.ino
create mode 100644 translated_sandbox/sbus-to-usb-joystick/sbus.cpp
create mode 100644 translated_sandbox/sbus-to-usb-joystick/sbus.h
create mode 100644 translated_sandbox/sbus-to-usb-joystick/translated_readme.txt
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/CONTRIBUTING.md b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/CONTRIBUTING.md
new file mode 100644
index 0000000..6cb08fa
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/CONTRIBUTING.md
@@ -0,0 +1,28 @@
+## How to contribute to the Arduino Joystick Library
+
+### Report a bug
+
+* **Check to see if the bug has already reported** by searching on GitHub under [Issues](https://github.com/MHeironimus/ArduinoJoystickLibrary/issues).
+
+* If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/MHeironimus/ArduinoJoystickLibrary/issues/new). Be sure to include a **title and clear description**, as much relevant information as possible (e.g. host OS, Arduino IDE version, etc.), any important hardware information (e.g. name of Arduino board being used, specific pin wirings if they are relavant, etc.), and a **sample sketch** file demonstrating the issue.
+
+### Fix a bug
+
+* Open a new GitHub pull request with the fix.
+
+* Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
+
+### Whitespace, format code, or cosmetic updates
+
+* Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability will generally not be accepted.
+
+### Adding a new feature
+
+* Feel free to [create a new issue](https://github.com/MHeironimus/ArduinoJoystickLibrary/issues/new) to document the feature you are planning to add. This will allow others to see and comment on what you would plan to add to the library.
+
+### Questions about the library
+
+* Be sure to check the [FAQ](https://github.com/MHeironimus/ArduinoJoystickLibrary/wiki/FAQ) in the [Wiki](https://github.com/MHeironimus/ArduinoJoystickLibrary/wiki) to see if your question has already been answered.
+* Another good place to look for general Arduino questions is the [Arduino]() website.
+
+The Arduino Joystick Library is a volunteer effort done in volunteer's spare time. Please be patient as it may take some time for bugs to be fixed, features to be added, and questions to be answered.
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/LICENSE b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/LICENSE
new file mode 100644
index 0000000..65c5ca8
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/LICENSE
@@ -0,0 +1,165 @@
+ GNU LESSER GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+ This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+ 0. Additional Definitions.
+
+ As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+ "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+ An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+ A "Combined Work" is a work produced by combining or linking an
+Application with the Library. The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+ The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+ The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+ 1. Exception to Section 3 of the GNU GPL.
+
+ You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+ 2. Conveying Modified Versions.
+
+ If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+ a) under this License, provided that you make a good faith effort to
+ ensure that, in the event an Application does not supply the
+ function or data, the facility still operates, and performs
+ whatever part of its purpose remains meaningful, or
+
+ b) under the GNU GPL, with none of the additional permissions of
+ this License applicable to that copy.
+
+ 3. Object Code Incorporating Material from Library Header Files.
+
+ The object code form of an Application may incorporate material from
+a header file that is part of the Library. You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+ a) Give prominent notice with each copy of the object code that the
+ Library is used in it and that the Library and its use are
+ covered by this License.
+
+ b) Accompany the object code with a copy of the GNU GPL and this license
+ document.
+
+ 4. Combined Works.
+
+ You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+ a) Give prominent notice with each copy of the Combined Work that
+ the Library is used in it and that the Library and its use are
+ covered by this License.
+
+ b) Accompany the Combined Work with a copy of the GNU GPL and this license
+ document.
+
+ c) For a Combined Work that displays copyright notices during
+ execution, include the copyright notice for the Library among
+ these notices, as well as a reference directing the user to the
+ copies of the GNU GPL and this license document.
+
+ d) Do one of the following:
+
+ 0) Convey the Minimal Corresponding Source under the terms of this
+ License, and the Corresponding Application Code in a form
+ suitable for, and under terms that permit, the user to
+ recombine or relink the Application with a modified version of
+ the Linked Version to produce a modified Combined Work, in the
+ manner specified by section 6 of the GNU GPL for conveying
+ Corresponding Source.
+
+ 1) Use a suitable shared library mechanism for linking with the
+ Library. A suitable mechanism is one that (a) uses at run time
+ a copy of the Library already present on the user's computer
+ system, and (b) will operate properly with a modified version
+ of the Library that is interface-compatible with the Linked
+ Version.
+
+ e) Provide Installation Information, but only if you would otherwise
+ be required to provide such information under section 6 of the
+ GNU GPL, and only to the extent that such information is
+ necessary to install and execute a modified version of the
+ Combined Work produced by recombining or relinking the
+ Application with a modified version of the Linked Version. (If
+ you use option 4d0, the Installation Information must accompany
+ the Minimal Corresponding Source and Corresponding Application
+ Code. If you use option 4d1, you must provide the Installation
+ Information in the manner specified by section 6 of the GNU GPL
+ for conveying Corresponding Source.)
+
+ 5. Combined Libraries.
+
+ You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+ a) Accompany the combined library with a copy of the same work based
+ on the Library, uncombined with any other library facilities,
+ conveyed under the terms of this License.
+
+ b) Give prominent notice with the combined library that part of it
+ is a work based on the Library, and explaining where to find the
+ accompanying uncombined form of the same work.
+
+ 6. Revised Versions of the GNU Lesser General Public License.
+
+ The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+ If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/README.md b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/README.md
new file mode 100644
index 0000000..7801179
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/README.md
@@ -0,0 +1,234 @@
+# Arduino Joystick Library
+
+#### Version 2.1.1
+
+This library can be used with Arduino IDE 1.6.6 or above (see [Wiki - Testing Details](https://github.com/MHeironimus/ArduinoJoystickLibrary/wiki/Testing-Details) for more information) to add one or more joysticks (or gamepads) to the list of HID devices an [Arduino Leonardo](https://www.arduino.cc/en/Main/ArduinoBoardLeonardo) or [Arduino Micro](https://www.arduino.cc/en/Main/ArduinoBoardMicro) (or any Arduino clone that is based on the ATmega32u4) can support. This library will also work with the [Arduino Due](https://www.arduino.cc/en/Main/ArduinoBoardDue), thanks to [@Palakis](https://github.com/Palakis). A complete list of supported boards can be found in the [Wiki - Supported Boards](https://github.com/MHeironimus/ArduinoJoystickLibrary/wiki/Supported-Boards). This will not work with Arduino IDE 1.6.5 (or below) or with non-32u4 based Arduino devices (e.g. Arduino UNO, Arduino MEGA, etc.).
+
+## Features
+
+The joystick or gamepad can have the following features:
+- Buttons (default: 32)
+- Up to 2 Hat Switches
+- X, Y, and/or Z Axis (up to 16-bit precision)
+- X, Y, and/or Z Axis Rotation (up to 16-bit precision)
+- Rudder (up to 16-bit precision)
+- Throttle (up to 16-bit precision)
+- Accelerator (up to 16-bit precision)
+- Brake (up to 16-bit precision)
+- Steering (up to 16-bit precision)
+
+## Installation Instructions
+
+The following instructions can be used to install the latest version of the library in the Arduino IDE (thanks to [@per1234](https://github.com/per1234) for this update):
+
+1. Download https://github.com/MHeironimus/ArduinoJoystickLibrary/archive/master.zip
+2. In the Arduino IDE, select `Sketch` > `Include Library` > `Add .ZIP Library...`. Browse to where the downloaded ZIP file is located and click `Open`. The Joystick library's examples will now appear under `File` > `Examples` > `Joystick`.
+
+## Examples
+
+### Simple example
+
+```C++
+#include
+
+// Create the Joystick
+Joystick_ Joystick;
+
+// Constant that maps the physical pin to the joystick button.
+const int pinToButtonMap = 9;
+
+void setup() {
+ // Initialize Button Pins
+ pinMode(pinToButtonMap, INPUT_PULLUP);
+
+ // Initialize Joystick Library
+ Joystick.begin();
+}
+
+// Last state of the button
+int lastButtonState = 0;
+
+void loop() {
+
+ // Read pin values
+ int currentButtonState = !digitalRead(pinToButtonMap);
+ if (currentButtonState != lastButtonState)
+ {
+ Joystick.setButton(0, currentButtonState);
+ lastButtonState = currentButtonState;
+ }
+
+ delay(50);
+}
+```
+
+### Included Examples
+
+The following example Arduino sketch files are included in this library:
+
+#### Simple Samples
+
+- `JoystickButton` - Creates a Joystick and maps pin 9 to button 0 of the joystick, pin 10 to button 1, pin 11 to button 2, and pin 12 to button 3.
+- `JoystickKeyboard` - Creates a Joystick and a Keyboard. Maps pin 9 to Joystick Button 0, pin 10 to Joystick Button 1, pin 11 to Keyboard key 1, and pin 12 to Keyboard key 2.
+- `GamepadExample` - Creates a simple Gamepad with an Up, Down, Left, Right, and Fire button.
+- `FunduinoJoystickShield` - Creates a simple Gamepad using a Funduino Joystick Shield (https://protosupplies.com/product/funduino-joystick-shield-v1-a/).
+- `ArcadeStickExample` - Simple arcade stick example that demonstrates how to read twelve Arduino Pro Micro digital pins and map them to the library (thanks to [@nebhead](https://github.com/nebhead) for this example). NOTE: This sketch is for the Arduino Pro Micro only.
+
+#### Used for Testing
+
+- `JoystickTest` - Simple test of the Joystick library. It exercises many of the Joystick library’s functions when pin A0 is grounded.
+- `MultipleJoystickTest` - Creates 4 Joysticks using the library (each with a slightly different configuration) and exercises the first 16 buttons (if present), the X axis, and the Y axis of each joystick when pin A0 is grounded.
+- `FlightControllerTest` - Creates a Flight Controller and tests 32 buttons, the X and Y axis, the Throttle, and the Rudder when pin A0 is grounded.
+- `HatSwitchTest` - Creates a joystick with two hat switches. Grounding pins 4 - 11 cause the hat switches to change position.
+- `DrivingControllerTest` - Creates a Driving Controller and tests 4 buttons, the Steering, Brake, and Accelerator when pin A0 is grounded.
+
+## Joystick Library API
+
+The following API is available if the Joystick library in included in a sketch file.
+
+### Joystick\_(...)
+
+Constructor used to initialize and setup the Joystick. The following optional parameters are available:
+
+- `uint8_t hidReportId` - Default: `0x03` - Indicates the joystick's HID report ID. This value must be unique if you are creating multiple instances of Joystick. Do not use `0x01` or `0x02` as they are used by the built-in Arduino Keyboard and Mouse libraries.
+- `uint8_t joystickType` - Default: `JOYSTICK_TYPE_JOYSTICK` or `0x04` - Indicates the HID input device type. Supported values:
+ - `JOYSTICK_TYPE_JOYSTICK` or `0x04` - Joystick
+ - `JOYSTICK_TYPE_GAMEPAD` or `0x05` - Gamepad
+ - `JOYSTICK_TYPE_MULTI_AXIS` or `0x08` - Multi-axis Controller
+- `uint8_t buttonCount` - Default: `32` - Indicates how many buttons will be available on the joystick.
+- `uint8_t hatSwitchCount` - Default: `2` - Indicates how many hat switches will be available on the joystick. Range: `0` - `2`
+- `bool includeXAxis` - Default: `true` - Indicates if the X Axis is available on the joystick.
+- `bool includeYAxis` - Default: `true` - Indicates if the Y Axis is available on the joystick.
+- `bool includeZAxis` - Default: `true` - Indicates if the Z Axis (in some situations this is the right X Axis) is available on the joystick.
+- `bool includeRxAxis` - Default: `true` - Indicates if the X Axis Rotation (in some situations this is the right Y Axis) is available on the joystick.
+- `bool includeRyAxis` - Default: `true` - Indicates if the Y Axis Rotation is available on the joystick.
+- `bool includeRzAxis` - Default: `true` - Indicates if the Z Axis Rotation is available on the joystick.
+- `bool includeRudder` - Default: `true` - Indicates if the Rudder is available on the joystick.
+- `bool includeThrottle` - Default: `true` - Indicates if the Throttle is available on the joystick.
+- `bool includeAccelerator` - Default: `true` - Indicates if the Accelerator is available on the joystick.
+- `bool includeBrake` - Default: `true` - Indicates if the Brake is available on the joystick.
+- `bool includeSteering` - Default: `true` - Indicates if the Steering is available on the joystick.
+
+The following constants define the default values for the constructor parameters listed above:
+
+- `JOYSTICK_DEFAULT_REPORT_ID` is set to `0x03`
+- `JOYSTICK_DEFAULT_BUTTON_COUNT` is set to `32`
+- `JOYSTICK_DEFAULT_HATSWITCH_COUNT` is set to `2`
+
+### Joystick.begin(bool initAutoSendState)
+
+Starts emulating a game controller connected to a computer. By default, all methods update the game controller state immediately. If `initAutoSendState` is set to `false`, the `Joystick.sendState` method must be called to update the game controller state.
+
+### Joystick.end()
+
+Stops the game controller emulation to a connected computer (Note: just like the Arduino `Keyboard.h` and `Mouse.h` libraries, the `end()` function does not actually do anything).
+
+### Joystick.setXAxisRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the X axis. Default: `0` to `1023`
+
+### Joystick.setXAxis(int32_t value)
+
+Sets the X axis value. See `setXAxisRange` for the range.
+
+### Joystick.setYAxisRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Y axis. Default: `0` to `1023`
+
+### Joystick.setYAxis(int32_t value)
+
+Sets the Y axis value. See `setYAxisRange` for the range.
+
+### Joystick.setZAxisRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Z axis. Default: `0` to `1023`
+
+### Joystick.setZAxis(int32_t value)
+
+Sets the Z axis value. See `setZAxisRange` for the range.
+
+### Joystick.setRxAxisRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the X axis rotation. Default: `0` to `1023`
+
+### Joystick.setRxAxis(int32_t value)
+
+Sets the X axis rotation value. See `setRxAxisRange` for the range.
+
+### Joystick.setRyAxisRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Y axis rotation. Default: `0` to `1023`
+
+### Joystick.setRyAxis(int32_t value)
+
+Sets the Y axis rotation value. See `setRyAxisRange` for the range.
+
+### Joystick.setRzAxisRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Z axis rotation. Default: `0` to `1023`
+
+### Joystick.setRzAxis(int32_t value)
+
+Sets the Z axis rotation value. See `setRzAxisRange` for the range.
+
+### Joystick.setRudderRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Rudder. Default: `0` to `1023`
+
+### Joystick.setRudder(int32_t value)
+
+Sets the Rudder value. See `setRudderRange` for the range.
+
+### Joystick.setThrottleRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Throttle. Default: `0` to `1023`
+
+### Joystick.setThrottle(int32_t value)
+
+Sets the Throttle value. See `setThrottleRange` for the range.
+
+### Joystick.setAcceleratorRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Accelerator. Default: `0` to `1023`
+
+### Joystick.setAccelerator(int32_t value)
+
+Sets the Accelerator value. See `setAcceleratorRange` for the range.
+
+### Joystick.setBrakeRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Brake. Default: `0` to `1023`
+
+### Joystick.setBrake(int32_t value)
+
+Sets the Brake value. See `setBrakeRange` for the range.
+
+### Joystick.setSteeringRange(int32_t minimum, int32_t maximum)
+
+Sets the range of values that will be used for the Steering. Default: `0` to `1023`
+
+### Joystick.setSteering(int32_t value)
+
+Sets the Steering value. See `setSteeringRange` for the range.
+
+### Joystick.setButton(uint8_t button, uint8_t value)
+
+Sets the state (`0` or `1`) of the specified button (range: `0` - (`buttonCount - 1`)). The button is the 0-based button number (i.e. button #1 is `0`, button #2 is `1`, etc.). The value is `1` if the button is pressed and `0` if the button is released.
+
+### Joystick.pressButton(uint8_t button)
+
+Press the indicated button (range: `0` - (`buttonCount - 1`)). The button is the 0-based button number (i.e. button #1 is `0`, button #2 is `1`, etc.).
+
+### Joystick.releaseButton(uint8_t button)
+
+Release the indicated button (range: `0` - (`buttonCount - 1`)). The button is the 0-based button number (i.e. button #1 is `0`, button #2 is `1`, etc.).
+
+### Joystick.setHatSwitch(int8_t hatSwitch, int16_t value)
+
+Sets the value of the specified hat switch. The hatSwitch is 0-based (i.e. hat switch #1 is `0` and hat switch #2 is `1`). The value is from 0° to 360°, but in 45° increments. Any value less than 45° will be rounded down (i.e. 44° is rounded down to 0°, 89° is rounded down to 45°, etc.). Set the value to `JOYSTICK_HATSWITCH_RELEASE` or `-1` to release the hat switch.
+
+### Joystick.sendState()
+
+Sends the updated joystick state to the host computer. Only needs to be called if `AutoSendState` is `false` (see `Joystick.begin` for more details).
+
+See the [Wiki](https://github.com/MHeironimus/ArduinoJoystickLibrary/wiki) for more details on things like FAQ, supported boards, testing, etc.
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/ArcadeStickExample/ArcadeStickExample.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/ArcadeStickExample/ArcadeStickExample.ino
new file mode 100644
index 0000000..1f9df66
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/ArcadeStickExample/ArcadeStickExample.ino
@@ -0,0 +1,173 @@
+// Simple arcade stick example that demonstrates how to read twelve
+// Arduino Pro Micro digital pins and map them to the
+// Arduino Joystick library.
+//
+
+// The digital pins 2 - 20 are grounded when they are pressed.
+// Pin 10, A10, Red = UP
+// Pin 15, D15, Yellow = RIGHT
+// Pin 16, D16, Orange = DOWN
+// Pin 14, D14, Green = LEFT
+
+// Pin 9, A9 = Button 1
+// Pin 8, A8 = Button 2
+// Pin 7, D7 = Button 3
+// Pin 3, D3 = Button 4
+// Pin 2, D2 = Button 5
+// Pin 4, A6 = Button 6
+
+// Pin 20, A2 = Select Button 1
+// Pin 19, A1 = Start Button 2
+
+// Pin 5, D5 = Other Button
+// Pin 6, A7 = Other Button
+// Pin 18, A0 = Other Button
+// Pin 21, A3 = Other Button
+
+// NOTE: This sketch file is for use with Arduino Pro Micro only.
+//
+// Original gamepad example by Matthew Heironimus
+// 2016-11-24
+// Adapted for arcade machine setup by Ben Parmeter
+// 2019-05-20
+//--------------------------------------------------------------------
+
+#include
+
+Joystick_ Joystick(JOYSTICK_DEFAULT_REPORT_ID,JOYSTICK_TYPE_GAMEPAD,
+ 8, 0, // Button Count, Hat Switch Count
+ true, true, false, // X and Y, but no Z Axis
+ false, false, false, // No Rx, Ry, or Rz
+ false, false, // No rudder or throttle
+ false, false, false); // No accelerator, brake, or steering
+
+void setup() {
+ // Initialize Button Pins
+ pinMode(2, INPUT_PULLUP);
+ pinMode(3, INPUT_PULLUP);
+ pinMode(4, INPUT_PULLUP);
+ pinMode(5, INPUT_PULLUP);
+ pinMode(6, INPUT_PULLUP);
+ pinMode(7, INPUT_PULLUP);
+ pinMode(8, INPUT_PULLUP);
+ pinMode(9, INPUT_PULLUP);
+ pinMode(10, INPUT_PULLUP);
+ pinMode(14, INPUT_PULLUP);
+ pinMode(15, INPUT_PULLUP);
+ pinMode(16, INPUT_PULLUP);
+ pinMode(18, INPUT_PULLUP);
+ pinMode(19, INPUT_PULLUP);
+ pinMode(20, INPUT_PULLUP);
+ pinMode(21, INPUT_PULLUP);
+
+ // Initialize Joystick Library
+ Joystick.begin();
+ Joystick.setXAxisRange(-1, 1);
+ Joystick.setYAxisRange(-1, 1);
+}
+
+// Last state of the buttons
+int lastButtonState[16] = {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0};
+int buttonMap[16] = {10,15,16,14,9,8,7,3,2,4,20,19,5,6,18,21};
+
+// ButtonMap = 0, Pin 10 = UP
+// ButtonMap = 1, Pin 15 = RIGHT
+// ButtonMap = 2, Pin 16 = DOWN
+// ButtonMap = 3, Pin 14 = LEFT
+
+// ButtonMap = 4, Pin 9 = Button 1
+// ButtonMap = 5, Pin 8 = Button 2
+// ButtonMap = 6, Pin 7 = Button 3
+// ButtonMap = 7, Pin 3 = Button 4
+// ButtonMap = 8, Pin 2 = Button 5
+// ButtonMap = 9, Pin 4 = Button 6
+
+// ButtonMap = 10, Pin 20 = Select Button 1
+// ButtonMap = 11, Pin 19 = Start Button 2
+
+// ButtonMap = 12, Pin 5 = Other Button
+// ButtonMap = 13, Pin 6 = Other Button
+// ButtonMap = 14, Pin 18 = Other Button
+// ButtonMap = 15, Pin 21 = Other Button
+
+
+void loop() {
+
+ // Read pin values
+ for (int index = 0; index < 16; index++)
+ {
+ int currentButtonState = !digitalRead(buttonMap[index]);
+ if (currentButtonState != lastButtonState[index])
+ {
+ switch (index) {
+ case 0: // UP
+ if (currentButtonState == 1) {
+ Joystick.setYAxis(-1);
+ } else {
+ Joystick.setYAxis(0);
+ }
+ break;
+ case 1: // RIGHT
+ if (currentButtonState == 1) {
+ Joystick.setXAxis(1);
+ } else {
+ Joystick.setXAxis(0);
+ }
+ break;
+ case 2: // DOWN
+ if (currentButtonState == 1) {
+ Joystick.setYAxis(1);
+ } else {
+ Joystick.setYAxis(0);
+ }
+ break;
+ case 3: // LEFT
+ if (currentButtonState == 1) {
+ Joystick.setXAxis(-1);
+ } else {
+ Joystick.setXAxis(0);
+ }
+ break;
+ case 4: // Black Button 1
+ Joystick.setButton(0, currentButtonState);
+ break;
+ case 5: // Black Button 2
+ Joystick.setButton(1, currentButtonState);
+ break;
+ case 6: // Black Button 3
+ Joystick.setButton(2, currentButtonState);
+ break;
+ case 7: // Black Button 4
+ Joystick.setButton(3, currentButtonState);
+ break;
+ case 8: // Black Button 5
+ Joystick.setButton(4, currentButtonState);
+ break;
+ case 9: // Black Button 6
+ Joystick.setButton(5, currentButtonState);
+ break;
+ case 10: // Select Button
+ Joystick.setButton(6, currentButtonState);
+ break;
+ case 11: // Start Button
+ Joystick.setButton(7, currentButtonState);
+ break;
+ case 12: // Other Button 1
+ Joystick.setButton(8, currentButtonState);
+ break;
+ case 13: // Other Button 2
+ Joystick.setButton(9, currentButtonState);
+ break;
+ case 14: // Other Button 3
+ Joystick.setButton(10, currentButtonState);
+ break;
+ case 15: // Other Button 4
+ Joystick.setButton(11, currentButtonState);
+ break;
+ }
+ lastButtonState[index] = currentButtonState;
+ }
+ }
+
+ delay(10);
+}
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/DrivingControllerTest/DrivingControllerTest.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/DrivingControllerTest/DrivingControllerTest.ino
new file mode 100644
index 0000000..a659e71
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/DrivingControllerTest/DrivingControllerTest.ino
@@ -0,0 +1,153 @@
+// Program used to test the driving simulator functions on
+// the USB Joystick object on the Arduino Leonardo or
+// Arduino Micro.
+//
+// Matthew Heironimus
+// 2016-05-29 Original version.
+//------------------------------------------------------------
+
+#include "Joystick.h"
+
+Joystick_ Joystick(JOYSTICK_DEFAULT_REPORT_ID,
+ JOYSTICK_TYPE_MULTI_AXIS, 4, 0,
+ false, false, false, false, false, false,
+ false, false, true, true, true);
+
+// Set to true to test "Auto Send" mode or false to test "Manual Send" mode.
+//const bool testAutoSendMode = true;
+const bool testAutoSendMode = false;
+
+const unsigned long gcCycleDelta = 1000;
+const unsigned long gcButtonDelta = 500;
+const unsigned long gcAnalogDelta = 25;
+unsigned long gNextTime = 0;
+unsigned int gCurrentStep = 0;
+
+void testSingleButtonPush(unsigned int button)
+{
+ if (button > 0)
+ {
+ Joystick.releaseButton(button - 1);
+ }
+ if (button < 4)
+ {
+ Joystick.pressButton(button);
+ }
+}
+
+void testMultiButtonPush(unsigned int currentStep)
+{
+ for (int button = 0; button < 4; button++)
+ {
+ if ((currentStep == 0) || (currentStep == 2))
+ {
+ if ((button % 2) == 0)
+ {
+ Joystick.pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick.releaseButton(button);
+ }
+ } // if ((currentStep == 0) || (currentStep == 2))
+ if ((currentStep == 1) || (currentStep == 2))
+ {
+ if ((button % 2) != 0)
+ {
+ Joystick.pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick.releaseButton(button);
+ }
+ } // if ((currentStep == 1) || (currentStep == 2))
+ if (currentStep == 3)
+ {
+ Joystick.releaseButton(button);
+ } // if (currentStep == 3)
+ } // for (int button = 0; button < 32; button++)
+}
+
+void testAcceleratorBrake(int value)
+{
+ Joystick.setAccelerator(value);
+ Joystick.setBrake(260 - value);
+}
+
+void testSteering(int value)
+{
+ if (value < 300) {
+ Joystick.setSteering(value);
+ } else {
+ Joystick.setSteering(600 - value);
+ }
+}
+
+void setup() {
+
+ Joystick.setAcceleratorRange(0, 260);
+ Joystick.setBrakeRange(0, 260);
+ Joystick.setSteeringRange(0, 300);
+
+ if (testAutoSendMode)
+ {
+ Joystick.begin();
+ }
+ else
+ {
+ Joystick.begin(false);
+ }
+
+ pinMode(A0, INPUT_PULLUP);
+ pinMode(LED_BUILTIN, OUTPUT);
+}
+
+void loop() {
+
+ // System Disabled
+ if (digitalRead(A0) != 0)
+ {
+ // Turn indicator light off.
+ digitalWrite(LED_BUILTIN, 0);
+ return;
+ }
+
+ // Turn indicator light on.
+ digitalWrite(LED_BUILTIN, 1);
+
+ if (millis() >= gNextTime)
+ {
+
+ if (gCurrentStep < 4)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testSingleButtonPush(gCurrentStep);
+ }
+ else if (gCurrentStep < 9)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testMultiButtonPush(gCurrentStep - 5);
+ }
+ else if (gCurrentStep < (9 + 260))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testAcceleratorBrake(gCurrentStep - 9);
+ }
+ else if (gCurrentStep < (9 + 260 + 600))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testSteering(gCurrentStep - (9 + 260));
+ }
+
+ if (testAutoSendMode == false)
+ {
+ Joystick.sendState();
+ }
+
+ gCurrentStep++;
+ if (gCurrentStep >= (9 + 260 + 600))
+ {
+ gNextTime = millis() + gcCycleDelta;
+ gCurrentStep = 0;
+ }
+ }
+}
+
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FlightControllerTest/FlightControllerTest.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FlightControllerTest/FlightControllerTest.ino
new file mode 100644
index 0000000..2d7f633
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FlightControllerTest/FlightControllerTest.ino
@@ -0,0 +1,181 @@
+// Program used to test the USB Joystick library when used as
+// a Flight Controller on the Arduino Leonardo or Arduino
+// Micro.
+//
+// Matthew Heironimus
+// 2016-05-29 - Original Version
+//------------------------------------------------------------
+
+#include "Joystick.h"
+
+Joystick_ Joystick(JOYSTICK_DEFAULT_REPORT_ID,
+ JOYSTICK_TYPE_MULTI_AXIS, 32, 0,
+ true, true, false, false, false, false,
+ true, true, false, false, false);
+
+// Set to true to test "Auto Send" mode or false to test "Manual Send" mode.
+//const bool testAutoSendMode = true;
+const bool testAutoSendMode = false;
+
+const unsigned long gcCycleDelta = 1000;
+const unsigned long gcAnalogDelta = 25;
+const unsigned long gcButtonDelta = 500;
+unsigned long gNextTime = 0;
+unsigned int gCurrentStep = 0;
+
+void testSingleButtonPush(unsigned int button)
+{
+ if (button > 0)
+ {
+ Joystick.releaseButton(button - 1);
+ }
+ if (button < 32)
+ {
+ Joystick.pressButton(button);
+ }
+}
+
+void testMultiButtonPush(unsigned int currentStep)
+{
+ for (int button = 0; button < 32; button++)
+ {
+ if ((currentStep == 0) || (currentStep == 2))
+ {
+ if ((button % 2) == 0)
+ {
+ Joystick.pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick.releaseButton(button);
+ }
+ } // if ((currentStep == 0) || (currentStep == 2))
+ if ((currentStep == 1) || (currentStep == 2))
+ {
+ if ((button % 2) != 0)
+ {
+ Joystick.pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick.releaseButton(button);
+ }
+ } // if ((currentStep == 1) || (currentStep == 2))
+ if (currentStep == 3)
+ {
+ Joystick.releaseButton(button);
+ } // if (currentStep == 3)
+ } // for (int button = 0; button < 32; button++)
+}
+
+void testXYAxis(unsigned int currentStep)
+{
+ int xAxis;
+ int yAxis;
+
+ if (currentStep < 256)
+ {
+ xAxis = currentStep - 127;
+ yAxis = -127;
+ Joystick.setXAxis(xAxis);
+ Joystick.setYAxis(yAxis);
+ }
+ else if (currentStep < 512)
+ {
+ yAxis = currentStep - 256 - 127;
+ Joystick.setYAxis(yAxis);
+ }
+ else if (currentStep < 768)
+ {
+ xAxis = 128 - (currentStep - 512);
+ Joystick.setXAxis(xAxis);
+ }
+ else if (currentStep < 1024)
+ {
+ yAxis = 128 - (currentStep - 768);
+ Joystick.setYAxis(yAxis);
+ }
+ else if (currentStep < 1024 + 128)
+ {
+ xAxis = currentStep - 1024 - 127;
+ Joystick.setXAxis(xAxis);
+ Joystick.setYAxis(xAxis);
+ }
+}
+
+void testThrottleRudder(unsigned int value)
+{
+ Joystick.setThrottle(value);
+ Joystick.setRudder(255 - value);
+}
+
+void setup() {
+
+ Joystick.setXAxisRange(-127, 127);
+ Joystick.setYAxisRange(-127, 127);
+ Joystick.setZAxisRange(-127, 127);
+ Joystick.setThrottleRange(0, 255);
+ Joystick.setRudderRange(0, 255);
+
+ if (testAutoSendMode)
+ {
+ Joystick.begin();
+ }
+ else
+ {
+ Joystick.begin(false);
+ }
+
+ pinMode(A0, INPUT_PULLUP);
+ pinMode(LED_BUILTIN, OUTPUT);
+}
+
+void loop() {
+
+ // System Disabled
+ if (digitalRead(A0) != 0)
+ {
+ // Turn indicator light off.
+ digitalWrite(LED_BUILTIN, 0);
+ return;
+ }
+
+ // Turn indicator light on.
+ digitalWrite(LED_BUILTIN, 1);
+
+ if (millis() >= gNextTime)
+ {
+
+ if (gCurrentStep < 33)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testSingleButtonPush(gCurrentStep);
+ }
+ else if (gCurrentStep < 37)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testMultiButtonPush(gCurrentStep - 33);
+ }
+ else if (gCurrentStep < (37 + 256))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testThrottleRudder(gCurrentStep - 37);
+ }
+ else if (gCurrentStep < (37 + 256 + 1024 + 128))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testXYAxis(gCurrentStep - (37 + 256));
+ }
+
+ if (testAutoSendMode == false)
+ {
+ Joystick.sendState();
+ }
+
+ gCurrentStep++;
+ if (gCurrentStep >= (37 + 256 + 1024 + 128))
+ {
+ gNextTime = millis() + gcCycleDelta;
+ gCurrentStep = 0;
+ }
+ }
+}
+
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FunduinoJoystickShield/FunduinoJoystickShield.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FunduinoJoystickShield/FunduinoJoystickShield.ino
new file mode 100644
index 0000000..71c277a
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/FunduinoJoystickShield/FunduinoJoystickShield.ino
@@ -0,0 +1,85 @@
+#include
+
+const uint8_t buttonCount = 7;
+Joystick_ controller(JOYSTICK_DEFAULT_REPORT_ID, JOYSTICK_TYPE_GAMEPAD, buttonCount,
+ 0, true, true, false,
+ false, false, false,
+ false, false, false,
+ false, false);
+
+int const BTN_A_PIN = 2;
+int const BTN_B_PIN = 3;
+int const BTN_C_PIN = 4;
+int const BTN_D_PIN = 5;
+int const BTN_E_PIN = 6;
+int const BTN_F_PIN = 7;
+int const BTN_K_PIN = 8;
+int const AXIS_X_PIN = A0;
+int const AXIS_Y_PIN = A1;
+
+int const buttonPins[buttonCount] = {
+ BTN_A_PIN,
+ BTN_B_PIN,
+ BTN_C_PIN,
+ BTN_D_PIN,
+ BTN_E_PIN,
+ BTN_F_PIN,
+ BTN_K_PIN
+};
+int lastButtonValue[buttonCount];
+int lastXAxisValue = -1;
+int lastYAxisValue = -1;
+
+void setup()
+{
+ controller.setYAxisRange(0, 1023);
+ controller.setYAxisRange(1023, 0);
+ controller.begin(false);
+
+ for (int i = 0; i < buttonCount; i++)
+ {
+ pinMode(buttonPins[i], INPUT_PULLUP);
+ lastButtonValue[i] = -1;
+ }
+
+ pinMode(LED_BUILTIN, OUTPUT);
+ digitalWrite(LED_BUILTIN, LOW);
+}
+
+void loop()
+{
+ bool sendUpdate = false;
+ for (int i = 0; i < buttonCount; i++)
+ {
+ const int buttonValue = digitalRead(buttonPins[i]);
+
+ if (buttonValue != lastButtonValue[i])
+ {
+ controller.setButton(i, !buttonValue);
+ lastButtonValue[i] = buttonValue;
+ sendUpdate = true;
+ }
+ }
+
+ const int currentXAxisValue = analogRead(AXIS_X_PIN);
+ if (currentXAxisValue != lastXAxisValue)
+ {
+ controller.setXAxis(currentXAxisValue);
+ lastXAxisValue = currentXAxisValue;
+ sendUpdate = true;
+ }
+
+ const int currentYAxisValue = analogRead(AXIS_Y_PIN);
+ if (currentYAxisValue != lastYAxisValue)
+ {
+ controller.setYAxis(currentYAxisValue);
+ lastYAxisValue = currentYAxisValue;
+ sendUpdate = true;
+ }
+
+ if (sendUpdate)
+ {
+ controller.sendState();
+ }
+ delay(50);
+}
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/GamepadExample/GamepadExample.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/GamepadExample/GamepadExample.ino
new file mode 100644
index 0000000..ff728b3
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/GamepadExample/GamepadExample.ino
@@ -0,0 +1,91 @@
+// Simple gamepad example that demonstraits how to read five Arduino
+// digital pins and map them to the Arduino Joystick library.
+//
+// The digital pins 2 - 6 are grounded when they are pressed.
+// Pin 2 = UP
+// Pin 3 = RIGHT
+// Pin 4 = DOWN
+// Pin 5 = LEFT
+// Pin 6 = FIRE
+//
+// NOTE: This sketch file is for use with Arduino Leonardo and
+// Arduino Micro only.
+//
+// by Matthew Heironimus
+// 2016-11-24
+//--------------------------------------------------------------------
+
+#include
+
+Joystick_ Joystick(JOYSTICK_DEFAULT_REPORT_ID,JOYSTICK_TYPE_GAMEPAD,
+ 1, 0, // Button Count, Hat Switch Count
+ true, true, false, // X and Y, but no Z Axis
+ false, false, false, // No Rx, Ry, or Rz
+ false, false, // No rudder or throttle
+ false, false, false); // No accelerator, brake, or steering
+
+void setup() {
+ // Initialize Button Pins
+ pinMode(2, INPUT_PULLUP);
+ pinMode(3, INPUT_PULLUP);
+ pinMode(4, INPUT_PULLUP);
+ pinMode(5, INPUT_PULLUP);
+ pinMode(6, INPUT_PULLUP);
+
+ // Initialize Joystick Library
+ Joystick.begin();
+ Joystick.setXAxisRange(-1, 1);
+ Joystick.setYAxisRange(-1, 1);
+}
+
+// Last state of the buttons
+int lastButtonState[5] = {0,0,0,0,0};
+
+void loop() {
+
+ // Read pin values
+ for (int index = 0; index < 5; index++)
+ {
+ int currentButtonState = !digitalRead(index + 2);
+ if (currentButtonState != lastButtonState[index])
+ {
+ switch (index) {
+ case 0: // UP
+ if (currentButtonState == 1) {
+ Joystick.setYAxis(-1);
+ } else {
+ Joystick.setYAxis(0);
+ }
+ break;
+ case 1: // RIGHT
+ if (currentButtonState == 1) {
+ Joystick.setXAxis(1);
+ } else {
+ Joystick.setXAxis(0);
+ }
+ break;
+ case 2: // DOWN
+ if (currentButtonState == 1) {
+ Joystick.setYAxis(1);
+ } else {
+ Joystick.setYAxis(0);
+ }
+ break;
+ case 3: // LEFT
+ if (currentButtonState == 1) {
+ Joystick.setXAxis(-1);
+ } else {
+ Joystick.setXAxis(0);
+ }
+ break;
+ case 4: // FIRE
+ Joystick.setButton(0, currentButtonState);
+ break;
+ }
+ lastButtonState[index] = currentButtonState;
+ }
+ }
+
+ delay(10);
+}
+
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/HatSwitchTest/HatSwitchTest.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/HatSwitchTest/HatSwitchTest.ino
new file mode 100644
index 0000000..22e040e
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/HatSwitchTest/HatSwitchTest.ino
@@ -0,0 +1,95 @@
+// Simple example application that shows how to read four Arduino
+// digital pins and map them to the USB Joystick library's hat switch.
+//
+// The digital pins 4, 5, 6, 7, 8, 9, 10, and 11 are grounded when
+// they are pressed.
+//
+// Pin Mappings:
+// 4 - Hat Switch #0 UP
+// 5 - Hat Switch #0 RIGHT
+// 6 - Hat Switch #0 DOWN
+// 7 - Hat Switch #0 LEFT
+// 8 - Hat Switch #1 UP
+// 9 - Hat Switch #1 RIGHT
+// 10 - Hat Switch #1 DOWN
+// 11 - Hat Switch #1 LEFT
+//
+// NOTE: This sketch file is for use with Arduino Leonardo and
+// Arduino Micro only.
+//
+// by Matthew Heironimus
+// 2016-05-30
+//--------------------------------------------------------------------
+
+#include
+
+Joystick_ Joystick(JOYSTICK_DEFAULT_REPORT_ID,
+ JOYSTICK_TYPE_GAMEPAD, 0,
+ JOYSTICK_DEFAULT_HATSWITCH_COUNT,
+ false, false, false, false, false, false,
+ false, false, false, false, false);
+
+void setup() {
+
+ // Initialize Button Pins
+ for (int index = 4; index < 12; index++)
+ {
+ pinMode(index, INPUT_PULLUP);
+ }
+
+ // Initialize Joystick Library
+ Joystick.begin();
+}
+
+// Last state of the pins
+int lastButtonState[2][4] = {{0,0,0,0}, {0,0,0,0}};
+
+void loop() {
+
+ bool valueChanged[2] = {false, false};
+ int currentPin = 4;
+
+ // Read pin values
+ for (int hatSwitch = 0; hatSwitch < 2; hatSwitch++)
+ {
+ for (int index = 0; index < 4; index++)
+ {
+ int currentButtonState = !digitalRead(currentPin++);
+ if (currentButtonState != lastButtonState[hatSwitch][index])
+ {
+ valueChanged[hatSwitch] = true;
+ lastButtonState[hatSwitch][index] = currentButtonState;
+ }
+ }
+ }
+
+ for (int hatSwitch = 0; hatSwitch < 2; hatSwitch++)
+ {
+ if (valueChanged[hatSwitch]) {
+
+ if ((lastButtonState[hatSwitch][0] == 0)
+ && (lastButtonState[hatSwitch][1] == 0)
+ && (lastButtonState[hatSwitch][2] == 0)
+ && (lastButtonState[hatSwitch][3] == 0)) {
+ Joystick.setHatSwitch(hatSwitch, -1);
+ }
+ if (lastButtonState[hatSwitch][0] == 1) {
+ Joystick.setHatSwitch(hatSwitch, 0);
+ }
+ if (lastButtonState[hatSwitch][1] == 1) {
+ Joystick.setHatSwitch(hatSwitch, 90);
+ }
+ if (lastButtonState[hatSwitch][2] == 1) {
+ Joystick.setHatSwitch(hatSwitch, 180);
+ }
+ if (lastButtonState[hatSwitch][3] == 1) {
+ Joystick.setHatSwitch(hatSwitch, 270);
+ }
+
+ } // if the value changed
+
+ } // for each hat switch
+
+ delay(50);
+}
+
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickButton/JoystickButton.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickButton/JoystickButton.ino
new file mode 100644
index 0000000..c6bc79e
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickButton/JoystickButton.ino
@@ -0,0 +1,50 @@
+// Simple example application that shows how to read four Arduino
+// digital pins and map them to the USB Joystick library.
+//
+// Ground digital pins 9, 10, 11, and 12 to press the joystick
+// buttons 0, 1, 2, and 3.
+//
+// NOTE: This sketch file is for use with Arduino Leonardo and
+// Arduino Micro only.
+//
+// by Matthew Heironimus
+// 2015-11-20
+//--------------------------------------------------------------------
+
+#include
+
+Joystick_ Joystick;
+
+void setup() {
+ // Initialize Button Pins
+ pinMode(9, INPUT_PULLUP);
+ pinMode(10, INPUT_PULLUP);
+ pinMode(11, INPUT_PULLUP);
+ pinMode(12, INPUT_PULLUP);
+
+ // Initialize Joystick Library
+ Joystick.begin();
+}
+
+// Constant that maps the phyical pin to the joystick button.
+const int pinToButtonMap = 9;
+
+// Last state of the button
+int lastButtonState[4] = {0,0,0,0};
+
+void loop() {
+
+ // Read pin values
+ for (int index = 0; index < 4; index++)
+ {
+ int currentButtonState = !digitalRead(index + pinToButtonMap);
+ if (currentButtonState != lastButtonState[index])
+ {
+ Joystick.setButton(index, currentButtonState);
+ lastButtonState[index] = currentButtonState;
+ }
+ }
+
+ delay(50);
+}
+
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickKeyboard/JoystickKeyboard.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickKeyboard/JoystickKeyboard.ino
new file mode 100644
index 0000000..d1670c9
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickKeyboard/JoystickKeyboard.ino
@@ -0,0 +1,63 @@
+// Simple example application that shows how to read four Arduino
+// digital pins and map them to buttons on a joystick or keys on a
+// keyboard uisng the Arduino Joystick and Keyboard libraries.
+//
+// The digital pins 9, 10, 11, and 12 are grounded when they are pressed.
+//
+// NOTE: This sketch file is for use with Arduino Leonardo and
+// Arduino Micro only.
+//
+// Pin 9 = Joystick Button 0
+// Pin 10 = Joystick Button 1
+// Pin 11 = 1 key on the Keyboard
+// Pin 12 = 2 key on the Keyboard
+//
+// by Matthew Heironimus
+// 2016-05-13
+//--------------------------------------------------------------------
+
+#include
+#include
+
+Joystick_ Joystick;
+
+void setup() {
+ // Initialize Button Pins
+ pinMode(9, INPUT_PULLUP);
+ pinMode(10, INPUT_PULLUP);
+ pinMode(11, INPUT_PULLUP);
+ pinMode(12, INPUT_PULLUP);
+
+ // Initialize Joystick Library
+ Joystick.begin();
+}
+
+// Constant that maps the phyical pin to the joystick button.
+const int pinToButtonMap = 9;
+
+// Last state of the button
+int lastButtonState[4] = {0,0,0,0};
+
+void loop() {
+
+ // Read pin values
+ for (int index = 0; index < 4; index++)
+ {
+ int currentButtonState = !digitalRead(index + pinToButtonMap);
+ if (currentButtonState != lastButtonState[index])
+ {
+ if (index < 2) {
+ Joystick.setButton(index, currentButtonState);
+ lastButtonState[index] = currentButtonState;
+ } else {
+ if (currentButtonState) {
+ Keyboard.write(47 + index);
+ delay(500);
+ }
+ }
+ }
+ }
+
+ delay(100);
+}
+
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickTest/JoystickTest.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickTest/JoystickTest.ino
new file mode 100644
index 0000000..d58ac4a
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/JoystickTest/JoystickTest.ino
@@ -0,0 +1,265 @@
+// Program used to test the USB Joystick object on the
+// Arduino Leonardo or Arduino Micro.
+//
+// Matthew Heironimus
+// 2015-03-28 - Original Version
+// 2015-11-18 - Updated to use the new Joystick library
+// written for Arduino IDE Version 1.6.6 and
+// above.
+// 2016-05-13 Updated to use new dynamic Joystick library
+// that can be customized.
+// 2022-03-29 Updated to work with version 2.1.0 of the
+// Joystick library.
+//------------------------------------------------------------
+
+#include "Joystick.h"
+
+// Create Joystick
+Joystick_ Joystick;
+
+// Set to true to test "Auto Send" mode or false to test "Manual Send" mode.
+//const bool testAutoSendMode = true;
+const bool testAutoSendMode = false;
+
+const unsigned long gcCycleDelta = 1000;
+const unsigned long gcAnalogDelta = 25;
+const unsigned long gcButtonDelta = 500;
+unsigned long gNextTime = 0;
+unsigned int gCurrentStep = 0;
+
+void testSingleButtonPush(unsigned int button)
+{
+ if (button > 0)
+ {
+ Joystick.releaseButton(button - 1);
+ }
+ if (button < 32)
+ {
+ Joystick.pressButton(button);
+ }
+}
+
+void testMultiButtonPush(unsigned int currentStep)
+{
+ for (int button = 0; button < 32; button++)
+ {
+ if ((currentStep == 0) || (currentStep == 2))
+ {
+ if ((button % 2) == 0)
+ {
+ Joystick.pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick.releaseButton(button);
+ }
+ } // if ((currentStep == 0) || (currentStep == 2))
+ if ((currentStep == 1) || (currentStep == 2))
+ {
+ if ((button % 2) != 0)
+ {
+ Joystick.pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick.releaseButton(button);
+ }
+ } // if ((currentStep == 1) || (currentStep == 2))
+ if (currentStep == 3)
+ {
+ Joystick.releaseButton(button);
+ } // if (currentStep == 3)
+ } // for (int button = 0; button < 32; button++)
+}
+
+void testXYAxis(unsigned int currentStep)
+{
+ int xAxis;
+ int yAxis;
+
+ if (currentStep < 256)
+ {
+ xAxis = currentStep - 127;
+ yAxis = -127;
+ Joystick.setXAxis(xAxis);
+ Joystick.setYAxis(yAxis);
+ }
+ else if (currentStep < 512)
+ {
+ yAxis = currentStep - 256 - 127;
+ Joystick.setYAxis(yAxis);
+ }
+ else if (currentStep < 768)
+ {
+ xAxis = 128 - (currentStep - 512);
+ Joystick.setXAxis(xAxis);
+ }
+ else if (currentStep < 1024)
+ {
+ yAxis = 128 - (currentStep - 768);
+ Joystick.setYAxis(yAxis);
+ }
+ else if (currentStep < 1024 + 128)
+ {
+ xAxis = currentStep - 1024 - 127;
+ Joystick.setXAxis(xAxis);
+ Joystick.setYAxis(xAxis);
+ }
+}
+
+void testZAxis(unsigned int currentStep)
+{
+ int z;
+
+ if (currentStep < 128)
+ {
+ z = -currentStep;
+ }
+ else if (currentStep < 256 + 128)
+ {
+ z = currentStep - 128 - 127;
+ }
+ else if (currentStep < 256 + 128 + 127)
+ {
+ z = 127 - (currentStep - 383);
+ }
+
+ Joystick.setZAxis(z);
+}
+
+void testHatSwitch(unsigned int currentStep)
+{
+ if (currentStep < 8)
+ {
+ Joystick.setHatSwitch(0, currentStep * 45);
+ }
+ else if (currentStep == 8)
+ {
+ Joystick.setHatSwitch(0, -1);
+ }
+ else if (currentStep < 17)
+ {
+ Joystick.setHatSwitch(1, (currentStep - 9) * 45);
+ }
+ else if (currentStep == 17)
+ {
+ Joystick.setHatSwitch(1, -1);
+ }
+ else if (currentStep == 18)
+ {
+ Joystick.setHatSwitch(0, 0);
+ Joystick.setHatSwitch(1, 0);
+ }
+ else if (currentStep < 27)
+ {
+ Joystick.setHatSwitch(0, (currentStep - 18) * 45);
+ Joystick.setHatSwitch(1, (8 - (currentStep - 18)) * 45);
+ }
+ else if (currentStep == 27)
+ {
+ Joystick.setHatSwitch(0, -1);
+ Joystick.setHatSwitch(1, -1);
+ }
+}
+
+void testThrottleRudder(unsigned int value)
+{
+ Joystick.setThrottle(value);
+ Joystick.setRudder(value);
+}
+
+void testXYZAxisRotation(unsigned int degree)
+{
+ Joystick.setRxAxis(degree);
+ Joystick.setRyAxis(degree);
+ Joystick.setRzAxis(degree * 2);
+}
+
+void setup() {
+
+ // Set Range Values
+ Joystick.setXAxisRange(-127, 127);
+ Joystick.setYAxisRange(-127, 127);
+ Joystick.setZAxisRange(-127, 127);
+ Joystick.setRxAxisRange(0, 360);
+ Joystick.setRyAxisRange(360, 0);
+ Joystick.setRzAxisRange(0, 720);
+ Joystick.setThrottleRange(0, 255);
+ Joystick.setRudderRange(255, 0);
+
+ if (testAutoSendMode)
+ {
+ Joystick.begin();
+ }
+ else
+ {
+ Joystick.begin(false);
+ }
+
+ pinMode(A0, INPUT_PULLUP);
+ pinMode(LED_BUILTIN, OUTPUT);
+}
+
+void loop() {
+
+ // System Disabled
+ if (digitalRead(A0) != 0)
+ {
+ // Turn indicator light off.
+ digitalWrite(LED_BUILTIN, 0);
+ return;
+ }
+
+ // Turn indicator light on.
+ digitalWrite(LED_BUILTIN, 1);
+
+ if (millis() >= gNextTime)
+ {
+
+ if (gCurrentStep < 33)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testSingleButtonPush(gCurrentStep);
+ }
+ else if (gCurrentStep < 37)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testMultiButtonPush(gCurrentStep - 33);
+ }
+ else if (gCurrentStep < (37 + 256))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testThrottleRudder(gCurrentStep - 37);
+ }
+ else if (gCurrentStep < (37 + 256 + 1024 + 128))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testXYAxis(gCurrentStep - (37 + 256));
+ }
+ else if (gCurrentStep < (37 + 256 + 1024 + 128 + 510))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testZAxis(gCurrentStep - (37 + 256 + 1024 + 128));
+ }
+ else if (gCurrentStep < (37 + 256 + 1024 + 128 + 510 + 28))
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testHatSwitch(gCurrentStep - (37 + 256 + 1024 + 128 + 510));
+ }
+ else if (gCurrentStep < (37 + 256 + 1024 + 128 + 510 + 28 + 360))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testXYZAxisRotation(gCurrentStep - (37 + 256 + 1024 + 128 + 510 + 28));
+ }
+
+ if (testAutoSendMode == false)
+ {
+ Joystick.sendState();
+ }
+
+ gCurrentStep++;
+ if (gCurrentStep == (37 + 256 + 1024 + 128 + 510 + 28 + 360))
+ {
+ gNextTime = millis() + gcCycleDelta;
+ gCurrentStep = 0;
+ }
+ }
+}
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/MultipleJoystickTest/MultipleJoystickTest.ino b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/MultipleJoystickTest/MultipleJoystickTest.ino
new file mode 100644
index 0000000..60735c1
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/examples/MultipleJoystickTest/MultipleJoystickTest.ino
@@ -0,0 +1,180 @@
+// Program used to test using the Arduino Joystick Library
+// to create multiple Joystick objects on a single Arduino
+// Leonardo or Arduino Micro.
+//
+// Each joystick has a unique configuration.
+//
+// Matthew Heironimus
+// 2016-05-13 - Original Version
+// 2022-03-29 - Updated to work with Joystick Library v2.1.0
+//------------------------------------------------------------
+#include
+
+#define JOYSTICK_COUNT 4
+
+Joystick_ Joystick[JOYSTICK_COUNT] = {
+ Joystick_(0x03, JOYSTICK_TYPE_JOYSTICK, 4, 2, true, true, false, false, false, false, false, false, false, false, false),
+ Joystick_(0x04, JOYSTICK_TYPE_JOYSTICK, 8, 1, true, true, true, true, false, false, false, false, false, false, false),
+ Joystick_(0x05, JOYSTICK_TYPE_JOYSTICK, 16, 0, false, true, false, true, false, false, true, true, false, false, false),
+ Joystick_(0x06, JOYSTICK_TYPE_JOYSTICK, 32, 1, true, true, false, true, true, false, false, false, false, false, false)
+};
+
+// Set to true to test "Auto Send" mode or false to test "Manual Send" mode.
+//const bool testAutoSendMode = true;
+const bool testAutoSendMode = false;
+
+const unsigned long gcCycleDelta = 1000;
+const unsigned long gcAnalogDelta = 25;
+const unsigned long gcButtonDelta = 500;
+unsigned long gNextTime = 0;
+unsigned int gCurrentStep = 0;
+int gJoystickId = 0;
+
+void testSingleButtonPush(int joystickId, unsigned int button)
+{
+ if (button > 0)
+ {
+ Joystick[joystickId].releaseButton(button - 1);
+ }
+ if (button < 16)
+ {
+ Joystick[joystickId].pressButton(button);
+ }
+}
+
+void testMultiButtonPush(int joystickId, unsigned int currentStep)
+{
+ for (int button = 0; button < 16; button++)
+ {
+ if ((currentStep == 0) || (currentStep == 2))
+ {
+ if ((button % 2) == 0)
+ {
+ Joystick[joystickId].pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick[joystickId].releaseButton(button);
+ }
+ } // if ((currentStep == 0) || (currentStep == 2))
+ if ((currentStep == 1) || (currentStep == 2))
+ {
+ if ((button % 2) != 0)
+ {
+ Joystick[joystickId].pressButton(button);
+ } else if (currentStep != 2)
+ {
+ Joystick[joystickId].releaseButton(button);
+ }
+ } // if ((currentStep == 1) || (currentStep == 2))
+ if (currentStep == 3)
+ {
+ Joystick[joystickId].releaseButton(button);
+ } // if (currentStep == 3)
+ } // for (int button = 0; button < 32; button++)
+}
+
+void testXYAxis(int joystickId, unsigned int currentStep)
+{
+ int x;
+ int y;
+
+ if (currentStep < 255)
+ {
+ x = currentStep - 127;
+ y = -127;
+ }
+ else if (currentStep < 510)
+ {
+ x = 127;
+ y = currentStep - 255 - 127;
+ }
+ else if (currentStep < 765)
+ {
+ x = 127 - (currentStep - 510);
+ y = 127;
+ }
+ else if (currentStep < 1020)
+ {
+ x = -127;
+ y = 127 - (currentStep - 765);
+ }
+ else if (currentStep <= 1020 + 127)
+ {
+ x = currentStep - 1020 - 127;
+ y = currentStep - 1020 - 127;
+ }
+
+ Joystick[joystickId].setXAxis(x);
+ Joystick[joystickId].setYAxis(y);
+}
+
+void setup() {
+
+ for (int index = 0; index < JOYSTICK_COUNT; index++)
+ {
+ Joystick[index].setXAxisRange(-127, 127);
+ Joystick[index].setYAxisRange(-127, 127);
+
+ if (testAutoSendMode)
+ {
+ Joystick[index].begin();
+ }
+ else
+ {
+ Joystick[index].begin(false);
+ }
+ }
+
+ pinMode(A0, INPUT_PULLUP);
+ pinMode(LED_BUILTIN, OUTPUT);
+}
+
+void loop() {
+
+ // System Disabled
+ if (digitalRead(A0) != 0)
+ {
+ digitalWrite(LED_BUILTIN, 0);
+ return;
+ }
+
+ // Turn indicator light on.
+ digitalWrite(LED_BUILTIN, 1);
+
+ if (millis() >= gNextTime)
+ {
+
+ if (gCurrentStep < 17)
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testSingleButtonPush(gJoystickId, gCurrentStep);
+ }
+ else if (gCurrentStep < (17 + 4))
+ {
+ gNextTime = millis() + gcButtonDelta;
+ testMultiButtonPush(gJoystickId, gCurrentStep - 17);
+ }
+ else if (gCurrentStep < (17 + 4 + 1024 + 128))
+ {
+ gNextTime = millis() + gcAnalogDelta;
+ testXYAxis(gJoystickId, gCurrentStep - (17 + 4));
+ }
+
+ if (testAutoSendMode == false)
+ {
+ Joystick[gJoystickId].sendState();
+ }
+
+ gCurrentStep++;
+ if (gCurrentStep == (17 + 4 + 1024 + 128))
+ {
+ gNextTime = millis() + gcCycleDelta;
+ gCurrentStep = 0;
+
+ if (++gJoystickId >= JOYSTICK_COUNT)
+ {
+ gJoystickId = 0;
+ }
+ }
+ }
+}
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/library.properties b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/library.properties
new file mode 100644
index 0000000..3e3fe88
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/library.properties
@@ -0,0 +1,9 @@
+name=Joystick
+version=2.1.1
+author=Matthew Heironimus
+maintainer=Matthew Heironimus
+sentence=Allows an Arduino board with USB capabilities (e.g. Leonardo, Arduino Micro, Arudino Due, etc.) to appear as a Joystick or Gamepad.
+paragraph=This library is built on the PluggableUSB library. It can be used with or without other HID-based libraries (Mouse, Keyboard, etc.).
+category=Device Control
+url=https://github.com/MHeironimus/ArduinoJoystickLibrary
+architectures=avr,sam
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.cpp b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.cpp
new file mode 100644
index 0000000..6c46a2c
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.cpp
@@ -0,0 +1,169 @@
+/*
+ Modified by Matthew Heironimus to support HID Report Descriptors to be in
+ standard RAM in addition to program memory (PROGMEM).
+
+ Copyright (c) 2015, Arduino LLC
+ Original code (pre-library): Copyright (c) 2011, Peter Barrett
+
+ Permission to use, copy, modify, and/or distribute this software for
+ any purpose with or without fee is hereby granted, provided that the
+ above copyright notice and this permission notice appear in all copies.
+
+ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+ WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR
+ BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES
+ OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+ WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
+ SOFTWARE.
+ */
+
+#include "DynamicHID.h"
+
+#if defined(USBCON)
+
+#ifdef _VARIANT_ARDUINO_DUE_X_
+#define USB_SendControl USBD_SendControl
+#define USB_Send USBD_Send
+#endif
+
+DynamicHID_& DynamicHID()
+{
+ static DynamicHID_ obj;
+ return obj;
+}
+
+int DynamicHID_::getInterface(uint8_t* interfaceCount)
+{
+ *interfaceCount += 1; // uses 1
+ DYNAMIC_HIDDescriptor hidInterface = {
+ D_INTERFACE(pluggedInterface, 1, USB_DEVICE_CLASS_HUMAN_INTERFACE, DYNAMIC_HID_SUBCLASS_NONE, DYNAMIC_HID_PROTOCOL_NONE),
+ D_HIDREPORT(descriptorSize),
+ D_ENDPOINT(USB_ENDPOINT_IN(pluggedEndpoint), USB_ENDPOINT_TYPE_INTERRUPT, USB_EP_SIZE, 0x01)
+ };
+ return USB_SendControl(0, &hidInterface, sizeof(hidInterface));
+}
+
+int DynamicHID_::getDescriptor(USBSetup& setup)
+{
+ // Check if this is a HID Class Descriptor request
+ if (setup.bmRequestType != REQUEST_DEVICETOHOST_STANDARD_INTERFACE) { return 0; }
+ if (setup.wValueH != DYNAMIC_HID_REPORT_DESCRIPTOR_TYPE) { return 0; }
+
+ // In a HID Class Descriptor wIndex cointains the interface number
+ if (setup.wIndex != pluggedInterface) { return 0; }
+
+ int total = 0;
+ DynamicHIDSubDescriptor* node;
+ for (node = rootNode; node; node = node->next) {
+ int res = USB_SendControl((node->inProgMem ? TRANSFER_PGM : 0), node->data, node->length);
+ if (res == -1)
+ return -1;
+ total += res;
+ }
+
+ // Reset the protocol on reenumeration. Normally the host should not assume the state of the protocol
+ // due to the USB specs, but Windows and Linux just assumes its in report mode.
+ protocol = DYNAMIC_HID_REPORT_PROTOCOL;
+
+ return total;
+}
+
+uint8_t DynamicHID_::getShortName(char *name)
+{
+ name[0] = 'H';
+ name[1] = 'I';
+ name[2] = 'D';
+ name[3] = 'A' + (descriptorSize & 0x0F);
+ name[4] = 'A' + ((descriptorSize >> 4) & 0x0F);
+ return 5;
+}
+
+void DynamicHID_::AppendDescriptor(DynamicHIDSubDescriptor *node)
+{
+ if (!rootNode) {
+ rootNode = node;
+ } else {
+ DynamicHIDSubDescriptor *current = rootNode;
+ while (current->next) {
+ current = current->next;
+ }
+ current->next = node;
+ }
+ descriptorSize += node->length;
+}
+
+int DynamicHID_::SendReport(uint8_t id, const void* data, int len)
+{
+ uint8_t p[len + 1];
+ p[0] = id;
+ memcpy(&p[1], data, len);
+ return USB_Send(pluggedEndpoint | TRANSFER_RELEASE, p, len + 1);
+}
+
+bool DynamicHID_::setup(USBSetup& setup)
+{
+ if (pluggedInterface != setup.wIndex) {
+ return false;
+ }
+
+ uint8_t request = setup.bRequest;
+ uint8_t requestType = setup.bmRequestType;
+
+ if (requestType == REQUEST_DEVICETOHOST_CLASS_INTERFACE)
+ {
+ if (request == DYNAMIC_HID_GET_REPORT) {
+ // TODO: DYNAMIC_HID_GetReport();
+ return true;
+ }
+ if (request == DYNAMIC_HID_GET_PROTOCOL) {
+ // TODO: Send8(protocol);
+ return true;
+ }
+ if (request == DYNAMIC_HID_GET_IDLE) {
+ // TODO: Send8(idle);
+ }
+ }
+
+ if (requestType == REQUEST_HOSTTODEVICE_CLASS_INTERFACE)
+ {
+ if (request == DYNAMIC_HID_SET_PROTOCOL) {
+ // The USB Host tells us if we are in boot or report mode.
+ // This only works with a real boot compatible device.
+ protocol = setup.wValueL;
+ return true;
+ }
+ if (request == DYNAMIC_HID_SET_IDLE) {
+ idle = setup.wValueL;
+ return true;
+ }
+ if (request == DYNAMIC_HID_SET_REPORT)
+ {
+ //uint8_t reportID = setup.wValueL;
+ //uint16_t length = setup.wLength;
+ //uint8_t data[length];
+ // Make sure to not read more data than USB_EP_SIZE.
+ // You can read multiple times through a loop.
+ // The first byte (may!) contain the reportID on a multreport.
+ //USB_RecvControl(data, length);
+ }
+ }
+
+ return false;
+}
+
+DynamicHID_::DynamicHID_(void) : PluggableUSBModule(1, 1, epType),
+ rootNode(NULL), descriptorSize(0),
+ protocol(DYNAMIC_HID_REPORT_PROTOCOL), idle(1)
+{
+ epType[0] = EP_TYPE_INTERRUPT_IN;
+ PluggableUSB().plug(this);
+}
+
+int DynamicHID_::begin(void)
+{
+ return 0;
+}
+
+#endif /* if defined(USBCON) */
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.h b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.h
new file mode 100644
index 0000000..0a9a6ef
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/DynamicHID/DynamicHID.h
@@ -0,0 +1,144 @@
+/*
+ Modified by Matthew Heironimus to support HID Report Descriptors to be in
+ standard RAM in addition to program memory (PROGMEM).
+
+ Copyright (c) 2015, Arduino LLC
+ Original code (pre-library): Copyright (c) 2011, Peter Barrett
+
+ Permission to use, copy, modify, and/or distribute this software for
+ any purpose with or without fee is hereby granted, provided that the
+ above copyright notice and this permission notice appear in all copies.
+
+ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+ WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR
+ BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES
+ OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+ WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
+ SOFTWARE.
+ */
+
+#ifndef DYNAMIC_HID_h
+#define DYNAMIC_HID_h
+
+#include
+#include
+
+#ifdef _VARIANT_ARDUINO_DUE_X_
+ // The following values are the same as AVR's USBAPI.h
+ // Reproduced here because SAM doesn't have these in
+ // its own USBAPI.H
+ #define USB_EP_SIZE 64
+ #define TRANSFER_PGM 0x80
+
+ #include "USB/PluggableUSB.h"
+#else
+ #include "PluggableUSB.h"
+#endif
+
+#if defined(USBCON)
+
+#define _USING_DYNAMIC_HID
+
+// DYNAMIC_HID 'Driver'
+// ------------
+#define DYNAMIC_HID_GET_REPORT 0x01
+#define DYNAMIC_HID_GET_IDLE 0x02
+#define DYNAMIC_HID_GET_PROTOCOL 0x03
+#define DYNAMIC_HID_SET_REPORT 0x09
+#define DYNAMIC_HID_SET_IDLE 0x0A
+#define DYNAMIC_HID_SET_PROTOCOL 0x0B
+
+#define DYNAMIC_HID_DESCRIPTOR_TYPE 0x21
+#define DYNAMIC_HID_REPORT_DESCRIPTOR_TYPE 0x22
+#define DYNAMIC_HID_PHYSICAL_DESCRIPTOR_TYPE 0x23
+
+// HID subclass HID1.11 Page 8 4.2 Subclass
+#define DYNAMIC_HID_SUBCLASS_NONE 0
+#define DYNAMIC_HID_SUBCLASS_BOOT_INTERFACE 1
+
+// HID Keyboard/Mouse bios compatible protocols HID1.11 Page 9 4.3 Protocols
+#define DYNAMIC_HID_PROTOCOL_NONE 0
+#define DYNAMIC_HID_PROTOCOL_KEYBOARD 1
+#define DYNAMIC_HID_PROTOCOL_MOUSE 2
+
+// Normal or bios protocol (Keyboard/Mouse) HID1.11 Page 54 7.2.5 Get_Protocol Request
+// "protocol" variable is used for this purpose.
+#define DYNAMIC_HID_BOOT_PROTOCOL 0
+#define DYNAMIC_HID_REPORT_PROTOCOL 1
+
+// HID Request Type HID1.11 Page 51 7.2.1 Get_Report Request
+#define DYNAMIC_HID_REPORT_TYPE_INPUT 1
+#define DYNAMIC_HID_REPORT_TYPE_OUTPUT 2
+#define DYNAMIC_HID_REPORT_TYPE_FEATURE 3
+
+typedef struct
+{
+ uint8_t len; // 9
+ uint8_t dtype; // 0x21
+ uint8_t addr;
+ uint8_t versionL; // 0x101
+ uint8_t versionH; // 0x101
+ uint8_t country;
+ uint8_t desctype; // 0x22 report
+ uint8_t descLenL;
+ uint8_t descLenH;
+} DYNAMIC_HIDDescDescriptor;
+
+typedef struct
+{
+ InterfaceDescriptor hid;
+ DYNAMIC_HIDDescDescriptor desc;
+ EndpointDescriptor in;
+} DYNAMIC_HIDDescriptor;
+
+class DynamicHIDSubDescriptor {
+public:
+ DynamicHIDSubDescriptor *next = NULL;
+ DynamicHIDSubDescriptor(const void *d, const uint16_t l, const bool ipm = true) : data(d), length(l), inProgMem(ipm) { }
+
+ const void* data;
+ const uint16_t length;
+ const bool inProgMem;
+};
+
+class DynamicHID_ : public PluggableUSBModule
+{
+public:
+ DynamicHID_(void);
+ int begin(void);
+ int SendReport(uint8_t id, const void* data, int len);
+ void AppendDescriptor(DynamicHIDSubDescriptor* node);
+
+protected:
+ // Implementation of the PluggableUSBModule
+ int getInterface(uint8_t* interfaceCount);
+ int getDescriptor(USBSetup& setup);
+ bool setup(USBSetup& setup);
+ uint8_t getShortName(char* name);
+
+private:
+ #ifdef _VARIANT_ARDUINO_DUE_X_
+ uint32_t epType[1];
+ #else
+ uint8_t epType[1];
+ #endif
+
+ DynamicHIDSubDescriptor* rootNode;
+ uint16_t descriptorSize;
+
+ uint8_t protocol;
+ uint8_t idle;
+};
+
+// Replacement for global singleton.
+// This function prevents static-initialization-order-fiasco
+// https://isocpp.org/wiki/faq/ctors#static-init-order-on-first-use
+DynamicHID_& DynamicHID();
+
+#define D_HIDREPORT(length) { 9, 0x21, 0x01, 0x01, 0, 1, 0x22, lowByte(length), highByte(length) }
+
+#endif // USBCON
+
+#endif // DYNAMIC_HID_h
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.cpp b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.cpp
new file mode 100644
index 0000000..8777cc3
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.cpp
@@ -0,0 +1,716 @@
+/*
+ JoystickMH.cpp
+
+ Copyright (c) 2015-2017, Matthew Heironimus
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+*/
+
+#include "JoystickMHX.h"
+
+#if defined(_USING_DYNAMIC_HID)
+
+#define JOYSTICK_REPORT_ID_INDEX 7
+#define JOYSTICK_AXIS_MINIMUM -32767
+#define JOYSTICK_AXIS_MAXIMUM 32767
+#define JOYSTICK_SIMULATOR_MINIMUM -32767
+#define JOYSTICK_SIMULATOR_MAXIMUM 32767
+
+#define JOYSTICK_INCLUDE_X_AXIS B00000001
+#define JOYSTICK_INCLUDE_Y_AXIS B00000010
+#define JOYSTICK_INCLUDE_Z_AXIS B00000100
+#define JOYSTICK_INCLUDE_RX_AXIS B00001000
+#define JOYSTICK_INCLUDE_RY_AXIS B00010000
+#define JOYSTICK_INCLUDE_RZ_AXIS B00100000
+#define JOYSTICK_INCLUDE_S_AXIS B01000000
+#define JOYSTICK_INCLUDE_D_AXIS B10000000
+
+#define JOYSTICK_INCLUDE_RUDDER B00000001
+#define JOYSTICK_INCLUDE_THROTTLE B00000010
+#define JOYSTICK_INCLUDE_ACCELERATOR B00000100
+#define JOYSTICK_INCLUDE_BRAKE B00001000
+#define JOYSTICK_INCLUDE_STEERING B00010000
+
+Joystick_::Joystick_(
+ uint8_t hidReportId,
+ uint8_t joystickType,
+ uint8_t buttonCount,
+ uint8_t hatSwitchCount,
+ bool includeXAxis,
+ bool includeYAxis,
+ bool includeZAxis,
+ bool includeRxAxis,
+ bool includeRyAxis,
+ bool includeRzAxis,
+ bool includeSlider,
+ bool includeDial,
+ bool includeRudder,
+ bool includeThrottle,
+ bool includeAccelerator,
+ bool includeBrake,
+ bool includeSteering)
+{
+ // Set the USB HID Report ID
+ _hidReportId = hidReportId;
+
+ // Save Joystick Settings
+ _buttonCount = buttonCount;
+ _hatSwitchCount = hatSwitchCount;
+ _includeAxisFlags = 0;
+ _includeAxisFlags |= (includeXAxis ? JOYSTICK_INCLUDE_X_AXIS : 0);
+ _includeAxisFlags |= (includeYAxis ? JOYSTICK_INCLUDE_Y_AXIS : 0);
+ _includeAxisFlags |= (includeZAxis ? JOYSTICK_INCLUDE_Z_AXIS : 0);
+ _includeAxisFlags |= (includeRxAxis ? JOYSTICK_INCLUDE_RX_AXIS : 0);
+ _includeAxisFlags |= (includeRyAxis ? JOYSTICK_INCLUDE_RY_AXIS : 0);
+ _includeAxisFlags |= (includeRzAxis ? JOYSTICK_INCLUDE_RZ_AXIS : 0);
+ _includeAxisFlags |= (includeSlider ? JOYSTICK_INCLUDE_S_AXIS : 0);
+ _includeAxisFlags |= (includeDial ? JOYSTICK_INCLUDE_D_AXIS : 0);
+ _includeSimulatorFlags = 0;
+ _includeSimulatorFlags |= (includeRudder ? JOYSTICK_INCLUDE_RUDDER : 0);
+ _includeSimulatorFlags |= (includeThrottle ? JOYSTICK_INCLUDE_THROTTLE : 0);
+ _includeSimulatorFlags |= (includeAccelerator ? JOYSTICK_INCLUDE_ACCELERATOR : 0);
+ _includeSimulatorFlags |= (includeBrake ? JOYSTICK_INCLUDE_BRAKE : 0);
+ _includeSimulatorFlags |= (includeSteering ? JOYSTICK_INCLUDE_STEERING : 0);
+
+ // Build Joystick HID Report Description
+
+ // Button Calculations
+ uint8_t buttonsInLastByte = _buttonCount % 8;
+ uint8_t buttonPaddingBits = 0;
+ if (buttonsInLastByte > 0)
+ {
+ buttonPaddingBits = 8 - buttonsInLastByte;
+ }
+
+ // Axis Calculations
+ uint8_t axisCount = (includeXAxis == true)
+ + (includeYAxis == true)
+ + (includeZAxis == true)
+ + (includeRxAxis == true)
+ + (includeRyAxis == true)
+ + (includeRzAxis == true)
+ + (includeSlider == true)
+ + (includeDial == true);
+
+ uint8_t simulationCount = (includeRudder == true)
+ + (includeThrottle == true)
+ + (includeAccelerator == true)
+ + (includeBrake == true)
+ + (includeSteering == true);
+
+ uint8_t tempHidReportDescriptor[150];
+ int hidReportDescriptorSize = 0;
+
+ // USAGE_PAGE (Generic Desktop)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x05;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // USAGE (Joystick - 0x04; Gamepad - 0x05; Multi-axis Controller - 0x08)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = joystickType;
+
+ // COLLECTION (Application)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xa1;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // REPORT_ID (Default: 3)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x85;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = _hidReportId;
+
+ if (_buttonCount > 0) {
+
+ // USAGE_PAGE (Button)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x05;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+
+ // USAGE_MINIMUM (Button 1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x19;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // USAGE_MAXIMUM (Button 32)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x29;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = _buttonCount;
+
+ // LOGICAL_MINIMUM (0)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x15;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // LOGICAL_MAXIMUM (1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x25;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // REPORT_SIZE (1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // REPORT_COUNT (# of buttons)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = _buttonCount;
+
+ // UNIT_EXPONENT (0)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x55;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // UNIT (None)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x65;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // INPUT (Data,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x02;
+
+ if (buttonPaddingBits > 0) {
+
+ // REPORT_SIZE (1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // REPORT_COUNT (# of padding bits)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = buttonPaddingBits;
+
+ // INPUT (Const,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x03;
+
+ } // Padding Bits Needed
+
+ } // Buttons
+
+ if ((axisCount > 0) || (_hatSwitchCount > 0)) {
+
+ // USAGE_PAGE (Generic Desktop)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x05;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ }
+
+ if (_hatSwitchCount > 0) {
+
+ // USAGE (Hat Switch)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x39;
+
+ // LOGICAL_MINIMUM (0)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x15;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // LOGICAL_MAXIMUM (7)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x25;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x07;
+
+ // PHYSICAL_MINIMUM (0)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x35;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // PHYSICAL_MAXIMUM (315)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x46;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x3B;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // UNIT (Eng Rot:Angular Pos)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x65;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x14;
+
+ // REPORT_SIZE (4)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x04;
+
+ // REPORT_COUNT (1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // INPUT (Data,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x02;
+
+ if (_hatSwitchCount > 1) {
+
+ // USAGE (Hat Switch)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x39;
+
+ // LOGICAL_MINIMUM (0)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x15;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // LOGICAL_MAXIMUM (7)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x25;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x07;
+
+ // PHYSICAL_MINIMUM (0)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x35;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ // PHYSICAL_MAXIMUM (315)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x46;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x3B;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // UNIT (Eng Rot:Angular Pos)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x65;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x14;
+
+ // REPORT_SIZE (4)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x04;
+
+ // REPORT_COUNT (1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // INPUT (Data,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x02;
+
+ } else {
+
+ // Use Padding Bits
+
+ // REPORT_SIZE (1)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // REPORT_COUNT (4)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x04;
+
+ // INPUT (Const,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x03;
+
+ } // One or Two Hat Switches?
+
+ } // Hat Switches
+
+ if (axisCount > 0) {
+
+ // USAGE (Pointer)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+
+ // LOGICAL_MINIMUM (-32767)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x16;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x80;
+
+ // LOGICAL_MAXIMUM (+32767)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x26;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xFF;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x7F;
+
+ // REPORT_SIZE (16)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x10;
+
+ // REPORT_COUNT (axisCount)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = axisCount;
+
+ // COLLECTION (Physical)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xA1;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ if (includeXAxis == true) {
+ // USAGE (X)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x30;
+ }
+
+ if (includeYAxis == true) {
+ // USAGE (Y)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x31;
+ }
+
+ if (includeZAxis == true) {
+ // USAGE (Z)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x32;
+ }
+
+ if (includeRxAxis == true) {
+ // USAGE (Rx)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x33;
+ }
+
+ if (includeRyAxis == true) {
+ // USAGE (Ry)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x34;
+ }
+
+ if (includeRzAxis == true) {
+ // USAGE (Rz)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x35;
+ }
+
+ if (includeSlider == true) {
+ // USAGE (Rz)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x36;
+ }
+
+ if (includeDial == true) {
+ // USAGE (Rz)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x37;
+ }
+
+ // INPUT (Data,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x02;
+
+ // END_COLLECTION (Physical)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xc0;
+
+ } // X, Y, Z, Rx, Ry, and Rz Axis
+
+ if (simulationCount > 0) {
+
+ // USAGE_PAGE (Simulation Controls)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x05;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x02;
+
+ // LOGICAL_MINIMUM (-32767)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x16;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x01;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x80;
+
+ // LOGICAL_MAXIMUM (+32767)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x26;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xFF;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x7F;
+
+ // REPORT_SIZE (16)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x75;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x10;
+
+ // REPORT_COUNT (simulationCount)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x95;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = simulationCount;
+
+ // COLLECTION (Physical)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xA1;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x00;
+
+ if (includeRudder == true) {
+ // USAGE (Rudder)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xBA;
+ }
+
+ if (includeThrottle == true) {
+ // USAGE (Throttle)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xBB;
+ }
+
+ if (includeAccelerator == true) {
+ // USAGE (Accelerator)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xC4;
+ }
+
+ if (includeBrake == true) {
+ // USAGE (Brake)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xC5;
+ }
+
+ if (includeSteering == true) {
+ // USAGE (Steering)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x09;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xC8;
+ }
+
+ // INPUT (Data,Var,Abs)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x81;
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0x02;
+
+ // END_COLLECTION (Physical)
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xc0;
+
+ } // Simulation Controls
+
+ // END_COLLECTION
+ tempHidReportDescriptor[hidReportDescriptorSize++] = 0xc0;
+
+ // Create a copy of the HID Report Descriptor template that is just the right size
+ uint8_t *customHidReportDescriptor = new uint8_t[hidReportDescriptorSize];
+ memcpy(customHidReportDescriptor, tempHidReportDescriptor, hidReportDescriptorSize);
+
+ // Register HID Report Description
+ DynamicHIDSubDescriptor *node = new DynamicHIDSubDescriptor(customHidReportDescriptor, hidReportDescriptorSize, false);
+ DynamicHID().AppendDescriptor(node);
+
+ // Setup Joystick State
+ if (buttonCount > 0) {
+ _buttonValuesArraySize = _buttonCount / 8;
+ if ((_buttonCount % 8) > 0) {
+ _buttonValuesArraySize++;
+ }
+ _buttonValues = new uint8_t[_buttonValuesArraySize];
+ }
+
+ // Calculate HID Report Size
+ _hidReportSize = _buttonValuesArraySize;
+ _hidReportSize += (_hatSwitchCount > 0);
+ _hidReportSize += (axisCount * 2);
+ _hidReportSize += (simulationCount * 2);
+
+ // Initalize Joystick State
+ _xAxis = 0;
+ _yAxis = 0;
+ _zAxis = 0;
+ _xAxisRotation = 0;
+ _yAxisRotation = 0;
+ _zAxisRotation = 0;
+ _slider = 0;
+ _dial = 0;
+ _throttle = 0;
+ _rudder = 0;
+ _accelerator = 0;
+ _brake = 0;
+ _steering = 0;
+ for (int index = 0; index < JOYSTICK_HATSWITCH_COUNT_MAXIMUM; index++)
+ {
+ _hatSwitchValues[index] = JOYSTICK_HATSWITCH_RELEASE;
+ }
+ for (int index = 0; index < _buttonValuesArraySize; index++)
+ {
+ _buttonValues[index] = 0;
+ }
+}
+
+void Joystick_::begin(bool initAutoSendState)
+{
+ _autoSendState = initAutoSendState;
+ sendState();
+}
+
+void Joystick_::end()
+{
+}
+
+void Joystick_::setButton(uint8_t button, uint8_t value)
+{
+ if (value == 0)
+ {
+ releaseButton(button);
+ }
+ else
+ {
+ pressButton(button);
+ }
+}
+void Joystick_::pressButton(uint8_t button)
+{
+ if (button >= _buttonCount) return;
+
+ int index = button / 8;
+ int bit = button % 8;
+
+ bitSet(_buttonValues[index], bit);
+ if (_autoSendState) sendState();
+}
+void Joystick_::releaseButton(uint8_t button)
+{
+ if (button >= _buttonCount) return;
+
+ int index = button / 8;
+ int bit = button % 8;
+
+ bitClear(_buttonValues[index], bit);
+ if (_autoSendState) sendState();
+}
+
+void Joystick_::setXAxis(int16_t value)
+{
+ _xAxis = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setYAxis(int16_t value)
+{
+ _yAxis = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setZAxis(int16_t value)
+{
+ _zAxis = value;
+ if (_autoSendState) sendState();
+}
+
+void Joystick_::setRxAxis(int16_t value)
+{
+ _xAxisRotation = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setRyAxis(int16_t value)
+{
+ _yAxisRotation = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setRzAxis(int16_t value)
+{
+ _zAxisRotation = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setSlider(int16_t value)
+{
+ _slider = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setDial(int16_t value)
+{
+ _dial = value;
+ if (_autoSendState) sendState();
+}
+
+
+void Joystick_::setRudder(int16_t value)
+{
+ _rudder = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setThrottle(int16_t value)
+{
+ _throttle = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setAccelerator(int16_t value)
+{
+ _accelerator = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setBrake(int16_t value)
+{
+ _brake = value;
+ if (_autoSendState) sendState();
+}
+void Joystick_::setSteering(int16_t value)
+{
+ _steering = value;
+ if (_autoSendState) sendState();
+}
+
+void Joystick_::setHatSwitch(int8_t hatSwitchIndex, int16_t value)
+{
+ if (hatSwitchIndex >= _hatSwitchCount) return;
+
+ _hatSwitchValues[hatSwitchIndex] = value;
+ if (_autoSendState) sendState();
+}
+
+int Joystick_::buildAndSet16BitValue(bool includeValue, int16_t value, int16_t valueMinimum, int16_t valueMaximum, int16_t actualMinimum, int16_t actualMaximum, uint8_t dataLocation[])
+{
+ int16_t convertedValue;
+ uint8_t highByte;
+ uint8_t lowByte;
+ int16_t realMinimum = min(valueMinimum, valueMaximum);
+ int16_t realMaximum = max(valueMinimum, valueMaximum);
+
+ if (includeValue == false) return 0;
+
+ if (value < realMinimum) {
+ value = realMinimum;
+ }
+ if (value > realMaximum) {
+ value = realMaximum;
+ }
+
+ if (valueMinimum > valueMaximum) {
+ // Values go from a larger number to a smaller number (e.g. 1024 to 0)
+ value = realMaximum - value + realMinimum;
+ }
+
+ convertedValue = map(value, realMinimum, realMaximum, actualMinimum, actualMaximum);
+
+ highByte = (uint8_t)(convertedValue >> 8);
+ lowByte = (uint8_t)(convertedValue & 0x00FF);
+
+ dataLocation[0] = lowByte;
+ dataLocation[1] = highByte;
+
+ return 2;
+}
+
+int Joystick_::buildAndSetAxisValue(bool includeAxis, int16_t axisValue, int16_t axisMinimum, int16_t axisMaximum, uint8_t dataLocation[])
+{
+ return buildAndSet16BitValue(includeAxis, axisValue, axisMinimum, axisMaximum, JOYSTICK_AXIS_MINIMUM, JOYSTICK_AXIS_MAXIMUM, dataLocation);
+}
+
+int Joystick_::buildAndSetSimulationValue(bool includeValue, int16_t value, int16_t valueMinimum, int16_t valueMaximum, uint8_t dataLocation[])
+{
+ return buildAndSet16BitValue(includeValue, value, valueMinimum, valueMaximum, JOYSTICK_SIMULATOR_MINIMUM, JOYSTICK_SIMULATOR_MAXIMUM, dataLocation);
+}
+
+void Joystick_::sendState()
+{
+ uint8_t data[_hidReportSize];
+ int index = 0;
+
+ // Load Button State
+ for (; index < _buttonValuesArraySize; index++)
+ {
+ data[index] = _buttonValues[index];
+ }
+
+ // Set Hat Switch Values
+ if (_hatSwitchCount > 0) {
+
+ // Calculate hat-switch values
+ uint8_t convertedHatSwitch[JOYSTICK_HATSWITCH_COUNT_MAXIMUM];
+ for (int hatSwitchIndex = 0; hatSwitchIndex < JOYSTICK_HATSWITCH_COUNT_MAXIMUM; hatSwitchIndex++)
+ {
+ if (_hatSwitchValues[hatSwitchIndex] < 0)
+ {
+ convertedHatSwitch[hatSwitchIndex] = 8;
+ }
+ else
+ {
+ convertedHatSwitch[hatSwitchIndex] = (_hatSwitchValues[hatSwitchIndex] % 360) / 45;
+ }
+ }
+
+ // Pack hat-switch states into a single byte
+ data[index++] = (convertedHatSwitch[1] << 4) | (B00001111 & convertedHatSwitch[0]);
+
+ } // Hat Switches
+
+ // Set Axis Values
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_X_AXIS, _xAxis, _xAxisMinimum, _xAxisMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_Y_AXIS, _yAxis, _yAxisMinimum, _yAxisMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_Z_AXIS, _zAxis, _zAxisMinimum, _zAxisMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_RX_AXIS, _xAxisRotation, _rxAxisMinimum, _rxAxisMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_RY_AXIS, _yAxisRotation, _ryAxisMinimum, _ryAxisMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_RZ_AXIS, _zAxisRotation, _rzAxisMinimum, _rzAxisMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_S_AXIS, _slider, _sliderMinimum, _sliderMaximum, &(data[index]));
+ index += buildAndSetAxisValue(_includeAxisFlags & JOYSTICK_INCLUDE_D_AXIS, _dial, _dialMinimum, _dialMaximum, &(data[index]));
+
+
+ // Set Simulation Values
+ index += buildAndSetSimulationValue(_includeSimulatorFlags & JOYSTICK_INCLUDE_RUDDER, _rudder, _rudderMinimum, _rudderMaximum, &(data[index]));
+ index += buildAndSetSimulationValue(_includeSimulatorFlags & JOYSTICK_INCLUDE_THROTTLE, _throttle, _throttleMinimum, _throttleMaximum, &(data[index]));
+ index += buildAndSetSimulationValue(_includeSimulatorFlags & JOYSTICK_INCLUDE_ACCELERATOR, _accelerator, _acceleratorMinimum, _acceleratorMaximum, &(data[index]));
+ index += buildAndSetSimulationValue(_includeSimulatorFlags & JOYSTICK_INCLUDE_BRAKE, _brake, _brakeMinimum, _brakeMaximum, &(data[index]));
+ index += buildAndSetSimulationValue(_includeSimulatorFlags & JOYSTICK_INCLUDE_STEERING, _steering, _steeringMinimum, _steeringMaximum, &(data[index]));
+
+ DynamicHID().SendReport(_hidReportId, data, _hidReportSize);
+}
+
+#endif
diff --git a/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.h b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.h
new file mode 100644
index 0000000..8999f5a
--- /dev/null
+++ b/translated_sandbox/sbus-to-usb-joystick/ArduinoJoystickLibrary/src/JoystickMHX.h
@@ -0,0 +1,241 @@
+/*
+ JoystickMH.h
+
+ Copyright (c) 2015-2017, Matthew Heironimus
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+*/
+
+#ifndef JOYSTICKMHX_h
+#define JOYSTICKMHX_h
+
+#include "DynamicHID/DynamicHID.h"
+
+#if ARDUINO < 10606
+#error The Joystick library requires Arduino IDE 1.6.6 or greater. Please update your IDE.
+#endif // ARDUINO < 10606
+
+#if ARDUINO > 10606
+#if !defined(USBCON)
+#error The Joystick library can only be used with a USB MCU (e.g. Arduino Leonardo, Arduino Micro, etc.).
+#endif // !defined(USBCON)
+#endif // ARDUINO > 10606
+
+#if !defined(_USING_DYNAMIC_HID)
+
+#warning "Using legacy HID core (non pluggable)"
+
+#else // !defined(_USING_DYNAMIC_HID)
+
+//================================================================================
+// Joystick (Gamepad)
+
+#define JOYSTICK_DEFAULT_REPORT_ID 0x03
+#define JOYSTICK_DEFAULT_BUTTON_COUNT 32
+#define JOYSTICK_DEFAULT_AXIS_MINIMUM 0
+#define JOYSTICK_DEFAULT_AXIS_MAXIMUM 1023
+#define JOYSTICK_DEFAULT_SIMULATOR_MINIMUM 0
+#define JOYSTICK_DEFAULT_SIMULATOR_MAXIMUM 1023
+#define JOYSTICK_DEFAULT_HATSWITCH_COUNT 2
+#define JOYSTICK_HATSWITCH_COUNT_MAXIMUM 2
+#define JOYSTICK_HATSWITCH_RELEASE -1
+#define JOYSTICK_TYPE_JOYSTICK 0x04
+#define JOYSTICK_TYPE_GAMEPAD 0x05
+#define JOYSTICK_TYPE_MULTI_AXIS 0x08
+
+class Joystick_
+{
+private:
+
+ // Joystick State
+ int16_t _xAxis;
+ int16_t _yAxis;
+ int16_t _zAxis;
+ int16_t _xAxisRotation;
+ int16_t _yAxisRotation;
+ int16_t _zAxisRotation;
+ int16_t _slider;
+ int16_t _dial;
+
+ int16_t _throttle;
+ int16_t _rudder;
+ int16_t _accelerator;
+ int16_t _brake;
+ int16_t _steering;
+ int16_t _hatSwitchValues[JOYSTICK_HATSWITCH_COUNT_MAXIMUM];
+ uint8_t *_buttonValues = NULL;
+
+ // Joystick Settings
+ bool _autoSendState;
+ uint8_t _buttonCount;
+ uint8_t _buttonValuesArraySize = 0;
+ uint8_t _hatSwitchCount;
+ uint8_t _includeAxisFlags;
+ uint8_t _includeSimulatorFlags;
+ int16_t _xAxisMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _xAxisMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _yAxisMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _yAxisMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _zAxisMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _zAxisMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _rxAxisMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _rxAxisMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _ryAxisMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _ryAxisMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _rzAxisMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _rzAxisMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _sliderMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _sliderMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+ int16_t _dialMinimum = JOYSTICK_DEFAULT_AXIS_MINIMUM;
+ int16_t _dialMaximum = JOYSTICK_DEFAULT_AXIS_MAXIMUM;
+
+ int16_t _rudderMinimum = JOYSTICK_DEFAULT_SIMULATOR_MINIMUM;
+ int16_t _rudderMaximum = JOYSTICK_DEFAULT_SIMULATOR_MAXIMUM;
+ int16_t _throttleMinimum = JOYSTICK_DEFAULT_SIMULATOR_MINIMUM;
+ int16_t _throttleMaximum = JOYSTICK_DEFAULT_SIMULATOR_MAXIMUM;
+ int16_t _acceleratorMinimum = JOYSTICK_DEFAULT_SIMULATOR_MINIMUM;
+ int16_t _acceleratorMaximum = JOYSTICK_DEFAULT_SIMULATOR_MAXIMUM;
+ int16_t _brakeMinimum = JOYSTICK_DEFAULT_SIMULATOR_MINIMUM;
+ int16_t _brakeMaximum = JOYSTICK_DEFAULT_SIMULATOR_MAXIMUM;
+ int16_t _steeringMinimum = JOYSTICK_DEFAULT_SIMULATOR_MINIMUM;
+ int16_t _steeringMaximum = JOYSTICK_DEFAULT_SIMULATOR_MAXIMUM;
+
+ uint8_t _hidReportId;
+ uint8_t _hidReportSize;
+
+protected:
+ int buildAndSet16BitValue(bool includeValue, int16_t value, int16_t valueMinimum, int16_t valueMaximum, int16_t actualMinimum, int16_t actualMaximum, uint8_t dataLocation[]);
+ int buildAndSetAxisValue(bool includeAxis, int16_t axisValue, int16_t axisMinimum, int16_t axisMaximum, uint8_t dataLocation[]);
+ int buildAndSetSimulationValue(bool includeValue, int16_t value, int16_t valueMinimum, int16_t valueMaximum, uint8_t dataLocation[]);
+
+public:
+ Joystick_(
+ uint8_t hidReportId = JOYSTICK_DEFAULT_REPORT_ID,
+ uint8_t joystickType = JOYSTICK_TYPE_JOYSTICK,
+ uint8_t buttonCount = JOYSTICK_DEFAULT_BUTTON_COUNT,
+ uint8_t hatSwitchCount = JOYSTICK_DEFAULT_HATSWITCH_COUNT,
+ bool includeXAxis = true,
+ bool includeYAxis = true,
+ bool includeZAxis = true,
+ bool includeRxAxis = true,
+ bool includeRyAxis = true,
+ bool includeRzAxis = true,
+ bool includeSlider = true,
+ bool includeDial = true,
+ bool includeRudder = true,
+ bool includeThrottle = true,
+ bool includeAccelerator = true,
+ bool includeBrake = true,
+ bool includeSteering = true);
+
+ void begin(bool initAutoSendState = true);
+ void end();
+
+ // Set Range Functions
+ inline void setXAxisRange(int16_t minimum, int16_t maximum)
+ {
+ _xAxisMinimum = minimum;
+ _xAxisMaximum = maximum;
+ }
+ inline void setYAxisRange(int16_t minimum, int16_t maximum)
+ {
+ _yAxisMinimum = minimum;
+ _yAxisMaximum = maximum;
+ }
+ inline void setZAxisRange(int16_t minimum, int16_t maximum)
+ {
+ _zAxisMinimum = minimum;
+ _zAxisMaximum = maximum;
+ }
+ inline void setRxAxisRange(int16_t minimum, int16_t maximum)
+ {
+ _rxAxisMinimum = minimum;
+ _rxAxisMaximum = maximum;
+ }
+ inline void setRyAxisRange(int16_t minimum, int16_t maximum)
+ {
+ _ryAxisMinimum = minimum;
+ _ryAxisMaximum = maximum;
+ }
+ inline void setRzAxisRange(int16_t minimum, int16_t maximum)
+ {
+ _rzAxisMinimum = minimum;
+ _rzAxisMaximum = maximum;
+ }
+ inline void setSliderRange(int16_t minimum, int16_t maximum)
+ {
+ _sliderMinimum = minimum;
+ _sliderMaximum = maximum;
+ }
+ inline void setDialRange(int16_t minimum, int16_t maximum)
+ {
+ _dialMinimum = minimum;
+ _dialMaximum = maximum;
+ }
+
+ inline void setRudderRange(int16_t minimum, int16_t maximum)
+ {
+ _rudderMinimum = minimum;
+ _rudderMaximum = maximum;
+ }
+ inline void setThrottleRange(int16_t minimum, int16_t maximum)
+ {
+ _throttleMinimum = minimum;
+ _throttleMaximum = maximum;
+ }
+ inline void setAcceleratorRange(int16_t minimum, int16_t maximum)
+ {
+ _acceleratorMinimum = minimum;
+ _acceleratorMaximum = maximum;
+ }
+ inline void setBrakeRange(int16_t minimum, int16_t maximum)
+ {
+ _brakeMinimum = minimum;
+ _brakeMaximum = maximum;
+ }
+ inline void setSteeringRange(int16_t minimum, int16_t maximum)
+ {
+ _steeringMinimum = minimum;
+ _steeringMaximum = maximum;
+ }
+
+ // Set Axis Values
+ void setXAxis(int16_t value);
+ void setYAxis(int16_t value);
+ void setZAxis(int16_t value);
+ void setRxAxis(int16_t value);
+ void setRyAxis(int16_t value);
+ void setRzAxis(int16_t value);
+ void setSlider(int16_t value);
+ void setDial(int16_t value);
+
+ // Set Simuation Values
+ void setRudder(int16_t value);
+ void setThrottle(int16_t value);
+ void setAccelerator(int16_t value);
+ void setBrake(int16_t value);
+ void setSteering(int16_t value);
+
+ void setButton(uint8_t button, uint8_t value);
+ void pressButton(uint8_t button);
+ void releaseButton(uint8_t button);
+
+ void setHatSwitch(int8_t hatSwitch, int16_t value);
+
+ void sendState();
+};
+
+#endif // !defined(_USING_DYNAMIC_HID)
+#endif // JOYSTICKMHX_h
diff --git a/translated_sandbox/sbus-to-usb-joystick/photo_2023-03-30_04-58-32.jpg b/translated_sandbox/sbus-to-usb-joystick/photo_2023-03-30_04-58-32.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..12e0a3e0d9f73543c509386b85d532103a0aed9b
GIT binary patch
literal 91648
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
z
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