# TwePacketPal

`TwePacketPal`クラスは、TWELITE PALのパケットデータを解釈したものです。このクラスはTWELITE PAL（センサーデータなど上り方向）共通に取り扱います。

```cpp
class TwePacketPal : public TwePacket, public DataPal { ... };
```

PAL共通データは[`DataPal`](https://mwm5.twelite.info/1.0-2/references/parser/twefmt/packet-types/twepacketpal/datapal)に定義されています。

PALの各センサー基板特有のデータを取り出すためのジェネレータ関数を用意しています。

### spTwePacketからの参照

```cpp
TwePacketPal& refTwePacketPal(spTwePacket& p)
```

`spTwePacket`オブジェクトから`TwePacketPal`オブジェクトを参照します。`spTwePacket`に`TwePacketPal`以外が格納されている場合は、未解釈のオブジェクトを戻します。

### 実行例

```cpp
if (parse_ascii) { // アスキー形式のパーサーの解釈完了
  if (identify_packet_type(parse_ascii.get_payload()) == E_PKT::PKT_PAL) {
    auto&& pkt = newTwePacket(parse_ascii.get_payload(), E_PKT::PKT_PAL);
    
    if (pkt == E_PKT::PKT_PAL) { // パケット解釈成功時
      auto&& pal = refTwePacketPal(pkt);
      
      // 開閉センサーパル
      if (pal.u8palpcb == E_PAL_PCB::MAG) {
        PalMag mag = pal.get_PalMag();
        if (mag.u8MagStat == 0) {
          // OPEN
        } else {
          // CLOSE
        }
      }
    }
  }
}
```

## パケットデータ定関数

### has\_palEvent()

```cpp
bool has_PalEvent()
bool is_PalEvent()
```

パケットにイベント情報が含まれるかを判定します。

### get\_PalDataType()

```cpp
E_PAL_DATA_TYPE get_PalDataType()
```

パケットの種別を判定します。種別は[`E_PAL_DATA_TYPE`](https://mwm5.twelite.info/1.0-2/references/parser/twefmt/packet-types/twepacketpal/e_pal_data_type)として判定されます。

### has\_data\_info()

```cpp
bool has_data_info()
```

パケットプロパティ（パケットの補助情報）が含まれているか判定します。含まれている場合は`PalDataInfo`で定義されるメンバーにアクセスできます。

### is\_data\_source\_timer()

```cpp
bool is_data_source_timer()
```

パケットプロパティが存在する場合に呼び出しは有効。タイマー由来からの送信の場合trueを返します。

## ジェネレータ関数

センサーPALの各種データを取り出すためのジェネレータ関数です。

### get\_PalMag()

```cpp
PalMag get_PalMag()
```

`.u8palpcb==E_PAL_PCB::MAG`の場合、開閉センサーパルのデータ[`PalMag`](https://mwm5.twelite.info/1.0-2/references/parser/twefmt/packet-types/twepacketpal/palbase/palmag)を取り出します。

### get\_PalAmb()

```
PalAmb get_PalAmb()
```

`.u8palpcb==E_PAL_PCB::AMB`の場合、環境センサーパルのデータ[`PalAmb`](https://mwm5.twelite.info/1.0-2/references/parser/twefmt/packet-types/twepacketpal/palbase/palamb)を取り出します。

### get\_PalMot()

```
PalMot get_PalMot()
```

`.u8palpcb==E_PAL_PCB::MOT`の場合、動作センサーパルのデータ[`PalMot`](https://mwm5.twelite.info/1.0-2/references/parser/twefmt/packet-types/twepacketpal/palbase/palmot)を取り出します。

### get\_PalEvent()

```
PalEvent get_PalEvent()
```

`.is_PalEvent()`が`true`の場合`PalEvent`(PALイベント)を取り出します。