Skip to content

Instantly share code, notes, and snippets.

@GOROman

GOROman/DP100_Protocol.md

Last active December 2, 2024 06:20
Show Gist options
  • Save GOROman/9c5f9bc4ea1d528feafe2ccd2ce3431e to your computer and use it in GitHub Desktop.
Save GOROman/9c5f9bc4ea1d528feafe2ccd2ce3431e to your computer and use it in GitHub Desktop.
Download ZIP
Alientek DP100 Protocol
Raw
DP100_Protocol.md

オリジナル: https://github.com/lessu/open_dp100/blob/master/DP100_Protocol.md

DP100 安定化電源 USB プロトコル解析

デバイス: Alientek DP100

私は主にmacOSを使用し、次にlinux、Windowsを使用することはあまりありません。

Alientekは、唯一Windows用の.net Dllを提供するため、二次開発には非常に不便です。

そこで私は、基礎となる通信プロトコルがどのように実装されているかを確認するためにリバースエンジニアリングを行い、他の言語を使って移植を行いました。

プロトコル解析

USB列挙情報

HIDプロトコルが使われている。 HIDではないが、HIDクラスである。

ID 2e3c:af01
設定:0、インターフェース:0、設定:0
エンドポイント：アドレス：81、方向：IN、転送タイプ：割り込み
エンドポイント：アドレス：01、方向：OUT、転送タイプ：割り込み

USB 転送項目

項目 値 備考
USBクラス 0x03 HID データを転送せずに、直接、裸で転送する。
HIDの使用法 なし バージョン1.1は64バイトのアプリケーションを送信します。
USBパケットデータ長 固定64 パッケージの中身が64に満たない場合は0で補うか、気にしないか。

トランスポート・プロトコル

項目 値
転送サイズ 終了 小さい 終了

パッケージレイアウト

バイト 0 1 2 3 ... len+4 len+5 ...
意味 転送方向 OpCode リザーブ Len Lenのデータ crc16 crc16 。
description fa/fb operation 00 LOW HIGH

例

fb300000310f00000000000000000000000000000000000000000000000000000000000...

送信方向

  • ホストがデバイスに渡すときは 0xfb
  • デバイスがホストに渡すときは 0xfa

OpCode

OpCode 説明
0x10 DEVICE_INFO
0x12 START_TRANS
0x13 DATA_TRANS
0x14 END_TRANS
0x15 DEV_UPGRADE
0x30 BASIC_INFO
0×35 BASIC_SET
0×40 SYSTEM_INFO
0x45 SYSTEM_SET
0x50 SCAN_OUT
0x55 SERIAL_OUT
0x80 DISCONNECT

各OpCodeの使用方法については、以下のセクションで説明する。

Len

文字通り追従するデータの長さを意味するが、OpCode によって異なる。

データ

実際のデータの内容で、OpCode によって意味が異なるので、以下に展開する。

CRC

E2E 認証方式 CRC-16/MODBUS、Payload は Data の先頭バイトから末尾バイトまで。

リトルエンディアンである。すなわち、0x1234 の場合、送信は 0x34 0x12 に変更する。

// CRC-16/MODBUS 計算関数
uint16_t calculate_crc16(const uint8_t *data, size_t length) {
    uint16_t crc = 0xFFFF; // 初期値
    for (size_t i = 0; i < length; i++) {
        crc ^= data[i];
        for (uint8_t j = 0; j < 8; j++) {
            if (crc & 1)
                crc = (crc >> 1) ^ 0xA001; // 多項式: 0xA001
            else
                crc >>= 1;
        }
    }
    return crc; // 計算結果（リトルエンディアン形式）
}

タイミング

sequenceDiagram
	participant Host
  participant Device
  Host->>+Device:USB列挙等
  Device->>-Host:-
  
  Host->>+Device:Interrupt Out:fb300000310f..
  Device->>-Host:Interrupt In: fa3000xxxxxxxx..
Loading

オペコード

以下の情報はdllダンプからのものです。 ！！！！ 未テスト、未検証です！！ **内容をご確認の上、ご利用ください。 ** 故障探求の目で内容を確認してください。

0x10 DEVICE_INFO

ホストは Len = 0 を送信

デバイスは以下のデータを送信する。

NAME TYPE
dev type uint8[16]
hdw_ver uint16 origin:11 means 1.1
app_ver uint16 origin:11 means 1.2
boot_ver uint16
run_area uint16
dev_sn uint8[12]
year uint16 壊れてる？
moon uint8 壊れてる？
day uint8 壊れてる？

0x12 START_TRANS

未テスト、おそらく

ホストはLen = 0を送信

デバイスは Len = 0 を送信

0x13 DATA_TRANS

不明

不明

0x14 END_TRANS

未テスト、おそらく

ホストはLen = 0を送信

デバイスは Len = 0 を送信

0x15 DEV_UPGRADE

不明、単純なデコンパイルでは関連情報が見つからなかった。

0x30 BASIC_INFO

ホストが Len = 0 を送信

デバイスが送信

NAME TYPE 説明
vin uint16 mV
vout uint16 mV
iout uint16 mA
vo_max uint16 mV
temp1 uint16
temp2 int16
dc 5V uint16 mV
out mode uint8 この列挙は試していません
work st uint8 この列挙は試していません

0×35 BASIC_SET

これは基本情報の設定ではない。 BASIC_SETのリストがあり、10セットがデバイスに格納されている。

クエリ

ホスト送信 len = 1

NAME TYPE
index uint8

でBASIC_SETを問い合わせると、デバイスが応答する。

indexの上位4ビットはフラグで、以下のように定義される。

  • index=0x80: アクティブなものを問い合わせる

設定

ホスト送信 len = 10

BASIC_SETは以下のような構造になっている。

NAME TYPE 説明
index uint8
state uint8 0:off 1:on
vo_set uint16
io_set uint16
ovp_set uint16
ocp_set int16
  • index=20: セットを変更する
  • index=80: アクティブに設定
  • index=a0: セットを変更,アクティブに設定

ホストがlen = 16を送信し、ペイロードがBASIC_SETの場合、ホストはBASIC_SETを設定するよう要求していることになる。

デバイスは次のように応答する。

NAME TYPE 説明
result uint8 1 = ok

である。

0×40 SYSTEM_INFO

ホストはLen = 0を送信

デバイスが送信

NAME TYPE 説明
blk_lev int8 バックライトのレベル
opp uint16 オーバーパワー
opt uint16 温度過昇
vol_lev int8 ビープ音の音量

0x45 SYSTEM_SET

不明

0x50 SCAN_OUT

ホストは以下を送信する。

NAME TYPE 説明
on_off ?1 byte?
on_time uint16
out_val uint16
scan_mode ?1 byte? I / V
start uint16
end uint16
step uint16

デバイスは未テストを送信

0x55 SERIAL_OUT

この関数はよく理解されていないので、誰かが後でUIに対して言うだろう。

ホスト送信

NAME TYPE 説明
on_off uint8
on_time uint16
ser_start uint8
ser_end uint8
ser_vi uint16
ser_vo uint16
cycle_times uint8

デバイスは未テストを送信

0x80 DISCONNECT

テストされていない。

ホストはLen = 0を送信

デバイスは Len = 0 を送信

@GOROman
Copy link
Author

GOROman commented Nov 20, 2024

制御するサンプル作った
https://gist.github.com/GOROman/6881b1ef30364a584c37eb66fd605395

@GOROman
Copy link
Author

GOROman commented Nov 20, 2024

オン・オフするには　BASIC_SET　を使えばOK。

@GOROman
Copy link
Author

GOROman commented Nov 20, 2024

制御の例
https://x.com/GOROman/status/1859259952273203328

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment