Added ability to change I2C address

Co-Authored-By: Fischer Moseley <[email protected]>

Author: Fischer Moseley

examples/Example6_ChangeI2CAddress/Example6_ChangeI2CAddress.ino

@@ -0,0 +1,75 @@
+/******************************************************************************
+Checks whether the button is pressed, and then prints its status!
+
+Fischer Moseley @ SparkFun Electronics
+Original Creation Date: July 30, 2019
+
+This code is beerware; if you see me (or any other SparkFun employee) at the
+local, and you've found our code helpful, please buy us a round!
+
+Hardware Connections:
+Attach the Qwiic Shield to your Arduino/Photon/ESP32 or other
+Plug the button into the shield
+Print it to the serial monitor at 115200 baud.
+
+Distributed as-is; no warranty is given.
+******************************************************************************/
+
+#include <SparkFun_Qwiic_Button.h>
+QwiicButton button;
+
+void setup(){
+    Serial.begin(115200);
+    Wire.begin(); //Join I2C bus
+    Wire.setClock(400000);
+    button.begin(0x46);
+
+    //check if button will acknowledge over I2C
+    if(button.isConnected()){
+        Serial.println("Device will acknowledge!");
+    }
+
+    else {
+        Serial.println("Device did not acknowledge! Freezing.");
+        while(1);
+    }
+    Serial.println();
+    Serial.println("Enter a new I2C address for the Qwiic Button to use!");
+    Serial.println("Don't use the 0x prefix. For instance, if you wanted to");
+    Serial.println("change the address to 0x5B, you would enter 5B and press enter.");
+    Serial.println();
+    Serial.println("One more thing! Make sure your line ending is set to 'Both NL & CR'");
+    Serial.println("in the Serial Monitor.");
+    Serial.println();
+}
+
+void loop(){
+    //check if button is pressed, and tell us if it is!
+    if(Serial.available()) {
+        uint8_t newAddress = 0;
+        String stringBuffer = Serial.readStringUntil('\r');
+        uint8_t charBuffer[10];
+        stringBuffer.toCharArray(charBuffer, 10);
+        uint8_t success = sscanf(charBuffer, "%x", &newAddress);
+
+        if(success == 1) {
+            if(newAddress > 0x08 && newAddress < 0x77) {
+                Serial.println("Character recieved, and device address is valid!");
+                Serial.println("Attempting to set device address");
+                Serial.println(newAddress, HEX);
+                Serial.println(button.setI2Caddress(newAddress));
+                delay(100);
+                Serial.println(button.isConnected());
+            }
+
+            else {
+                Serial.println("Address out of range! Try an adress between 0x08 and 0x77");
+            }
+        }
+
+        else {
+            Serial.print("Invalid Text! Try again.");
+        }
+        
+    }
+}

src/SparkFun_Qwiic_Button.cpp

@@ -56,7 +56,7 @@ bool QwiicButton::checkDeviceID() {
 uint8_t QwiicButton::getDeviceType() {
     if(isConnected()){ //only try to get the device ID if the device will acknowledge
         uint8_t id = deviceID();
-        if(id == DEV_ID_BTN) return 1; //
+        if(id == DEV_ID_BTN) return 1;
         if(id == DEV_ID_SW) return 2;
     }
     return 0;
@@ -68,6 +68,21 @@ uint16_t QwiicButton::getFirmwareVersion() {
     return version;
 }
 
+bool QwiicButton::setI2Caddress(uint8_t address) {
+    if(address < 0x08 || address > 0x77) return 1; //error immediately if the address is out of legal range
+
+    bool success = writeSingleRegister(I2C_ADDRESS, address);
+
+    if (success) {
+        _deviceAddress = address;
+        return 0; //return 0 if the write was successful, and after the struct's _deviceAddress variable was changed
+    }
+
+    else {
+        return 1; //otherwise just return error
+    }
+}
+
 
 /*------------------------------ Button Status ---------------------- */
 bool QwiicButton::isPressed() {

src/SparkFun_Qwiic_Button.h

@@ -26,7 +26,7 @@ Distributed as-is; no warranty is given.
 #include <Arduino.h>
 #include "registers.h"
 
-#define DEV_ADDR 0x5F //default device address of the QwiicButton
+#define DEV_ADDR 0x60 //default device address of the QwiicButton
 #define DEV_ID_BTN 0x5D //device ID of the Qwiic Button
 #define DEV_ID_SW 0x5E //device ID of the Qwiic Switch
 
@@ -43,6 +43,7 @@ class QwiicButton {
     bool checkDeviceID();                                             //Returns true if the device ID matches that of either the button or the switch
     uint8_t getDeviceType();                                          //Returns 1 if a button is attached, 2 if a switch is attached. Returns 0 if there is no device attached.
     uint16_t getFirmwareVersion();                                    //Returns the firmware version of the attached device as a 16-bit integer. The leftmost (high) byte is the major revision number, and the rightmost (low) byte is the minor revision number.
+    bool setI2Caddress(uint8_t address);                               //Configures the attached device to attach to the I2C bus using the specified address
 
     //Button status/config
     bool isPressed();                                                 //Returns 1 if the button/switch is pressed, and 0 otherwise