> For the complete documentation index, see [llms.txt](https://wings.twelite.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wings.twelite.info/how-to-use/parent-mode/transemit-command/0x90-command.md).

# 0x90コマンド

TWELITE PALに対して送信するコマンドです。

```
:0190010004000169[CR][LF]
 ^1^2^3^^^^^^^4^5
```

| 番号 | バイト数    | 意味           | データ例       | 備考                                                                                                                                                                                                                                                   |
| -- | ------- | ------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1  | 1       | 送信先の論理デバイスID | 01         | <p>送信先のTWELITE PALの論理デバイスIDを指定します。<br>0x01から0x64まで指定可能です。</p>                                                                                                                                                                                        |
| 2  | 1       | コマンド種別       | 90         |                                                                                                                                                                                                                                                      |
| 3  | 1       | コマンドパラメータ数   | 01         | コマンドパラメータの数を指定します。例えば、コマンドパラメータを1つだけ指定するなら1に、2つ指定するには2にします。                                                                                                                                                                                          |
| 4  | コマンド数x4 | コマンドパラメータ    | 00040001   | <p>イベントやLEDの色などを指定するためのパラメータを指定します。<br>詳細はコマンドパラメータを参照してください。</p>                                                                                                                                                                                    |
| 5  | 1       | チェックサム       | 69         | <p>1～4の各バイトの和を８ビット幅で計算し２の補数をとります。つまりデータ部の各バイトの総和＋チェックサムバイトを８ビット幅で計算すると０になります。<br>チェックサムバイトをアスキー文字列２文字で表現します。<br>例えば 00A01301FF123456 では 0x00 + 0xA0 + ... + 0x56 = 0x4F となり、この二の補数は0xB1 です。(つまり 0x4F + 0xB1 = 0)<br>チェックサムをXにすることでチェックサムを省略可能です。</p> |
| 6  | 2       | フッター         | \[CR]\[LF] | \[CR] (0x0D) \[LF] (0x0A) を指定します。ただし、チェックサムをXで省略する場合はフッターも省略可能です。                                                                                                                                                                                    |

### コマンドパラメータ

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

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

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

{% hint style="info" %}
イベント毎の振る舞いを変更するにはTWELITE PALの設定を変更してください。
{% endhint %}

| 番号 | バイト数 | 内容          | 備考                                                            |
| -- | ---- | ----------- | ------------------------------------------------------------- |
| 1  | 1    | コマンドパラメータID | 0x00                                                          |
| 2  | 1    | 送信先PAL ID   | <p>送信先のPAL IDを指定します。<br>0x04:通知パル<br>0xFF:すべてのTWELITE PAL</p> |
| 3  | 1    | 未使用領域       | 0x00固定                                                        |
| 4  | 1    | イベントID      | 0～16までのイベントIDを指定します。                                          |

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

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

| 番号 | バイト数 | 内容           | 備考                                                                   |
| -- | ---- | ------------ | -------------------------------------------------------------------- |
| 1  | 1    | コマンドパラメータID  | 0x01                                                                 |
| 2  | 1    | <p>色<br></p> | <p>0:赤<br>1:緑<br>2:青<br>3:黄色<br>4:紫<br>5:水色<br>6:白<br>7:暖かい白<br></p> |
| 3  | 1    | 点滅パターン       | <p>0:常時点灯<br>1～3:点滅パターン(数値が大きくなるほど点滅が早くなる。)</p>                      |
| 4  | 1    | 明るさ          | <p>0:消灯<br>0x01～0x0F:明るさ(数値が大きいほど明るくなる。)</p>                         |

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

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

{% hint style="warning" %}
本コマンドパラメータは、LEDの色、点滅パターン、明るさのパラメータが含まれないので、コマンドパラメータ0x01または0x03と組み合わせて使用します。
{% endhint %}

{% hint style="warning" %}
本コマンドパラメータを使用する場合は、送信間隔を必ず点灯時間より大きく設定してご使用ください。
{% endhint %}

| 番号 | バイト数 | 内容               | 備考           |
| -- | ---- | ---------------- | ------------ |
| 1  | 1    | コマンドパラメータID      | 0x02         |
| 2  | 1    | <p>未使用領域<br></p> | 0xFF固定       |
| 3  | 1    | 未使用領域            | 0x00固定       |
| 4  | 1    | 点灯時間             | 秒で指定(0は常時点灯) |

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

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

{% hint style="warning" %}
コマンドパラメータ0x00および0x01とは同時に使用できません。
{% endhint %}

| 番号 | バイト数 | 内容               | 備考                                                |
| -- | ---- | ---------------- | ------------------------------------------------- |
| 1  | 1    | コマンドパラメータID      | 0x03                                              |
| 2  | 1    | <p>未使用領域<br></p> | 0xFF固定                                            |
| 3  | 2    | LEDの点灯色          | <p>LSBからRGBWの順番で4ビットずつ指定する。</p><p>数値が大きいほど明るい</p> |

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

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

{% hint style="warning" %}
本コマンドパラメータは、LEDの色のパラメータが含まれないので、コマンドパラメータ0x03と組み合わせて使用します。
{% endhint %}

{% hint style="warning" %}
コマンドパラメータ0x00および0x01とは同時に使用できません。
{% endhint %}

| 番号 | バイト数 | 内容               | 備考                                                                                      |
| -- | ---- | ---------------- | --------------------------------------------------------------------------------------- |
| 1  | 1    | コマンドパラメータID      | 0x04                                                                                    |
| 2  | 1    | <p>未使用領域<br></p> | 0xFF固定                                                                                  |
| 3  | 1    | 点滅時間の割合          | <p>0x00～0xFFで指定する。</p><p>数値が大きいほど1周期当たりの点灯時間が長くなる。</p><p>1周期の半分だけ点灯させるには0x7Fを指定する。</p>  |
| 4  | 1    | 点滅周期             | <p>0x00～0xFFで指定する。</p><p>設定値が1大きくなるごとに点滅の周期が約0.04sずつ増える。</p><p>1周期1秒にするには0x17を指定する。</p> |

### コマンド例

#### 例1：イベントを送信する

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

```
:0190010004000169
 ^1^2^3^4^5^6^7^8
```

| 番号 | バイト数 | 意味           | データ例 | データ例の内容           | 備考          |
| -- | ---- | ------------ | ---- | ----------------- | ----------- |
| 1  | 1    | 送信先の論理デバイスID | 01   | 送信先の論理デバイスIDは0x01 |             |
| 2  | 1    | コマンド種別       | 90   | 0x90コマンド          | 90固定        |
| 3  | 1    | コマンド数        | 01   | コマンドは1個           |             |
| 4  | 1    | コマンドID       | 00   | コマンド00            |             |
| 5  | 1    | 送信先PAL ID    | 04   | 通知パルに対して送信する      |             |
| 6  | 1    | 未使用領域        | 00   |                   |             |
| 7  | 1    | イベントID       | 01   | イベント1             | 0x00～0x10まで |
| 8  | 1    | チェックサム       | 69   |                   |             |

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

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

```
:019001010601085E
 ^1^2^3^4^5^6^7^8
```

| 番号 | バイト数 | 意味           | データ例 | データ例の内容           | 備考          |
| -- | ---- | ------------ | ---- | ----------------- | ----------- |
| 1  | 1    | 送信先の論理デバイスID | 01   | 送信先の論理デバイスIDは0x01 |             |
| 2  | 1    | コマンド種別       | 90   | 0x90コマンド          | 90固定        |
| 3  | 1    | コマンド数        | 01   | コマンドは1個           |             |
| 4  | 1    | コマンドパラメータID  | 01   | コマンドパラメータID 0x01  |             |
| 5  | 1    | 色            | 06   | 白                 |             |
| 6  | 1    | 点滅パターン       | 01   | 点滅                |             |
| 7  | 1    | 明るさ          | 08   | 明るさ8              | 0x00～0x0Fまで |
| 8  | 1    | チェックサム       | 5E   |                   |             |

#### &#x20;例3：通知パルのLEDの点灯色と点灯時間を送信する。

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

{% hint style="warning" %}
本コマンドを試す場合、送信間隔を必ず点灯時間より大きく設定してご使用ください。
{% endhint %}

```
:0190020104000802FF00015E
 ^1^2^3^4^5^6^7^8^9^a^b^c
```

| 番号 | バイト数 | 意味           | データ例 | データ例の内容           | 備考          |
| -- | ---- | ------------ | ---- | ----------------- | ----------- |
| 1  | 1    | 送信先の論理デバイスID | 01   | 送信先の論理デバイスIDは0x01 |             |
| 2  | 1    | コマンド種別       | 90   | 0x90コマンド          | 90固定        |
| 3  | 1    | コマンド数        | 02   | コマンドは2個           |             |
| 4  | 1    | コマンドパラメータID  | 01   | コマンドパラメータID 0x01  |             |
| 5  | 1    | 色            | 04   | 紫                 |             |
| 6  | 1    | 点滅パターン       | 00   | 点灯                |             |
| 7  | 1    | 明るさ          | 08   | 明るさ8              | 0x00～0x0Fまで |
| 8  | 1    | コマンドパラメータID  | 02   | コマンドパラメータID 0x02  |             |
| 9  | 1    | 未使用領域        | FF   |                   |             |
| a  | 1    | 未使用領域        | 00   |                   |             |
| b  | 1    | 点灯時間         | 01   | 点灯後1秒で消える         |             |
| c  | 1    | チェックサム       | 5E   |                   |             |

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

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

```
:01900103FF0F0459
 ^1^2^3^4^5^^^6^7
```

| 番号 | バイト数 | 意味           | データ例 | データ例の内容            | 備考                                                         |
| -- | ---- | ------------ | ---- | ------------------ | ---------------------------------------------------------- |
| 1  | 1    | 送信先の論理デバイスID | 01   | 送信先の論理デバイスIDは0x01  |                                                            |
| 2  | 1    | コマンド種別       | 90   | 0x90コマンド           | 90固定                                                       |
| 3  | 1    | コマンド数        | 01   | コマンドは2個            |                                                            |
| 4  | 1    | コマンドパラメータID  | 03   | コマンドパラメータID 0x03   |                                                            |
| 5  | 1    | 未使用          | FF   |                    |                                                            |
| 6  | 2    | LEDの点灯色      | 0F04 | 青:15、赤4の明るさで点灯させる。 | <p>LSBからRGBWの順番で各色4bitずつ(0～15)で指定する。</p><p>数値が大きいほど明るい</p> |
| 7  | 1    | チェックサム       | 59   |                    |                                                            |

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

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

{% hint style="warning" %}
本コマンドを試す場合、送信間隔を必ず点灯時間より大きく設定してご使用ください。
{% endhint %}

```
:0190020104000802FF00015E
 ^1^2^3^4^5^6^7^8^9^a^b^c
```

| 番号 | バイト数 | 意味           | データ例 | データ例の内容           | 備考          |
| -- | ---- | ------------ | ---- | ----------------- | ----------- |
| 1  | 1    | 送信先の論理デバイスID | 01   | 送信先の論理デバイスIDは0x01 |             |
| 2  | 1    | コマンド種別       | 90   | 0x90コマンド          | 90固定        |
| 3  | 1    | コマンド数        | 02   | コマンドは2個           |             |
| 4  | 1    | コマンドパラメータID  | 01   | コマンドパラメータID 0x01  |             |
| 5  | 1    | 色            | 04   | 紫                 |             |
| 6  | 1    | 点滅パターン       | 00   | 点灯                |             |
| 7  | 1    | 明るさ          | 08   | 明るさ8              | 0x00～0x0Fまで |
| 8  | 1    | コマンドパラメータID  | 02   | コマンドパラメータID 0x02  |             |
| 9  | 1    | 未使用領域        | FF   |                   |             |
| a  | 1    | 未使用領域        | 00   |                   |             |
| b  | 1    | 点灯時間         | 01   | 点灯後1秒で消える         |             |
| c  | 1    | チェックサム       | 5E   |                   |             |