# 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   |                   |             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wings.twelite.info/how-to-use/parent-mode/transemit-command/0x90-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
