Add BasicGamepad example

Author: dmadison

examples/BasicGamepad/BasicGamepad.ino

@@ -0,0 +1,80 @@
+/*
+ *  Project     Teensy XInput Library
+ *  @author     David Madison
+ *  @link       github.com/dmadison/TeensyXInput
+ *  @license    MIT - Copyright (c) 2018 David Madison
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ *  Example:      BasicGamepad
+ *  Description:  Sets up a basic NES-style gamepad using the XInput library,
+ *                and shows how to use the class functions.
+ *
+ */
+
+#include <XInput.h>
+
+// Directional Pad Pins
+const int Pin_DpadUp    = 0;
+const int Pin_DpadDown  = 1;
+const int Pin_DpadLeft  = 2;
+const int Pin_DpadRight = 3;
+
+// Button Pins
+const int Pin_ButtonA = 4;
+const int Pin_ButtonB = 5;
+
+// Note: Buttons should be connected from the sensor pin (above) to ground
+//       when pressed
+
+void setup() {
+	// Set buttons as inputs, using internal pull-up resistors
+	pinMode(Pin_DpadUp, INPUT_PULLUP);
+	pinMode(Pin_DpadDown, INPUT_PULLUP);
+	pinMode(Pin_DpadLeft, INPUT_PULLUP);
+	pinMode(Pin_DpadRight, INPUT_PULLUP);
+
+	pinMode(Pin_ButtonA, INPUT_PULLUP);
+	pinMode(Pin_ButtonB, INPUT_PULLUP);
+}
+
+void loop() {
+	// Read pin values and store in variables
+	// (Note the "!" to invert the state, because LOW = pressed)
+	boolean dpadUp = !digitalRead(Pin_DpadUp);
+	boolean dpadDown = !digitalRead(Pin_DpadDown);
+	boolean dpadLeft = !digitalRead(Pin_DpadLeft);
+	boolean dpadRight = !digitalRead(Pin_DpadRight);
+
+	boolean buttonA = !digitalRead(Pin_ButtonA);
+	boolean buttonB = !digitalRead(Pin_ButtonB);
+
+	// Set XInput DPAD values
+	XInput.setDpad(dpadUp, dpadDown, dpadLeft, dpadRight);
+
+	// Set XInput buttons
+	XInput.setButton(BUTTON_A, buttonA);
+	XInput.setButton(BUTTON_B, buttonB);
+
+	// Send control data to the computer
+	XInput.send();
+
+	// Receive data (player number, rumble motors, etc.)
+	XInput.receive();
+}