Re-adds original changeAddress function and changes the current on in this branch to:

`updateAddress`
* Re-adds original address list
* Adds constants for general min and max i2c addresses
* Updates language around the address related functions

Author: edspark

examples/Example1_BasicReadings/Example1_BasicReadings.ino

@@ -33,11 +33,10 @@ void setup()
   Wire.begin();
 
   // Attempt to begin the sensor
-  if (myUltrasonic.begin(deviceAddress) == false)
+  while (myUltrasonic.begin(deviceAddress) == false)
   {
     Serial.println("Ultrasonic sensor not connected, check your wiring and I2C address!");
-    while(1)       
-      ;
+    delay(2000);
   }
 
   Serial.println("Ultrasonic sensor connected!");

examples/Example2_BasicDistanceTrigger/Example2_BasicDistanceTrigger.ino

@@ -38,11 +38,10 @@ void setup() {
   pinMode(echoPin, INPUT);
 
   // Attempt to begin the sensor
-  if (myUltrasonic.begin(deviceAddress) == false)
+  while (myUltrasonic.begin(deviceAddress) == false)
   {
     Serial.println("Ultrasonic sensor not connected, check your wiring and I2C address!");
-    while(1)       
-      ;
+    delay(2000);
   }
 
   Serial.println("Ultrasonic sensor connected!");

examples/Example3_ChangeAddress/Example3_ChangeAddress.ino

@@ -42,9 +42,10 @@ void setup()
     ; 
 
   // Attempt to begin the sensor
-  if (myUltrasonic.begin(kQwiicUltrasonicDefaultAddress) == false )
+  while (myUltrasonic.begin(deviceAddress) == false)
   {
     Serial.println("Ultrasonic sensor not connected, check your wiring and I2C address!");
+    delay(2000);
   }
 
   Serial.println("Ready to change address.");

src/sfeQwiicUltrasonic.cpp

@@ -10,6 +10,8 @@
  */
 
 #include "sfeQwiicUltrasonic.h"
+#include "sfeTk/sfeTkError.h"
+#include <cstdint>
 
 sfeTkError_t sfeQwiicUltrasonic::begin(sfeTkII2C *theBus)
 {
@@ -42,12 +44,12 @@ sfeTkError_t sfeQwiicUltrasonic::isConnected()
 
 sfeTkError_t sfeQwiicUltrasonic::getDistance(uint16_t &distance)
 {
-    size_t bytesRead = 0;
-    uint8_t rawData[2] = {0, 0};
-    sfeTkError_t err;
+    size_t bytesRead;
+    size_t numBytes = 2;
+    uint8_t rawData[2] = {};
 
-    _theBus->writeByte(kUltrasonicDistanceReadCommand);
-    err = _theBus->readRegisterRegion(_theBus->address(), rawData, 2, bytesRead);
+    // Get the distance
+    sfeTkError_t err = _theBus->readBlock(kUltrasonicDistanceReadCommand, rawData, numBytes, bytesRead);
 
     // Check whether the read was successful
     if (err != kSTkErrOk)
@@ -60,39 +62,40 @@ sfeTkError_t sfeQwiicUltrasonic::getDistance(uint16_t &distance)
     return kSTkErrOk;
 }
 
-sfeTkError_t sfeQwiicUltrasonic::getTriggeredDistance(uint16_t &distance)
+sfeTkError_t sfeQwiicUltrasonic::changeAddress(const uint8_t &address)
 {
-    size_t bytesRead = 0;
-    uint8_t rawData[2] = {0, 0};
+    // Check whether the address is valid
+    if (address < kQwiicUltrasonicMinAddress || address > kQwiicUltrasonicMaxAddress)
+        return kSTkErrFail;
 
-    // Attempt to read the distance
-    sfeTkError_t err = _theBus->readRegisterRegion(_theBus->address(), rawData, 2, bytesRead);
+    // Write the new address to the device. The first bit must be set to 1
+    sfeTkError_t err = _theBus->writeByte(address | 0x80);
 
-    // Check whether the read was successful
+    // Check whether the write was successful
     if (err != kSTkErrOk)
         return err;
 
-    // Store raw data
-    distance = (rawData[0] << 8) | rawData[1];
+    // Update the address in the bus
+    _theBus->setAddress(address);
 
     // Done!
     return kSTkErrOk;
 }
 
-sfeTkError_t sfeQwiicUltrasonic::changeAddress(uint8_t &address)
+sfeTkError_t sfeQwiicUltrasonic::updateAddress(uint8_t &address)
 {
     // Check whether the address is valid
     sfeTkError_t err;
     size_t numBytes = 2;
     // We want to shift the address left before we send it. 
+    
     address <<= 1;
     const uint8_t toWrite[2] = {kUltrasonicAddressChangeCommand, address};
 
-    if (address < kQwiicUltrasonicMinAddress || address > kQwiicUltrasonicMaxAddress)
+    if (address < kQwiicI2CAddressMin|| address > kQwiicI2CAddressMax)
         return kSTkErrFail;
 
-    // Write the new address to the device. The first bit must be set to 1
-    // err = _theBus->writeRegisterByte(kUltrasonicAddressChangeCommand, (address<< 1));
+    // Write the new address to the device. 
     err = _theBus->writeBlock(toWrite, numBytes);
 
     // Check whether the write was successful

src/sfeQwiicUltrasonic.h

@@ -16,8 +16,17 @@
 
 // Available I2C addresses of the Qwiic Ultrasonic
 const uint8_t kQwiicUltrasonicDefaultAddress = 0x2F;
-const uint8_t kQwiicUltrasonicMinAddress = 0x08;
-const uint8_t kQwiicUltrasonicMaxAddress = 0x7F;
+// These addresses are the min and max (respectively) of valid I2C addresses that can
+// be used for the newest revision of the Qwiic Ultrasonic sensor.
+const uint8_t kQwiicI2CAddressMin = 0x08;
+const uint8_t kQwiicI2CAddressMax = 0x7F;
+// Available I2C addresses of the Qwiic Ultrasonic
+const uint8_t kQwiicUltrasonicDefaultAddress = 0x2F;
+const uint8_t kQwiicUltrasonicAddresses[] = {0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27,
+                                             0x28, 0x29, 0x2A, 0x2B, 0x2C, 0x2D, 0x2E, 0x2F};
+const uint8_t kQwiicUltrasonicNumAddresses = sizeof(kQwiicUltrasonicAddresses) / sizeof(uint8_t);
+const uint8_t kQwiicUltrasonicMinAddress = kQwiicUltrasonicAddresses[0];
+const uint8_t kQwiicUltrasonicMaxAddress = kQwiicUltrasonicAddresses[15];;
 // I2C commands
 const uint8_t kUltrasonicDistanceReadCommand = 0x01;
 const uint8_t kUltrasonicAddressChangeCommand = 0x04;
@@ -44,15 +53,15 @@ class sfeQwiicUltrasonic
     /// @return 0 for succuss, negative for errors, positive for warnings
     sfeTkError_t getDistance(uint16_t &distance);
 
-    /// @brief Triggers a new measurement and reads the previous one
-    /// @param distance Distance in mm
+    /// @brief Changes the I2C address of older Qwiic Ultrasonic sensors.
+    /// @param address New address, must be in the range 0x20 to 0x2F
     /// @return 0 for succuss, negative for errors, positive for warnings
-    sfeTkError_t getTriggeredDistance(uint16_t &distance);
+    sfeTkError_t changeAddress(const uint8_t &address);
 
-    /// @brief Changes the I2C address of the Qwiic Ultrasonic sensor
+    /// @brief Changes the I2C address of the latest revision of the Qwiic Ultrasonic sensor.
     /// @param address New address, must be in the range 0x20 to 0x2F
     /// @return 0 for succuss, negative for errors, positive for warnings
-    sfeTkError_t changeAddress(uint8_t &address);
+    sfeTkError_t updateAddress(uint8_t &address);
 
     /// @brief Gets the current I2C address being used by the library for the Qwiic Ultrasonic sensor
     /// @return The current I2C address, 7-bit unshifted