Smdn.Devices.Mcp2221Aは、GPIO付きUSB2.0→I2C/UARTプロトコルコンバータMCP2221/MCP2221Aを制御するための.NETライブラリです。

MCP2221/MCP2221AではUSB-HIDインターフェイスを介したGPIOやI2C等の制御ができるため、USBポートのある通常のPCでI2Cデバイス等を制御することができます。　このためデバイスの制御にRaspberry PiやArduinoなどのボードを別途用意する必要はなく、またUSB-HIDもWindows, Linuxを含むほとんどのOSでは標準でサポートされているため、ドライバのインストールも必要ありません。

またこのライブラリでは、System.Device.GpioのSystem.Device.GpioのGpioControllerクラスおよびI2cBusクラスから派生したアダプタインターフェイスを提供しているので、Iot.Device.Bindingsが提供する多数のデバイスバインディングを使用することができます。　これにより、通常のPCとUSBケーブル、MCP2221/MCP2221A、C#コードのみのシンプルな構成で、さまざまなデバイスを動作させることができます。

This software is released under the MIT License.　本ライブラリはMITライセンスでリリースされています。

これまでのNuGetパッケージはSmdn.Devices.MCP2221のIDで公開していましたが、version 1.0.0以降はSmdn.Devices.Mcp2221Aに変更されています。　また、リポジトリもsmdn/Smdn.Devices.Mcp2221Aに名称変更しています。

Smdn.Devices.MCP2221を使用していた場合は、version 1.0.0への移行にはパッケージIDの変更が必要になること、またAPIに破壊的変更が行われていることをご理解ください。

なお、Smdn.Devices.MCP2221.GpioAdapterから提供されていた機能は、version 1.0.0以降ではSmdn.Devices.Mcp2221Aに統合されています。

最近のリリース一覧

すべてのリリースと変更内容の詳細はGitHubリポジトリのReleasesよりご覧ください。

リポジトリ

ドキュメントおよびソースコードの参照・入手はGitHub smdn/Smdn.Devices.Mcp2221Aにて行えます。

For more information, including English documents, please visit GitHub smdn/Smdn.Devices.Mcp2221A repository.

インストール

ビルド済みのNuGetパッケージはSmdn.Devices.Mcp2221Aより入手できます。

コマンドラインでインストールする場合は、次のコマンドでパッケージを追加してください。

NuGetパッケージの追加
dotnet add package Smdn.Devices.Mcp2221A

動作例・サンプルコード

本ライブラリを使ってさまざまなデバイスを接続・制御する例です。

MCP2221/MCP2221AとPCの接続方法、必要なパーツと配線例などについてはhttps://github.com/smdn/Smdn.Devices.Mcp2221A/tree/main/doc/wiringを参照してください。

以下の動画のサンプルコードおよび配線例、実行手順等は各リンク先をご覧ください。

GPIOピンに接続されたLEDを点灯する
GPIOピンに接続されたタクトスイッチの状態を読み取る
カスケード接続されたシフトレジスタを操作する
I2C接続の温湿度・気圧センサBME280から値を読み込む
I2C接続のLEDドライバHT16K33を使って14セグメントLEDを制御する
I2C接続のIOエクスパンダMCP23017を制御する
I2C接続のOLEDキャラクタディスプレイSO1602Aを制御する

このほかにも、https://github.com/smdn/Smdn.Devices.Mcp2221A/tree/main/examples/Smdn.Devices.Mcp2221A/にてサンプルコードを参照できます。

不具合・要望・質問等

不具合の報告、ライブラリに対する修正案等がありましたらIssuesまたはPull requestsへお願いします。　言語は英語のほうが望ましいですが、日本語のほうが助かります。