Allow bypassing address validation in HT16K33 code to address Issue #1834

docs/led-digits-clock-HT16K33.md

@@ -60,6 +60,39 @@ function time(showColon) {
 
 
 
+## Additional Options
+### Specifying Addresses
+You can specify the addresses to use for the controller:
+```
+  const digits = new Led.Digits({
+    controller: "HT16K33",
+    address: 0x70,
+  });
+```
+
+### Bypassing Address Validation
+Led.Digits will ensure that you do not use the same address twice,  
+but if you use multiple Arduino boards you want to reuse the same address.  
+You can use the `skipAddressValidation` option to bypass this check:
+```
+  const digitsA = new Led.Digits({
+    controller: "HT16K33",
+    board: boards.byId("A"),
+    address: 0x70,
+    skipAddressValidation: true,
+  });
+  const digitsB = new Led.Digits({
+    controller: "HT16K33",
+    board: boards.byId("B"),
+    address: 0x70,
+    skipAddressValidation: true,
+  });
+```
+
+
+
+
+
 
 ## Additional Notes
 Learn More:

lib/led/ledcontrol.js

@@ -47,6 +47,10 @@ const priv = new Map();
  * @param {Boolean} [options.colon]      Whether the device has a built in colon.
  * @param {Number}  [options.devices]    The number of connected LED devices.
  * @param {Array}   [options.addresses]  I2C addresses.
+ * @param {Boolean} [options.skipAddressValidation] Bypass address checking and incrementing.
+ *                                                  Use this when using multiple HT16K33 but at the same address
+ *                                                  on multiple Arduino or other type boards.
+ *                                                  You should also include the address or addresses when using this.
  * @param {*}       options.pins         The digital pin numbers that connect to
  *                                    data, clock, and cs connections on the controller device.
  *                                    Only for use with the default controller.
@@ -454,12 +458,14 @@ const Controllers = {
           this.addresses = available.slice(0, state.devices);
         }
 
-        this.addresses.forEach(address => {
-          if (!addresses.has(address)) {
-            throw new Error(`Invalid HT16K33 controller address: ${address}`);
-          }
-          addresses.delete(address);
-        });
+        if (!options.skipAddressValidation) {
+          this.addresses.forEach(address => {
+            if (!addresses.has(address)) {
+              throw new Error(`Invalid HT16K33 controller address: ${address}`);
+            }
+            addresses.delete(address);
+          });
+        }
 
         this.rotation = options.rotation || 1;
         // set a default rotation that works with AdaFruit 16x8 matrix if using 16 columns