Add begin function

Unused for now, although it matches the other HID libraries that use a 'begin' function, and it's quite useful to have an initialization function ready if we ever need it.

Author: dmadison

examples/Blink/Blink.ino

@@ -31,7 +31,7 @@
 #include <XInput.h>
 
 void setup() {
-
+	XInput.begin();
 }
 
 void loop() {

examples/GamepadPins/GamepadPins.ino

@@ -114,10 +114,10 @@ void setup() {
 	pinMode(Pin_DpadLeft, INPUT_PULLUP);
 	pinMode(Pin_DpadRight, INPUT_PULLUP);
 
-	// Set joystick range to the ADC max
-	XInput.setJoystickRange(0, ADC_Max);
-	
+	XInput.setJoystickRange(0, ADC_Max);  // Set joystick range to the ADC
 	XInput.setAutoSend(false);  // Wait for all controls before sending
+
+	XInput.begin();
 }
 
 void loop() {

examples/ReceiveCallback/ReceiveCallback.ino

@@ -44,6 +44,8 @@ void setup() {
 	// Set callback function. Function must have a 'void' return type
 	// and take a single uint8_t as an argument
 	XInput.setReceiveCallback(rumbleCallback);
+
+	XInput.begin();
 }
 
 void loop() {

examples/SimulateAll/SimulateAll.ino

@@ -75,6 +75,8 @@ double angle = 0.0;
 void setup() {
 	pinMode(SafetyPin, INPUT_PULLUP);
 	XInput.setAutoSend(false);  // Wait for all controls before sending
+
+	XInput.begin();
 }
 
 void loop() {

examples/WiiClassicController/WiiClassicController.ino

@@ -43,6 +43,8 @@ void setup() {
 
 	XInput.setAutoSend(false);  // Wait for all controls before sending
 
+	XInput.begin();
+
 	while (!classic.connect()) {
 		delay(1000);  // Controller not connected
 	}

keywords.txt

@@ -21,6 +21,10 @@ XInputLEDPattern	KEYWORD1
 # Methods and Functions (KEYWORD2)
 #######################################
 
+# Setup
+begin	KEYWORD2
+reset	KEYWORD2
+
 # Set Control Data
 press	KEYWORD2
 release	KEYWORD2
@@ -61,7 +65,6 @@ setJoystickRange	KEYWORD2
 setRange	KEYWORD2
 
 # Other
-reset	KEYWORD2
 printDebug	KEYWORD2
 
 #######################################

src/XInput.cpp

@@ -203,6 +203,10 @@ XInputGamepad::XInputGamepad() :
 #endif
 }
 
+void XInputGamepad::begin() {
+	// Empty for now
+}
+
 void XInputGamepad::press(uint8_t button) {
 	setButton(button, true);
 }

src/XInput.h

@@ -78,6 +78,8 @@ class XInputGamepad {
 public:
 	XInputGamepad();
 
+	void begin();
+
 	// Set Control Surfaces
 	void press(uint8_t button);
 	void release(uint8_t button);