セクションの複数ページをまとめています。 印刷またはPDF形式で保存...

もとのページに戻る

2024-04-25 現在

0x90コマンド

TWELITE PALを操作するコマンド
    TWELITE PALに対して送信するコマンドです。
    :0190010004000169[CR][LF]
     ^1^2^3^^^^^^^4^5
    
    番号バイト数意味データ例備考
    11送信先の論理デバイスID01

    送信先のTWELITE PALの論理デバイスIDを指定します。
    0x01から0x64まで指定可能です。

    21コマンド種別90
    31コマンドパラメータ数01コマンドパラメータの数を指定します。例えば、コマンドパラメータを1つだけ指定するなら1に、2つ指定するには2にします。
    4コマンド数x4コマンドパラメータ00040001

    イベントやLEDの色などを指定するためのパラメータを指定します。
    詳細はコマンドパラメータを参照してください。

    51チェックサム69

    1~4の各バイトの和を8ビット幅で計算し2の補数をとります。つまりデータ部の各バイトの総和+チェックサムバイトを8ビット幅で計算すると0になります。
    チェックサムバイトをアスキー文字列2文字で表現します。
    例えば 00A01301FF123456 では 0x00 + 0xA0 + … + 0x56 = 0x4F となり、この二の補数は0xB1 です。(つまり 0x4F + 0xB1 = 0)
    チェックサムをXにすることでチェックサムを省略可能です。

    62フッター[CR][LF][CR] (0x0D) [LF] (0x0A) を指定します。ただし、チェックサムをXで省略する場合はフッターも省略可能です。

    コマンドパラメータ

    4バイトのコマンドパラメータを組み合わせてコマンドを指定します。

    0x00:イベントIDを送信する

    TWELITE PALは受信したイベントIDごとの振る舞いが設定されております。 本パラメータでは送信先のTWELITE PALにイベントIDを送信し、設定した動作を行います。

    番号バイト数内容備考
    11コマンドパラメータID0x00
    21送信先PAL ID

    送信先のPAL IDを指定します。
    0x04:通知パル
    0xFF:すべてのTWELITE PAL

    31未使用領域0x00固定
    41イベントID0~16までのイベントIDを指定します。

    0x01 : LEDの色、点滅パターン、明るさを送信する

    送信先の通知パルにLEDの色、点滅パターン、明るさを送信します。

    番号バイト数内容備考
    11コマンドパラメータID0x01
    21


    0:赤
    1:緑
    2:青
    3:黄色
    4:紫
    5:水色
    6:白
    7:暖かい白

    31点滅パターン

    0:常時点灯
    1~3:点滅パターン(数値が大きくなるほど点滅が早くなる。)

    41明るさ

    0:消灯
    0x01~0x0F:明るさ(数値が大きいほど明るくなる。)

    0x02 : 点灯時間を送信する

    通知パルのLEDの点灯時間を送信します。

    番号バイト数内容備考
    11コマンドパラメータID0x02
    21

    未使用領域

    0xFF固定
    31未使用領域0x00固定
    41点灯時間秒で指定(0は常時点灯)

    0x03:LEDの色をRGBWで指定する

    通知パルのLEDの点灯色をRGBWで送信します。

    番号バイト数内容備考
    11コマンドパラメータID0x03
    21

    未使用領域

    0xFF固定
    32LEDの点灯色

    LSBからRGBWの順番で4ビットずつ指定する。

    数値が大きいほど明るい

    0x04:点滅パラメータを指定する。

    通知パルのLEDの点滅周期と点滅Dutyを送信します。

    番号バイト数内容備考
    11コマンドパラメータID0x04
    21

    未使用領域

    0xFF固定
    31点滅時間の割合

    0x00~0xFFで指定する。

    数値が大きいほど1周期当たりの点灯時間が長くなる。

    1周期の半分だけ点灯させるには0x7Fを指定する。

    41点滅周期

    0x00~0xFFで指定する。

    設定値が1大きくなるごとに点滅の周期が約0.04sずつ増える。

    1周期1秒にするには0x17を指定する。

    コマンド例

    例1:イベントを送信する

    論理デバイスIDが1のNOTICE PALに対してイベント1を送信するコマンド例です。

    :0190010004000169
     ^1^2^3^4^5^6^7^8
    
    番号バイト数意味データ例データ例の内容備考
    11送信先の論理デバイスID01送信先の論理デバイスIDは0x01
    21コマンド種別900x90コマンド90固定
    31コマンド数01コマンドは1個
    41コマンドID00コマンド00
    51送信先PAL ID04通知パルに対して送信する
    61未使用領域00
    71イベントID01イベント10x00~0x10まで
    81チェックサム69

    例2:通知パルのLEDの点灯色を送信する

    論理デバイスIDが1のNOTICE PALに対して明るさ8で白色にゆっくり点滅させるためのコマンドです。

    :019001010601085E
     ^1^2^3^4^5^6^7^8
    
    番号バイト数意味データ例データ例の内容備考
    11送信先の論理デバイスID01送信先の論理デバイスIDは0x01
    21コマンド種別900x90コマンド90固定
    31コマンド数01コマンドは1個
    41コマンドパラメータID01コマンドパラメータID 0x01
    5106
    61点滅パターン01点滅
    71明るさ08明るさ80x00~0x0Fまで
    81チェックサム5E

    例3:通知パルのLEDの点灯色と点灯時間を送信する。

    論理デバイスIDが1のNOTICE PALに対して紫に点灯させ、点灯後1秒で消灯させるコマンドです。

    :0190020104000802FF00015E
     ^1^2^3^4^5^6^7^8^9^a^b^c
    
    番号バイト数意味データ例データ例の内容備考
    11送信先の論理デバイスID01送信先の論理デバイスIDは0x01
    21コマンド種別900x90コマンド90固定
    31コマンド数02コマンドは2個
    41コマンドパラメータID01コマンドパラメータID 0x01
    5104
    61点滅パターン00点灯
    71明るさ08明るさ80x00~0x0Fまで
    81コマンドパラメータID02コマンドパラメータID 0x02
    91未使用領域FF
    a1未使用領域00
    b1点灯時間01点灯後1秒で消える
    c1チェックサム5E

    例4:通知パルに詳細な点灯色送信する。

    論理デバイスIDが1のNOTICE PALに対して紫に点灯させるコマンドです。

    :01900103FF0F0459
     ^1^2^3^4^5^^^6^7
    
    番号バイト数意味データ例データ例の内容備考
    11送信先の論理デバイスID01送信先の論理デバイスIDは0x01
    21コマンド種別900x90コマンド90固定
    31コマンド数01コマンドは2個
    41コマンドパラメータID03コマンドパラメータID 0x03
    51未使用FF
    62LEDの点灯色0F04青:15、赤4の明るさで点灯させる。

    LSBからRGBWの順番で各色4bitずつ(0~15)で指定する。

    数値が大きいほど明るい

    71チェックサム59

    例5:通知パルのLEDの点灯色と点灯時間を送信する。

    論理デバイスIDが1のNOTICE PALに対して紫に点灯させ、点灯後1秒で消灯させるコマンドです。

    :0190020104000802FF00015E
     ^1^2^3^4^5^6^7^8^9^a^b^c
    
    番号バイト数意味データ例データ例の内容備考
    11送信先の論理デバイスID01送信先の論理デバイスIDは0x01
    21コマンド種別900x90コマンド90固定
    31コマンド数02コマンドは2個
    41コマンドパラメータID01コマンドパラメータID 0x01
    5104
    61点滅パターン00点灯
    71明るさ08明るさ80x00~0x0Fまで
    81コマンドパラメータID02コマンドパラメータID 0x02
    91未使用領域FF
    a1未使用領域00
    b1点灯時間01点灯後1秒で消える
    c1チェックサム5E