Added TCA9548A device binding

src/devices/Device-Index.md

@@ -113,6 +113,7 @@
 * [STUSB4500 - Autonomous USB-C PD controller for Power Sinks / UFP](StUsb4500/README.md)
 * [System.Device.Model - attributes for device bindings](System.Device.Model/README.md)
 * [TCS3472x Sensors](Tcs3472x/README.md)
+* [TCA954X Multiplexer](Tca954x/README.md)
 * [TLC1543 - 10-bit ADC with 11 input channels](Tlc1543/README.md)
 * [TM1637 - Segment Display](Tm1637/README.md)
 * [TSL256x - Illuminance sensor](Tsl256x/README.md)

src/devices/README.md

@@ -212,6 +212,10 @@ Our vision: the majority of .NET bindings are written completely in .NET languag
 * [NXP/TI PCx857x](Pcx857x/README.md)
 * [Pca95x4 - I2C GPIO Expander](Pca95x4/README.md)
 
+### GPIO Expanders
+
+* [TCA9548A - TCA9548A Low-Voltage 8-Channel I2C Switch with Reset](Tca9548a/README.md)
+
 ### CAN BUS libraries/modules
 
 * [Mcp25xxx device family - CAN bus](Mcp25xxx/README.md)

src/devices/Tca954x/MultiplexerChannel.cs

@@ -0,0 +1,52 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Iot.Device.Tca954x
+{
+    /// <summary>
+    /// Available channels
+    /// </summary>
+    public enum MultiplexerChannel : byte
+    {
+        /// <summary>
+        /// Channel 0 Byte (2^0 = 1)
+        /// </summary>
+        Channel0 = 0x01,
+
+        /// <summary>
+        /// Channel 1 Byte (2^1 = 2)
+        /// </summary>
+        Channel1 = 0x02,
+
+        /// <summary>
+        /// Channel 2 Byte (2^2 = 4)
+        /// </summary>
+        Channel2 = 0x04,
+
+        /// <summary>
+        /// Channel 3 Byte (2^3 = 8)
+        /// </summary>
+        Channel3 = 0x08,
+
+        /// <summary>
+        /// Channel 4 Byte (2^4 = 16)
+        /// </summary>
+        Channel4 = 0x10,
+
+        /// <summary>
+        /// Channel 5 Byte (2^5 = 32)
+        /// </summary>
+        Channel5 = 0x20,
+
+        /// <summary>
+        /// Channel 6 Byte (2^6 = 64)
+        /// </summary>
+        Channel6 = 0x40,
+
+        /// <summary>
+        /// Channel 7 Byte (2^7 = 128)
+        /// </summary>
+        Channel7 = 0x80
+    }
+
+}

src/devices/Tca954x/MuxState.cs

@@ -0,0 +1,22 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Iot.Device.Tca954x
+{
+    /// <summary>
+    /// Mux States
+    /// </summary>
+    public enum MuxState : byte
+    {
+        /// <summary>
+        /// Disables all channels of MuX
+        /// </summary>
+        DisbleAllChannels = 0x00,
+
+        /// <summary>
+        /// Enables all channels of MuX
+        /// </summary>
+        EnableAllChannels = 0xFF,
+    }
+
+}

src/devices/Tca954x/README.md

@@ -0,0 +1,115 @@
+# TCA954X - TCA954X Low-Voltage Multi-Channel I2C Switch with Reset
+
+The TCA954X/PCA954X group of devices is a set of I2C switches. Several types are available, with 2, 4 or 8 channels, and different voltage specifications. The first letter is sometimes also "P".
+
+The TCA9548A device has eight bidirectional translating switches that can be controlled through the I2C bus. The SCL/SDA upstream pair fans out to eight downstream pairs, or channels.
+
+All operations for basic usage has been developed. If needed, RESET operation can also be implemented.
+
+## Documentation
+
+![TCA9548A](./TCA9548A.jpg)
+
+TCA9548A [datasheet](https://www.ti.com/lit/ds/symlink/tca9548a.pdf)
+
+You will find this device as ["Adafruit TCA9548A 1-to-8 I2C Multiplexer Breakout"](https://learn.adafruit.com/adafruit-tca9548a-1-to-8-i2c-multiplexer-breakout)
+
+A list of [different variants](https://www.ti.com/interface/i2c/switches-and-multiplexers/products.html?keyMatch=TCA9548) is available on the Texas Instruments Website.
+
+## Usage
+
+Create a ```Tca9548A``` class and pass the I2C device. The default I2C address is provided in the class.
+
+```csharp
+            Console.WriteLine("Hello TCA9548A!");
+            var bus = I2cBus.Create(1);
+            Tca9548A tca9548a = new Tca9548A(bus.CreateDevice(Tca9548A.DefaultI2cAddress));
+
+            // Get all connected I2C interfaces
+            foreach (var channelBuses in tca9548a)
+            {
+                var deviceAddress = ((Tca9548AChannelBus)channelBuses).PerformBusScan();
+                foreach (var device in deviceAddress)
+                {
+                    if (device == Bno055Sensor.DefaultI2cAddress || device == Bno055Sensor.SecondI2cAddress)
+                    {
+                        Bno055Sensor bno055Sensor = new Bno055Sensor(channelBuses.CreateDevice(device));
+                        Console.WriteLine($"Id: {bno055Sensor.Info.ChipId}, AccId: {bno055Sensor.Info.AcceleratorId}, GyroId: {bno055Sensor.Info.GyroscopeId}, MagId: {bno055Sensor.Info.MagnetometerId}");
+                        Console.WriteLine($"Firmware version: {bno055Sensor.Info.FirmwareVersion}, Bootloader: {bno055Sensor.Info.BootloaderVersion}");
+                        Console.WriteLine($"Temperature source: {bno055Sensor.TemperatureSource}, Operation mode: {bno055Sensor.OperationMode}, Units: {bno055Sensor.Units}");
+                        Console.WriteLine($"Powermode: {bno055Sensor.PowerMode}");
+                        var calibrationStatus = bno055Sensor.GetCalibrationStatus();
+                        Console.WriteLine($"Calibration Status : {calibrationStatus}");
+                        var magneto = bno055Sensor.Magnetometer;
+                        Console.WriteLine($"Magnetometer X: {magneto.X} Y: {magneto.Y} Z: {magneto.Z}");
+                        var gyro = bno055Sensor.Gyroscope;
+                        Console.WriteLine($"Gyroscope X: {gyro.X} Y: {gyro.Y} Z: {gyro.Z}");
+                        var accele = bno055Sensor.Accelerometer;
+                        Console.WriteLine($"Acceleration X: {accele.X} Y: {accele.Y} Z: {accele.Z}");
+                        var orien = bno055Sensor.Orientation;
+                        Console.WriteLine($"Orientation Heading: {orien.X} Roll: {orien.Y} Pitch: {orien.Z}");
+                        var line = bno055Sensor.LinearAcceleration;
+                        Console.WriteLine($"Linear acceleration X: {line.X} Y: {line.Y} Z: {line.Z}");
+                        var gravity = bno055Sensor.Gravity;
+                        Console.WriteLine($"Gravity X: {gravity.X} Y: {gravity.Y} Z: {gravity.Z}");
+                        var qua = bno055Sensor.Quaternion;
+                        Console.WriteLine($"Quaternion X: {qua.X} Y: {qua.Y} Z: {qua.Z} W: {qua.W}");
+                        var temp = bno055Sensor.Temperature.DegreesCelsius;
+                        Console.WriteLine($"Temperature: {temp} °C");
+                    }
+                    else if (device == Bmp180.DefaultI2cAddress)
+                    {
+                        using Bmp180 i2cBmp280 = new(channelBuses.CreateDevice(device));
+                        // set samplings
+                        i2cBmp280.SetSampling(Sampling.Standard);
+                        // read values
+                        Temperature tempValue = i2cBmp280.ReadTemperature();
+                        Console.WriteLine($"Temperature: {tempValue.DegreesCelsius:0.#}\u00B0C");
+                        Pressure preValue = i2cBmp280.ReadPressure();
+                        Console.WriteLine($"Pressure: {preValue.Hectopascals:0.##}hPa");
+
+                        // Note that if you already have the pressure value and the temperature, you could also calculate altitude by
+                        // calling WeatherHelper.CalculateAltitude(preValue, Pressure.MeanSeaLevel, tempValue) which would be more performant.
+                        Length altValue = i2cBmp280.ReadAltitude(WeatherHelper.MeanSeaLevel);
+
+                        Console.WriteLine($"Altitude: {altValue:0.##}m");
+                        Thread.Sleep(1000);
+
+                        // set higher sampling
+                        i2cBmp280.SetSampling(Sampling.UltraLowPower);
+
+                        // read values
+                        tempValue = i2cBmp280.ReadTemperature();
+                        Console.WriteLine($"Temperature: {tempValue.DegreesCelsius:0.#}\u00B0C");
+                        preValue = i2cBmp280.ReadPressure();
+                        Console.WriteLine($"Pressure: {preValue.Hectopascals:0.##}hPa");
+
+                        // Note that if you already have the pressure value and the temperature, you could also calculate altitude by
+                        // calling WeatherHelper.CalculateAltitude(preValue, Pressure.MeanSeaLevel, tempValue) which would be more performant.
+                        altValue = i2cBmp280.ReadAltitude(WeatherHelper.MeanSeaLevel);
+                        Console.WriteLine($"Altitude: {altValue:0.##}m");
+                    }
+
+                    Thread.Sleep(1000);
+                }
+
+            }
+```
+
+### Sample wiring
+
+**Important** to understand:
+If you are getting lower data rate from sensor connected via Multiplexer on Raspberry Pi, you need to adjust the bus speed.
+
+This example uses the I2C bus 1 with GPIO 2 and 3 on raspberry pi and gathers data from to BNO055 sensors and 4 BMP180 sensors over TCA9548A Mux
+
+![Wiring sample](TCA9548A_Connections.png)
+
+## Possible TCA9548A Addresses
+
+![Possible Addresses](PossibleMuxAddress.png)
+
+## TCA9546A - Low Voltage 4-Channel I2C
+
+TCA9546A [datasheet](https://www.ti.com/lit/ds/symlink/tca9546a.pdf)
+You can use the same class to control the 4-Channel Multiplexer also.