V-USB ホスト側アプリとAVR-HID/IO

(C) Objective Development Software

USB HIDライブラリ

ソース(UsbHidLib.cs)は次章「AVR-HID/IO」でダウンロードできます。 使用例として、前記事のテストプログラムhiddevc.exeのProgram.csを【ここに示します】。※下図は概略。 hiddevc.exe実行画面 プロジェクトの準備 1. プロジェクトに「UsbHidLib.cs」を追加する。 2. ソースに「using UsbHid;」を記述する。 ソース記述の手順 1. HidDeviceMgrオブジェクトを生成する。 2. HidDeviceMgr.GetDeviceList()でデバイス一覧を取得する。 3. HidDeviceMgr.TargetDevice()で目的のデバイスを決定する。HidDeviceオブジェクトが返る。 4. 以降、HidDeviceオブジェクトを通してデバイスを操作する。 同種のデバイスを複数台接続した場合、手順2の一覧に全て含まれます。それぞれのシリアル番号やデバイス名を見て目的のデバイスを選びます。または、それら一つ一つを手順3で決定し（それぞれのHidDeviceオブジェクトを取得し）、個別に操作することもできます。 class HidDevice　HIDデバイスを個別に操作する コンストラクタ public HidDevice(HidDeviceInfo devInfo) ユーザーアプリ内からコンストラクタを呼び出すことはしない。 インスタンスはHidDeviceMgr.TargetDevice()で取得すること。 publicメソッド コントロール転送でFeatureReportを取得する byte[] GetFeatureReport(int dataLength) dataLength: 取得するデータの長さ。レポートIDを含まない長さ。 byte[] GetFeatureReport(byte reportID, int reportLength, bool cutReportIdByte) reportID: レポートID。 reportLength: 取得するレポートの長さ。レポートIDの分1byteを含めた長さであること。 cutReportIdByte: 取得したbyte配列からレポートIDの要素をカットするかどうか。 コントロール転送でFeatureReportをセットする bool SetFeatureReport(byte[] dataBytes) dataBytes: 送信するデータ。レポートIDを含まないデータであること。 bool SetFeatureReport(byte reportID, byte[] dataBytes, bool addReportIdByte) reportID: レポートID。 dataBytes: 送信するデータ。下記備考参照。 addReportIdByte: dataBytesの先頭にレポートIDを加えるかどうか。 備考 addReportIdByteをtrueとするとき、dataBytesはレポートIDを含まないbyte配列であること。 addReportIdByteをfalseとするとき、dataBytesはレポートIDを含んだbyte配列であること。 コントロール転送でInputReportを取得する byte[] GetInputReport(int dataLength) dataLength: 取得するデータの長さ。レポートIDを含まない長さ。 byte[] GetInputReport(byte reportID, int reportLength, bool cutReportIdByte) reportID: レポートID。 reportLength: 取得するレポートの長さ。レポートIDの分1byteを含めた長さであること。 cutReportIdByte: 取得したbyte配列からレポートIDの要素をカットするかどうか。 コントロール転送でOutputReportをセットする bool SetOutputReport(byte[] dataBytes) dataBytes: 送信するデータ。レポートIDを含まないデータであること。 bool SetOutputReport(byte reportID, byte[] dataBytes, bool addReportIdByte) reportID: レポートID。 dataBytes: 送信するデータ。下記備考参照。 addReportIdByte: dataBytesの先頭にレポートIDを加えるかどうか。 備考 addReportIdByteをtrueとするとき、dataBytesはレポートIDを含まないbyte配列であること。 addReportIdByteをfalseとするとき、dataBytesはレポートIDを含んだbyte配列であること。 インタラプト転送(IN)の受信スレッドを開始する bool InterruptInStart(InterruptInCB callbackMethod) callbackMethod: ユーザーアプリ内で用意したstaticなメソッド。 インタラプト転送(IN)の受信スレッドを停止／破棄する void InterruptInStop() InterruptInStart()を使用した場合、ユーザーアプリ終了時までに呼び出す。

AVR-HID/IO

ダウンロード hidio_v110.zip V-USB HIDライブラリ (UsbHidLib.cs) AVR-HID/IOコントローラ (UsbHidIOCtrl.cs) ファームウェアと サンプルプログラムを含む。 2012/08 更新(v1.10) 動作確認環境： WindowsXP(32bit)/SP3, Windows7(64bit)/SP1 前回の記事で目標としていた、AVR-CDC/IOと同様のデバイスAVR-HID/IOを作りました。 ATmega48シリーズ版とATtiny2313版があります。 回路はどちらもV-USBの基本回路の通りです。フラッシュ容量の都合によりATtiny2313版は機能を削減しています。 ソフトの組み方・ライブラリの使い方は、上記ZIPに同梱のサンプルプログラムを見てください。※下図は概略。 ATmega48シリーズ版(48/88/168/328) テスト中の様子。 PORTCを読み取る場面。 サポートしている操作 class HidIOCtrl レジスタ操作 EEPROM操作 int Get(SFR register) byte EEPRomReadByte(int adrs) bool Set(SFR register, int byteValue) bool EEPRomWriteByte(int adrs, int byteValue) bool AndSet(SFR register, int byteValue) int EEPRomReadWord(int adrs) bool OrSet(SFR register, int byteValue) bool EEPRomWriteWord(int adrs, int nValue) bool XorSet(SFR register, int byteValue) 割り込みに対応。コールバック関数にベクタ番号が上がってくる。※番号と内容の対応はデータシートを参照。 ただし、1番（リセット割り込み），2番（INT0割り込み），3番（INT1割り込み）は無い。 ATtiny2313版 サポートしている操作 class HidIOCtrl レジスタ操作 EEPROM操作 int Get(SFR register) byte EEPRomReadByte(int adrs) bool Set(SFR register, int byteValue) bool EEPRomWriteByte(int adrs, int byteValue) bool AndSet(SFR register, int byteValue) int EEPRomReadWord(int adrs) なし bool OrSet(SFR register, int byteValue) bool EEPRomWriteWord(int adrs, int nValue) なし bool XorSet(SFR register, int byteValue) 割り込みには対応していない。