1. SpeeDBee Hive ユーザーガイド#

1.1 はじめに#

SpeeDBee Hive （以降Hive）は、コレクタが各種情報を収集し、エミッタが他システムへデータ送信を行います。収集データは時系列データベースに保存し、DB機能にて、リアルタイム分析（基本統計など）する事が可能です。またエミッタにより、過去データも含めて送信前にデータを再分析し、送信する事ができます。 　本書は、Hiveを動作するための設定方法について説明します。

標準機能で提供するコネクタおよびエミッタ

1.2 初期設定#

1.2.1 設定画面の表示#

PCブラウザにて、下記のURLを入力し、SpeeDBee Hiveがインストールされた機器にアクセスする事で、設定画面が表示されます。 現時点ではMicrosoft Edge、もしくはGoogle Chromeでのアクセスのみをサポートしています。

• Linux: http://xxx.xxx.xxx.xxx/hive
• Windows: http://xxx.xxx.xxx.xxx:8120/hive

「xxx.xxx.xxx.xxx」は機器のIPアドレスとなります。 アクセスするとユーザー認証のダイアログが表示されます。インストール直後のユーザー名、パスワードは下記を使用してください。なお、このユーザー名とパスワードは、ユーザー管理のユーザーとは異なります。

ユーザー名

admin

パスワード

admin

1.2.2 ライセンス設定#

各機能を有効化するために、ライセンスの設定を行います。

1. ライセンスコードを入力し、「更新」ボタンをクリックし、ライセンス更新を行います。

1.2.3 ポイント制ライセンスについて#

ポイント制ライセンスとは、ポイントを購入し、そのポイントに応じて利用できる機能を決定するライセンスです。

ポイント制ライセンスを登録した場合、購入したポイントがソフトウェア情報に表示されます。
また、画面上ですべての機能が有効となっています。

設定した機能のポイントを合計して利用ポイントとします。
例として、PLCコレクタ(2p)、EnOceanコレクタ(2p)、AWSエミッタ(2p)、MQTTエミッタ(2p)を設定した場合、利用ポイントは8pとなります。

1.2.4 WEBサーバーの制御について#

WEBサーバーの制御（起動・停止・再起動）は、次の手順で行います。

1.2.4.1 Linux#

• 起動

  $ sudo systemctl start sbhived-setting-server
  

• 停止

  $ sudo systemctl stop sbhived-setting-server
  

• 再起動

  $ sudo systemctl restart sbhived-setting-server
  

利用形態2については、コマンド引数が一部異なります。 利用形態2をご覧ください。

1.2.4.2 Windows#

• 起動 （speedbeehiveが停止状態の場合に選択可能です。）

  Windowsメニューから「サービス」を起動し、speedbeehiveを右クリックして「起動」を選択

  

• 停止

  Windowsメニューから「サービス」を起動し、speedbeehiveを右クリックして「停止」を選択

  

• 再起動

  Windowsメニューから「サービス」を起動し、speedbeehiveを右クリックして「再起動」を選択

  

1.2.5 画面構成#

設定画面は、「メニュー」「サブメニュー」「設定画面」３つの領域で構成されています。

各メニュー、およびサブメニューから下記の内容を設定します。（※１はオプション）

1.2.6 機能一覧#

標準で提供されている機能と、オプションで利用できる機能の一覧です。

1.3 システム設定#

1.3.1 制御#

サービスの起動・停止および、コレクタ／エミッタの状態を参照します。

1. 「停止」をクリックし、サービスを停止します。
2. 「起動」をクリックし、サービスを起動します。

1.3.1.1 コレクタ／エミッタに表示されるアイコン#

• コレクタ／エミッタに表示されるアイコンの意味は下記の通りです。

  • 種別

    アイコン	内容
    	リソースコレクタ
    	PLCコレクタ SmartHopコレクタ
    	カスタムコレクタ
    	MQTTコレクタ
    	ビデオコレクタ OCRコレクタ
    	RFIDコレクタ EnOceanコレクタ 作業検出RFIDコレクタ
    	イベントコレクタ
    	演算コレクタ
    	Edgecross RT Receiver
    	送信先がAWS
    	送信先がAzure
    	送信先がMQTT
    	ファイルに保存する
    	送信先がFTP/FTPS/SFTP
    	送信先がMachine Advisor
    	送信先がSensorCorpus
    	送信先がカスタム
    	削除済み

  • 状態

    アイコン	内容
    	動作している
    	エラーが発生して、停止している
    	稼働していない

  • 警告

    アイコン	内容
    	問題は発生していない
    	警告が発生している
    	エラーが発生している
    	稼働していない ※警告、エラー発生時は警告欄の をクリックすることでログが表示されます。

  • 変更・無効

    アイコン	内容
    	設定が無効化されている（稼働していない）
    	設定が削除されている

• サービスを再起動し、設定が反映すると削除／変更アイコンはクリアされます。

  

1.3.1.2 エラー解除#

コンポーネントのエラーが復旧し、警告、エラーを解除したい場合、警告チェックボックスをONにした後、「エラー解除」をクリックします。

1. 警告、エラーを解除したいコンポーネントの警告チェックボックスをONにします。

   複数まとめて選択、解除を行う場合

   「すべて選択」、「すべて解除」でまとめて、警告対象のコンポーネントのすべてを選択、解除が可能です。

2. 「エラー解除」をクリックします。

   表示されたダイアログで「更新」を選択します。
   
   

   警告、エラーが解除されます。
   
   

1.3.1.3 操作ログ#

操作ログを確認する場合、「ダウンロード」もしくは「閲覧」をクリックします。 操作ログはその他ログと同じファイルに記録されます。そのため、ログがローテーションされると、古いものは閲覧できなくなります。ローテーションされたログは1ファイル約10MBで最大5ファイルまで保持されます。

ダウンロード

1. 「ダウンロード」をクリックすると、操作ログ、その他、稼働ログのファイルをダウンロードします。

   

閲覧

1. 「閲覧」をクリックするとログ閲覧ウィンドウが表示されます。

2. 「操作ログ」、「その他」と「稼働ログ」が選択でき、選択したログが表示されます。

3. 「再取得」をクリックするとログが更新されます。

4. 「閉じる」をクリックするとウィンドウを閉じます。

1.3.2 ユーザー管理#

1.3.2.1 ユーザー管理の概要#

ユーザー管理によりセキュリティの強化、運用の安全性の向上、システムの操作状況を把握することが出来ます。この機能は、通常のBASIC認証に加えてユーザーを作成することで ユーザー単位での認証を可能とします。

• セキュリティ強化：
  登録されているユーザーだけがシステムを利用できるため、把握しているユーザのみがシステムを使用できます。
  

• 運用の安全性の向上：
  登録ユーザーの権限が閲覧者権限の場合、不用意に設定を変えることが出来ません。
  

• システムの操作状況把握：
  操作ログを確認することで登録ユーザーの操作状況を確認することができます。
  

1.3.2.2 ユーザー管理の有効化手順#

ユーザー管理を有効化設定を行うには、次の設定が必要です。

1. 専用の拡張設定ファイルを配置します。

   拡張設定ファイルの配置には、OSの管理者権限が必要です。
   配布された専用の拡張設定ファイルを確認し、ファイルを配置します。配置場所を下記に示します。

   WindowsLinux 系

   C:\Program Files\SALTYSTER\SpeeDBeeHive\libexec\speedbeehive\conf\user_specification.json
   

   /usr/local/libexec/speedbeehive/conf/user_specification.json
   

   • 拡張設定ファイルのユーザー管理、操作ログの有効化設定について：
     • 拡張設定ファイル：user_specification.json

     • 設定内容： 　

       設定	項目	値
       ユーザー管理設定	user_management	有効(true) / 無効(false)
       操作ログ設定	operation_logging	有効(true) / 無効(false)

       {
           "user_management": true,
           "operation_logging": true
       }
       

2. 拡張設定ファイル配置後、サービスを再起動します。

   サービスが再起動されるまで 設定は反映されません。
   拡張設定ファイルを配置した後、サービスの再起動を行います。

   SpeeDBee Hive（ユーザーガイド）の「WEBサーバーの制御について」をご参照ください。

3. ユーザー管理が有効になるとSpeeDBee Hiveのトップ画面へのアクセスでログイン認証画面が表示されるようになります。

   ユーザー管理有効後のログイン認証画面のログイン名、パスワードについて

   システム管理用ログイン名、パスワードは次のとおりです。

   項目	初期値
   ログイン名	admin
   パスワード	admin

   ** adminは全ての操作が可能な管理者です。 ログイン後に必ずパスワードを変更して下さい。 **

   自動ログアウトについて

   一定時間操作を行わない場合、タイムアウトとなり自動的にログアウトされ、ログイン画面が表示されます。

1.3.2.3 ユーザー情報の登録#

1. 下記の項目を入力します。
   
   ※入力項目クリアする場合は、「追加」をクリックした後、項目を入力します。
   
   

   入力項目	説明
   ログイン名	システムにログインするためのログイン名（ログイン認証用）
   権限	管理者：システム設定や各種設定及び検索、参照が可能 閲覧者：検索、参照のみ
   パスワード	システムにログインするためのパスワード（ログイン認証用）
   確認	パスワード確認用
   ユーザー名	ユーザー名（フルネーム）
   E-Mailアドレス	E-Mailアドレス
   無効にする	ログイン出来なくなります。

2. 「登録」をクリックし、設定を更新します。

   

1.3.2.4 ユーザー情報の参照、更新、削除#

1. ユーザー一覧からユーザを選択します。（参照）

2. 変更項目を入力後、「更新」ボタンをクリックし、設定を更新します。

3. ユーザ情報を削除したい場合、対象データの削除のチェックボックスをONにした後、削除ボタンをクリックします。
   
   

   表示されたダイアログで削除をクリックします。
   

   ユーザー一覧からデータが削除されます。
   

1.3.2.5 ユーザー権限#

• 権限概要：

  • 管理者：
    システムの管理全般を行うためのユーザです。
    システム設定及び各種コレクタ、簡易設定、エミッター設定、常時録画検索、ビューワー、グラフ、データ分布モニタ、ログ参照が可能です。
  • 閲覧者：
    システムの参照機能が行えるユーザです。
    常時録画検索、ビューワー、グラフ、データ分布モニタ、ログ参照が可能です。

  権限による使用可能機能

  • ヘッダ部ボタン：

    • 管理者

      ボタン	内容
      	簡易設定
      	マニュアル
      	ビューワー
      	グラフ
      	ログアウト

    • 閲覧者

      ボタン	内容
      	マニュアル
      	ビューワー
      	グラフ
      	ログアウト

    ※グラフボタンの使用については、Grafana設定及びGrafana側のユーザ設定が、必要です。設定方法については、「Grafana連携」 をご参照ください。

  • タブ表示：

    • 管理者
      

    • 閲覧者
      

  • システムメニュー表示：

    • 管理者
      

    • 閲覧者
      

1.3.3 設定#

サーバの基本情報、コレクタで利用する情報の設定を行います。

1. 下記の項目を入力します。

   

   入力項目	説明
   サーバ名	システム内においてユニークで任意な名称を設定 エミッタのメッセージでIDになる
   説明	サーバの説明
   ストレージパス	データベースの保存先ディレクトリ
   ストレージ保存期間（分）	ストレージ上にデータを保持する時間　(60~9999)
   メモリ保存期間（分）	メモリ上にデータを保持する時間　(5~30)
   カスタムモジュールパス	カスタムモジュールの格納ディレクトリ
   デバイス名	コレクタで利用するシリアルデバイスファイル名
   通信速度	ビットの転送速度
   データビット	送信データのビット長
   ストップビット	送信データの終端を表すビット長
   パリティ	パリティチェックに使用するビット
   通信モード	シリアル通信のアーキテクチャ

2. 「保存」をクリックし、設定を更新します。

1.3.4 パスワード変更#

設定画面のログインで利用するadminユーザーのパスワードを変更します。

1. 「パスワード」、「確認」項目に同一のパスワード文字列を入力します。（6~10文字）

2. 「更新」をクリックし、パスワードを変更します。

   

1.3.5 データ分布モニタ#

コレクタで登録した値を、時間軸上で分布表示します。システム設定の制御からサービスを起動している状態で使用できます。

1. コレクタ選択で表示するコレクタを選択します。
   
2. 他にも表示したい場合、「＋コレクタを追加」で表示するコレクタを追加します。
3. 「適用」でデータ分布モニタが表示されます。
   
4. 分布モニタへマウスカーソルを合わせると、データの値（登録時間）が表示されます。

1.4 サービス#

1.4.1 データベース#

DBのサーバー/クライアント機能を設定します。

1.4.1.1 データベース設定#

データベース設定を更新します。

• 下記の項目を入力し、「保存」をクリックし設定を保存します。

  

  入力項目	説明
  ポート	開放するポート
  セッションタイムアウト（秒）	セッションのタイムアウト時間（1～300）
  受信タイムアウト（秒）	受信時のタイムアウト時間（1～300）
  送信タイムアウト（秒）	送信時のタイムアウト時間（1～300）
  最大セッション数	セッションの最大数（1～16）
  最大カーソル数	カーソルの最大数（1～8）
  無効にする	データベースを利用するか
  ユーザー名	データベース接続時に使用するユーザー名
  パスワード	データベース接続時に使用するパスワード

  • ユーザー名、パスワードを設定しないと接続できません。
  • ユーザー名、パスワードは最大5個まで設定できます。

1.4.1.2 カラムの編集#

1. 「編集」をクリックし編集画面に移動します。

   

2. 登録
   下記の項目を入力します。

   

   入力項目	説明
   データ名	カラム名の「$db_service:」以降に表示されるユニークな任意の名称
   データ型	登録するカラムのデータ型を選択
   配列数	上記のデータ型の配列数
   サンプルレート	登録するカラムのサンプルレート
   永続化する	ストレージ上に保存する
   リアルタイム分析を利用する	リアルタイム分析を利用する チェック時には基本統計、移動平均値、FFTが編集可能 ※FFT解析はサンプルレートが1以上の時のみ編集できます ※各項目の詳細は 「補足」 をご参照ください

   補足

   カラム値、またはリアルタイム分析の値を永続化した項目が、エミッタの選択対象になります。

3. 「新規」をクリックして保存します。
   
   

4. カラム一覧に追加されます。
   入力項目を変更して、「新規」をクリックする事で連続登録できます。
   

5. 更新
   変更するカラムを選択します。
   
   

   変更する項目を入力し、更新をクリックします。（入力項目は新規カラムと同様です）

6. 削除
   カラム一覧の右にあるチェックボックスをONにし、「削除」をクリックします。

   カラム削除、カラムの永続化ON→OFF、カラムの分析項目をON→OFFにする事で収集項目がなくなります。エミッタにて、そのデータ項目を利用している場合、自動削除されます。

1.4.2 OPC UA設定#

OPC UA設定を行います。

• 下記の項目を入力し、「更新」をクリックし設定を保存します。

  

  入力項目	説明
  ポート	開放するポート
  サーバータイプ	Standalone or with-idmse
  外部LDS	URL 外部LDSを設定する場合のURL
  無効にする	OPC UAを無効化する
  ゲストユーザーを許可する	ゲストユーザーを許可する
  ユーザー名	接続時に使用するユーザー名
  パスワード	接続時に使用するパスワード

  ユーザー名、パスワードは最大5個まで設定できます。

1.5 コレクタ#

コレクタ設定を参照／登録／更新します。
本バージョンは提供するコレクタは、リソース、PLC、カスタムとなります。

1.5.1 リソースコレクタ#

Hiveが稼働する機器のシステム情報などの収集設定をします。
収集可能な情報は、CPU使用率、CPUクロック数、CPU温度、I/O状況、メモリ利用量、ネットワーク利用状況です。

• 下記の項目を入力し、「保存」をクリックし設定を保存します。

  

  入力項目	説明
  取得周期（秒）	データを収集する周期（１～60秒）
  分析幅	リアルタイム分析を利用する場合の分析幅 （件数：1～1000、秒：1～60）
  分析単位	秒　または　件数
  I/Oデバイス	I/O項目を有効にした際に取得するデバイス
  NETデバイス	ネットワークを有効にした際に取得するデバイス
  リソース項目	・収集 　収集の有無 ・分析 　リアルタイム分析の有無、分析内容 ・永続化 　ストレージ保存の有無

  • IOデバイスに指定したデバイスがなくなった場合、リソースコレクタが起動できない場合があります。 その場合はリソースコレクタを再設定してHiveを再起動してください。
  • 永続化した項目がエミッタでの選択対象になります。

1.5.2 PLCコレクタ#

コレクタ設定を参照／登録／更新を行います。

1.5.2.1 PLCの登録#

PLCの新規登録を行います。

1. PLCの をクリックします。

   

2. 下記の項目を入力します。（入力項目は機種により違います。）

   • 共通項目

     入力項目	説明
     PLC名	データを収集するコレクタ名 コレクタ全体で重複不可
     機種	接続するPLC機種
     エンディアン	PLCのバイトオーダ （Modbus TCP選択時のみ入力可能）
     無効にする	コレクタの稼働を無効にする（設定のみ行う場合に利用）
     常時接続する	PLC接続を問い合わせの都度、切断しない
     一括取得	一度に複数のReadレジスタの読み込みを行う
     ブロック取得	一度に複数のReadレジスタの読み込みを行う (三菱対応機種のみで使用可能)

     補足

     • 一括取得は、対応機種のみで選択可能です。有効にすると、データ取得が高速化します。
       一括取得では、１つのレジスタの設定に不備がある場合、そのレジスタを含む一括取得の全レジスタが取得エラーとなります。
       一括取得をONにした状態でエラーが発生する場合、一括取得をOFFにして再度テスト接続を実行してください。
       一括取得をOFFにすることで、アドレスなどの指定が不正な場合エラー内容が確認できます。
       一括取得がOFFでエラーが発生しない場合、一括取得またはブロック取得に対応していない機種となります。
     • 一括取得が未設定の場合は、Readレジスタ毎に個別で読み込みます。
     • MELSEC-Qシリーズ(QnA互換3Eフレーム)の一括取得とブロック取得は次のように動作します。
       一括取得は、ワードレジスタのみを一括読み込みします。(0403コマンド使用)
       ブロック取得は、ビットレジスタ、ワードレジスタを一括読み込みします。(0406コマンド使用)
     • ブロック取得は、一括取得を有効にすると選択可能となります。
       （MELSEC-Qシリーズ(QnA互換3Eフレーム)のみ）
     • ブロック取得については、テスト接続にてデータ取得できることを確認してください。エラーになる場合は、接続しているPLCがこの機能に対応していません。

   • TCP/IP

     入力項目	説明
     IPアドレス	PLCのIPアドレス
     ポート	PLCのポート番号

   • タイムアウト

     入力項目	説明
     接続タイムアウト(ms)	接続時のタイムアウト時間（100～10000ミリ秒）
     読込タイムアウト(ms)	読込時のタイムアウト時間（100～10000ミリ秒）

3. 「保存」をクリックし、PLC設定を保存します。

1.5.2.2 PLCの参照・更新・削除#

PLCの参照／更新／削除を行います。

1. サブメニューから参照するPLCをクリックし参照します。

2. 変更項目を入力後、「保存」をクリックし、設定を更新します。
   データを削除したい場合は、「削除」をクリックし、設定を削除します。
   

   

1.5.2.3 読出しレジスタの編集#

PLCレジスタの収集情報を設定します。

1. 「編集」をクリックします。

   

2. 登録
   下記の項目を入力します。
   

   

   入力項目	説明
   レジスタ名	データ名称（読出しレジスタ内で重複しない名称）
   アドレス	PLCのレジスタアドレス
   データ型	上記アドレスを先頭にして取得するデータ型を選択
   配列数	上記のデータ型で配列数を設定（アドレスの点数ではない）
   種類	「Modbus RTU/TCP」をご参照ください
   エンディアン	レジスタ単位でのバイトオーダを選択 （※-の場合、コレクタのエンディアンを適用） Modbus RTU/TCP選択時に以下に該当する場合に入力可能 データ型： 　UINT32 or INT32 or UINT64 or INT64 or FLOAT or DOUBLE 種類： 　保持レジスタ or 入力レジスタ
   収集方式	収集方式を選択 ・周期 　指定された間隔でデータを取得 ・値変化 　前回値と異なる時にデータを取得 ・ビットON 　前回値が０で取得したデータが０以外
   収集間隔（秒）	レジスタ値を取得する間隔を0.1秒単位で指定 （0.1～9999.9秒）
   条件	取得した値を比較しTrueの場合のみ送信 ※1）
   条件値	上記の条件が指定されたときの比較値
   数値変換	変換式および変換後のデータ型
   登録条件	DBに登録するデータの判定式
   無効にする	情報収集を無効にする（設定のみ行う場合に利用）
   永続化する	ストレージ上に保存する
   リアルタイム分析を使用する	リアルタイム分析を利用する。 チェック時には基本統計、移動分析値を編集可能 ＊ 各項目の詳細は 「補足」 をご参照ください

   条件が【等しい】or【等しくない】の設定時の注意

   浮動小数点の場合（データ型：FLOAT、DOUBLE）、丸め誤差があるため一致判定ができない場合があります。

   補足

   • 指定できるレジスタアドレスは、 「補足」 の機種別の資料をご参照ください。
   • レジスタ値、または基本統計の値を永続化した項目が、エミッタの選択対象になります。
   • ビットレジスタは、データ型BOOLを設定する必要があります。
   • ワードレジスタは、データ型BOOLを設定する事はできません。
   • 数値変換、登録条件については「コレクタの共通機能」を参照してください。

3. 「新規」をクリックし、レジスタ設定を保存します。

   

4. レジスタ一覧に追加されます。
   ※入力項目を変更して、「新規」をクリックする事で連続登録できます。
   

   

5. 更新
   変更するレジスタを選択します。
   

   

6. 変更する項目を入力し、更新をクリックします。
   （入力項目は新規レジスタと同様です）
   

   

7. 削除
   レジスタ一覧の右にあるチェックボックスをONにし、「削除」をクリックします。
   

   

1.5.2.4 ニーモニックファイルからの読出しレジスタ自動設定#

一部のメーカーのPLC（キーエンス、OMRON、三菱）では、ラダープログラムで使用しているレジスタをニーモニックファイルから読み込み、自動で一括設定することが出来ます。

1. 「編集」をクリックします。

   

2. [Readレジスタ自動設定]ボタンをクリックします。

   

3. 読み込むニーモニックファイルを選択します

データ型、収集方式、収集間隔等、変更が必要な場合は、一括設定後レジスタごとに項目を変更して、更新してください。 更新の手順は、読出しレジスタの編集の5.更新を参照してください。

※各対応メーカーのニーモニックファイルについてはニーモニックファイル出力方法を参考にしてください。

1.5.2.5 書込みレジスタの編集#

PLCレジスタの書込み情報を設定します。

1. 「編集」をクリックします。

   

2. ReadからWriteに切り替えます。

   

3. 登録

   下記の項目を入力します。

   入力項目	説明
   レジスタ名	データ名称（書込みレジスタ内で重複しない名称）
   アドレス	PLCのレジスタアドレス ※指定できるレジスタアドレスは、 「補足」 の機種別の資料をご参照ください
   データ型	上記アドレスを先頭にして書き込む値のデータ型を選択
   配列数	上記のデータ型で配列数を設定（アドレスの点数ではない）
   種類	「Modbus RTU/TCP」をご参照ください
   エンディアン	レジスタ単位でのバイトオーダを選択 （※-の場合、コレクタのエンディアンを適用） Modbus RTU/TCP選択時に以下に該当する場合に入力可能 データ型： 　UINT32 or INT32 or UINT64 or INT64 or FLOAT or DOUBLE 種類： 　保持レジスタ
   イベント	レジスタへの書込みの起点となるイベントを選択 ※イベントの設定方法については「イベント」をご参照ください
   値種別	レジスタに書き込む値を設定
   	固定値 指定された値でレジスタに書込み ※配列数を2以上に設定した場合、配列数分の、指定された値を書き込みます
   	コレクタ 事前に設定されているコレクタのデータを選択 選択されたデータの値でレジスタに書込み ※書き込まれる値は、最も新しく取得された値です ※配列数を、選択したデータの配列数と同じにする必要があります
   	イベント 上記で設定したイベントのトリガとなる値で、レジスタに書込み
   無効にする	レジスタへの書込みを無効にする（設定のみ行う場合に利用）

   データ型について

   書き込む値のデータ型は、書込みレジスタに設定するデータ型と一致させる必要があります。
   以下の表を参照してください。
   

   書込みレジスタに設定するデータ型	書き込む値のデータ型
   BOOL型	BOOL型
   整数型	整数型
   浮動小数点型	浮動小数点型
   STRING型	STRING型

   ※整数型と浮動小数点型の変換は行われないため、整数型と浮動小数点型を一緒に設定することは出来ません。
   （例：書込みレジスタに整数型が設定されている時、浮動小数点型のデータを書き込むことは出来ません。）
   ※整数型と浮動小数点型については、書込みレジスタに設定されているデータ型と同じサイズ、または小さいサイズのデータ型の値を書き込むことが出来ます。
   （例：書込みレジスタにINT32が設定されている時、INT16、UINT16、INT32、UINT32のデータを書き込むことが出来ます。）
   
   
   

4. 「新規」をクリックし、レジスタ設定を保存します。
   
   

5. Writeレジスタ一覧に追加されます。
   ※入力項目を変更して、「新規」をクリックする事で連続登録できます
   

   

   書込みレジスタで設定されているイベントやコレクタのデータが、削除または変更された場合、対象となる書込みレジスタが自動削除されることがあります。

6. 更新
   変更するレジスタを選択します。
   
   
   

7. 変更する項目を入力し、「更新」をクリックします。（入力項目は新規レジスタと同様です）

   

8. 削除
   レジスタ一覧の右にあるチェックボックスをONにし、「削除」をクリックします。
   

   

1.5.2.6 PLC接続テスト#

設定したPLCの接続テストを行います。

1. 対象となるPLCを選択して、「Test」をクリックします。

   

2. テスト結果が表示されます。

   

   補足

   • 対象のPLCのポート番号をサービスやアプリケーションで利用されている場合、エラーになる可能性があります。エラーが発生した場合、Hiveサービスを停止してから再度、試してみてください。
   • エラー内容に従い、レジスタ設定を修正してください。

1.5.2.7 PLC設定の出力、取込#

設定したPLC情報をJSONファイルに出力、および新規作成時に出力されたファイルを基に、PLC定義を設定できます。

1. 出力
   対象となるPLCを選択して、「出力」をクリックします。
   ※定義ファイル（JSON）がダウンロードされます。
   
   

   

2. 取込
   PLC行の をクリックします。
   

   

3. 「取込」 をクリックし、PC上にある定義ファイル（JSON）を選択します。

   

4. 定義ファイルのPLC情報を基にPLCが新規登録されます。

1.5.3 カスタムコレクタ#

ユーザーが定義したコレクタに基づいて情報収集をします。
事前にカスタムモジュールパス に指定したディレクトリに、カスタムコレクタ（シェアードライブラリ）を配置してください。
ここではサンプルライブラリ「cltrrandomsin.so」（Windows版では「cltrrandomsin.dll」）を使って説明します。

1.5.3.1 カスタムコレクタ設定#

1. カスタムの をクリックすると登録画面が表示されます。

   

2. 下記の項目を入力します。

   

   入力項目	説明
   カスタム名	データを収集するコレクタ名 コレクタ全体で重複不可
   タイプ	シェアードライブラリのタイプを選択 Linuxでは「so」固定、Windowsでは「dll」固定 保存後は変更不可
   ライブラリ	カスタムモジュールパスに配置したシェアードライブラリを選択 保存後は変更不可
   パラメータ	ライブラリ内で利用される引数（文字列） cltrrandomsin.soでは入力の必要は不要

3. 「保存」をクリックし、設定を保存します。

1.5.3.2 カスタムコレクタの参照・更新・削除#

1. サブメニューから参照するカスタムコレクタをクリックし参照します。

2. 変更項目を入力後、「保存」をクリックし、設定を更新します。
   データを削除したい場合は、「削除」をクリックし、設定を削除します。
   

   

   カスタムコレクタを削除するとデータで設定した収集項目がなくなります。
   エミッタにて、そのデータ項目を利用している場合、自動削除されます。
   

1.5.3.3 データの初期化#

1. 「初期化」をクリックしてください。

   

   初期化するとデータで編集した収集項目が元に戻ります。
   エミッタにて、そのデータ項目を利用している場合、自動削除されます。
   

1.5.3.4 データの編集#

1. 「編集」をクリックします。

   

2. データ一覧から編集するデータを選択します。

3. 下記の項目を変更して、「更新」をクリックします。

   

   入力項目	説明
   データ名	データ名称（カスタム内で重複しない名称）
   データ型	取得するデータ型
   配列数	取得する配列数
   サンプルレート	1秒間に取得する値の数
   永続化する	ストレージ上に保存する
   リアルタイム分析を使用する	リアルタイム分析を利用する。 チェック時には基本統計、移動分析値、FFTを編集可能 ※FFT解析はサンプルレートが1以上の時のみ設定できます ※各項目の詳細は 「補足」 をご参照ください

   データ型、配列数、サンプルレートは変更できません。

1.6 コレクタの共通機能#

一部のコレクタでは、「数値変換」、「登録条件」の機能を使用できます。

1.6.1 数値変換#

数値変換は、コレクタが取得したデータに対して四則演算や様々な関数処理を施し、計算した結果をデータとして保存する機能です。コレクタのデータ一覧編集画面にて、そのコレクタが集めるデータ各々に対して数値変換の数式を設定できます。

下記の項目を入力します。

1.6.2 登録条件#

登録条件は、コレクタが取得したデータに対して四則演算や様々な関数を使った比較式を施し、その比較結果が「真」となる場合のみ、データベースに登録する機能です。比較結果が「偽」の場合は、そのデータは取得しなかったものとして破棄されます。

下記の項目を入力します。

1.7 イベント#

イベントの設定の参照／登録／更新を行います。
トリガ、イベント、コマンドの順で設定します。

1.7.1 トリガ設定#

イベントのトリガを設定します。

1.7.1.1 トリガの登録#

1. トリガの をクリックします。

   

2. 下記の項目を設定します。

   入力項目	説明
   トリガ名	イベント項目設定で表示される名称
   コレクタ	トリガにするデータを収集しているコレクタ、設定後は変更不可
   データ	トリガ条件にするデータ、設定後は変更不可
   条件種別	条件式に対しての種別 ・True : 条件式が真なら発生 ・False : 条件式が偽なら発生 ・Fall : 条件式が真→偽の際に発生 ・Raise : 条件式が偽→真の際に発生 ・Anytime : 値の登録時に発生
   条件式	条件となる式 ※条件種別がAnytimeの場合入力不可

3. 「保存」をクリックし、トリガ設定を保存します。

   

   条件式について#

   • 使用可能な比較演算子は「 = , <> , != , < , > , <= , >= 」です。
   • 使用可能なその他の演算子は「 () , + . - , * , / , % 」です。
   • 式で利用可能な関数は以下の通りです。

   関数名	説明
   ABS	絶対値 (整数)
   ACOS	三角関数 逆余弦
   ASIN	三角関数 逆正弦
   ATAN	三角関数 逆正接
   CEIL	小数点以下切り上げ
   COS	三角関数 余弦
   COSH	双曲線余弦
   EXP	底がネイピア数 e である指数関数
   FABS	絶対値 （倍精度浮動小数）
   FLOOR	小数点以下切り捨て
   FMOD	剰余
   LOG	自然対数
   LOG10	10を底とする対数
   POW	べき乗
   ROUND	小数点以下四捨五入
   SIN	三角関数 正弦
   SINH	双曲線正弦
   SQRT	平方根
   TAN	三角関数 正接
   TANH	双曲線正接

   • グローバル変数機能については「グローバル変数機能」を参照してください。

1.7.1.2 トリガの参照・更新・削除#

トリガの参照/更新/削除を行います。

1. サブメニューから参照するトリガをクリックします。

2. 変更項目を入力後、「保存」をクリックし、設定を更新します。
   データを削除したい場合は、「削除」をクリックし、設定を削除します。
   

   

   トリガを削除すると、イベント設定から該当のトリガは自動削除されます。

1.7.2 イベント設定#

作成したトリガを元にイベントを作成します。

1.7.2.1 イベントの登録#

1. イベントの をクリックします。

   

2. 以下の項目を入力します。

   入力項目	説明
   ID	イベントID　（設定不可）
   イベント名	後述のコマンドやエミッタの設定時に表示される名称
   最小通知間隔（秒）	連続してイベントが発生した場合において、次のイベントを通知するまでの最小通知間隔（1~600）
   無効にする	イベント利用の有無
   トリガ選択	利用するトリガを選択 ※複数選択時はOR条件となります

3. 「保存」をクリックし、イベント設定を保存します。

   

1.7.2.2 イベントの参照・更新・削除#

イベントの参照/更新/削除を行います。

1. サブメニューから参照（または、更新、削除）するイベントをクリックします。

2. 変更項目を入力後、「保存」をクリックし、設定を更新します。
   データを削除したい場合は、「削除」をクリックし、設定を削除します。
   

   

   コレクタまたは、エミッタで利用されている場合は削除できません。

1.7.3 コマンド設定#

イベント発生時に実行する外部コマンドの設定を行います。

1.7.3.1 コマンド登録#

1. サブメニューからコマンドをクリックします。

   

2. 以下の項目をします。

   入力項目	説明
   コマンド	「イベント」で設定したイベントの発生時に実行されるコマンド
   イベント	実行イベントを選択
   BG	コマンドをバックグラウンドで実行するか選択

3. 「更新」をクリックし、コマンド設定を保存します。

   コマンドで利用可能な環境変数について、下表をご参照ください。

   変数名	説明
   $HIVE_EVENT_COLTYPE	カラムの型
   $HIVE_EVENT_COLARRAYSIZE	カラムの配列要素数（スカラの場合は0）
   $HIVE_EVENT_CID	DBのカラムID
   $HIVE_EVENT_COLNAME	カラム名 ※ 環境変数展開後の文字列にスペースが含まれる可能性があります
   $HIVE_EVENT_COLDATA	トリガ発生した時点の登録データ ※ 環境変数展開後の文字列にスペースが含まれる可能性があります
   $HIVE_EVENT_TRIGGER_ID	トリガID
   $HIVE_EVENT_TRIGGER_COND	トリガの条件式 （type=anytimeの場合は空文字） ※ 環境変数展開後の文字列にスペースが含まれる可能性があります
   $HIVE_EVENT_TRIGGER_TYPE	トリガの判定種別 （false/true/fall/raise/anytime）
   $HIVE_EVENT_EVENT_ID	イベントID
   $HIVE_EVENT_EVENT_NAME	イベント名 ※ 環境変数展開後の文字列にスペースが含まれる可能性があります
   $HIVE_EVENT_EVENT_LEVEL	イベントレベル
   $HIVE_EVENT_TIMESTAMP_NSEC	トリガ発生したデータのタイムスタンプ （Unixエポックのナノ秒単位の数値）
   $HIVE_EVENT_TIMESTAMP	トリガ発生したデータのタイムスタンプ （iso8601形式msecまで）

1.7.3.2 コマンド変更・削除#

コマンド、イベント、BGを変更して「更新」をクリックします。

1.8 エミッタ#

エミッタの設定を行います。

1.8.1 出力先設定#

エミッタの出力先を設定します。定義された出力先は、各エミッタで選択可能になります。
提供するエミッタの出力タイプは下記の通りです。

1.8.1.1 登録#

1. 出力先の をクリックします。

   

2. 下記の項目を入力します。（入力項目はタイプにより異なります）

   

   • 全タイプ共通

     入力項目	説明
     タイプ	AWS/Azure/MQTT/File/ FTP/FTPS/Machine Advisor/SensorCorpus/Custom(Python)
     出力先名	表示名称

   • AWS/Azure/MQTT共通

     入力項目	説明
     タイムゾーン	メッセージ内のタイムスタンプ（文字列）やファイル名の時間に適用するタイムゾーン
     リトライ回数	送信失敗時のリトライ件数（1～10）
     タイムアウト（ミリ秒）	送信時のタイムアウト時間 (500～5000)
     最大メッセージサイズ(Byte)	１メッセージの最大サイズ（96KB固定）
     最大メッセージ送信回数	１回のイベントでの送信最大回数 (1～1000)
     MQTT QoS	Quality of Service

   • AWS

     入力項目	説明
     ホスト	接続先ホスト
     ポート	接続先ポート番号

   • Azure

     入力項目	説明
     接続文字列	接続用文字列

   • MQTT

     入力項目	説明
     ホスト	接続先ホスト
     ポート	接続先ポート番号
     ユーザー名	接続ユーザー（ブローカー設定により省略可）
     パスワード	接続パスワード（ブローカー設定により省略可）

   • File/FTP/FTPS/SFTP共通

     入力項目	説明
     タイムゾーン	メッセージ内のタイムスタンプ（文字列）やファイル名の時間に適用するタイムゾーン
     出力先ディレクトリ	ルートフォルダからの保存ディレクトリ
     切替基準	ファイル分割する単位（時間/件数）
     切替時間（件数）	切り替える時間/件数 （時間：1～3600、件数：1～10000）
     形式	CSV/JSON
     区切り文字	CSV形式時の区切り文字（カンマ/タブ）
     改行コード	CSV形式時の改行コード（LF/CRLF）
     BOMと付ける	CSV形式時のファイルBOM有無
     ヘッダを付ける	CSV形式時のヘッダ有無

   • FILE

     入力項目	説明
     保存期間（時間）	ディスク上に存在する期間

   • FTP/FTPS/SFTP共通

     入力項目	説明
     ホスト	接続先ホスト
     ポート	接続先ポート番号
     ユーザー名	接続ユーザー（匿名アクセス時は省略）
     パスワード	接続パスワード（匿名アクセス時は省略）

   • FTP/FTPS

     入力項目	説明
     暗号化	通信時のプロトコル（FTP/FTPS）
     匿名アクセス	匿名FTPの利用有無

   • SFTP

     入力項目	説明
     公開鍵認証を使う	通信時のプロトコル（SFTP）

   • Machine Advisor

     入力項目	説明
     サーバー	接続用サーバー
     トークン	接続用トークン

   • SensorCorpus

     入力項目	説明
     ホスト	接続用ホスト
     セッションコード	接続用セッションコード

   • カスタム

     入力項目	説明
     スクリプト名	Pythonカスタムエミッタのスクリプト名
     パラメータ	Pythonカスタムエミッタに渡す任意のパラメーター

1. 「保存」をクリックし設定を登録します。

   

2. 接続用の証明書ファイルを指定して「保存」をクリックします。

   

   出力タイプ	ファイル
   AWS	CA証明書
   	SSL証明書
   	秘密鍵
   MQTT	CA証明書
   SFTP	秘密鍵

3. 「Test」をクリックし接続テストを行います。

   

   

   各接続先の具体的な設定方法は、別紙「SpeeDBee Hive（エミッタ接続設定）」をご参照ください。

1.8.1.2 参照・更新・削除#

出力先設定を参照/更新します。

1. 対象の出力先をクリックし、設定を参照します。

   

2. 変更項目を入力後、「保存」をクリックし、設定を更新します。
   （設定内容は登録時と同じですが、タイプは変更できません）
   データを削除したい場合は、「削除」をクリックし、設定を削除します。
   
   

   

1.8.1.3 出力先設定の出力・取込#

前節で設定を行った出力先設定を、１つの出力先毎に１つのファイルとして出力することができます。また、そのファイルを取り込むことで新しい出力先設定を新規に登録することもできます。

1. 出力

   1. 対象となる出力先を選択し、「出力」をクリックします
   2. 表示されたダイアログで「含まない」もしくは「含む」を選択します

   3. 出力されたファイルはPCの「ダウンロード」フォルダにダウンロードされます

      

      

   ダイアログで「含む」を選択した場合、出力先情報におけるパスワードや秘密鍵なども１つのファイルにまとめて取り込まれます。これらの情報は流出するとセキュリティ上の問題となりますので、取り扱いには十分ご注意ください。

2. 取込

   1. 出力先行の をクリックします。

      

   2. 「取込」をクリックし、ファイル選択ダイアログで出力先の設定ファイルを選択します。

      

   3. 設定ファイルをもとに新しく出力先が新規作成されます。

   設定ファイルの出力時に、パスワードや秘密鍵などの情報を「含まない」を選択していた場合、その設定ファイルを取り込んだだけでは出力先を完全な状態で復元することはできません。出力先タイプに応じて、パスワードや接続情報、秘密鍵等の再設定を行ってください。

1.8.2 エミッタ設定#

エミッタの設定をします。

1.8.2.1 エミッタの登録#

1. 送信データの をクリックします。

   

2. 下記の項目を入力します。

   

   入力項目	説明
   エミッタ名	エミッタ表示名称
   クライアントID	エミッタ識別ID
   出力先	出力先で定義した内容を選択
   送信先	送信先名（TOPIC）（出力先により省略可）
   無効にする	エミッタを無効にする（設定のみ行う場合に利用）
   常時接続する	サーバー接続を送信の都度、切断しない

3. 送信間隔の項目を入力します。

   入力項目	説明
   送信タイミング	周期／リアルタイム／イベントを選択
   デフォルト小数桁数	データが浮動小数の場合の送信する桁数を設定 各データに小数桁数が指定していない場合のデフォルト値として利用する
   通算ナノ時間付で出力	データに通算ナノ秒を追加する
   起動後は前回送信したデータの続きからデータを出力	起動後は前回送信したデータの続きからデータを出力する

   ※送信タイミングが周期／イベントの場合、以下の値を追加で入力します。

   1. 周期

      入力項目	説明
      間隔（秒）	送信間隔

   2. イベント

      入力項目	説明
      開始イベント	送信開始イベント、イベントで定義した内容から選択
      終了イベント	送信終了イベント、イベントで定義した内容から選択 ※開始イベントと同じものは設定できません
      イベント前（秒）	イベント発生前の記録時間
      イベント後（秒）	イベント発生後の記録時間
      最大（秒）	最大記録時間 ※イベント前 + イベント後より小さい値は設定できません

   • 全体の記録時間は、下記の図を参照してください。

   • 開始イベントのみ指定
     
     

   • 開始、終了イベント指定
     
     

   • 全体の記録時間が最大記録時間を超過した場合、強制的に記録は終了します。

4. 送信データの項目を入力します。

   入力項目	説明
   一定間隔で集計したデータを送信する	指定された時間幅でデータを集計し、その各時間幅内の代表値を送信する。 通常は各時間幅で同じデータに複数の値がある場合、最新のデータが代表値となりますが、各データにて集約オプションを有効にした場合、その時間幅内で集約計算が行われ、その計算結果が送信されます。

5. 「一定間隔で集計したデータを送信する」をONにした場合、下記の項目を入力します。

   

   入力項目	説明
   集計間隔（秒）	集計する時間幅
   前回値を送信する	集計区間にデータが存在しない場合、一つ前の集計区間で送信した値を送信する
   nullを送信する	集計区間にデータが存在しない場合、nullを送信する

   • 集計区間に各データが存在しない場合の挙動

     前回値を送信	nullを送信	集計区間にデータが存在しない場合の送信データ
     ○	○	一つ前の集計区間で送信した値があればその値を再度送信します。なければnullを送信します。
     ○	✕	一つ前の集計区間で送信したデータがあればその値を再度送信します。なければそのデータは送信しません。
     ✕	○	nullを送信します。
     ✕	✕	そのデータは送信しません。

6. 「保存」をクリックし登録します。

   

1.8.2.2 エミッタの参照、更新、削除#

エミッタの設定を参照、更新、削除します。

1. 対象の出力先をクリックし、設定を参照します。

   

2. 変更項目を入力後、「保存」をクリックし、設定を更新します。
   データを削除したい場合は、「削除」をクリックし、設定を削除します。
   

   

1.8.2.3 データ定義の編集#

エミッタのデータ定義を編集します。
（エミッタ新規登録時は、保存しないと編集できません）

1. 「編集」をクリックします。

   

2. 新規

   1. 下記の項目を入力後、「新規」をクリックし設定を登録します。

      

      入力項目	説明
      コレクタ	コレクタ定義で設定した名称
      データ	コレクタ定義でデータ名称
      送信スキーマ名	データ名称（省略可）
      小数桁数	浮動小数時の有効桁数（省略可）
      基本統計	「分析データを送信する」時のみ設定する

      補足

      • 送信スキーマ名を省略した場合、データ名は”コレクタ名:レジスタ名” で送信されます。

      • リアルタイム分析を行っているレジスタの場合、レジスタ選択項目で。“レジスタ名:基本統計名称”で表示されます。
        （データに付与される基本統計名称）
        

        件数→count, 総和→sum, 2乗和→sumsq, 偏差平方和→sumsqd, 最小→min,  
        最大→max, 範囲→range, 算術平均値→mean, 分散→var, 標準偏差→stdev,  
        不偏分散→uvar, 標本不偏標準偏差→ustdev, 標準誤差→stder, 変動係数→cv
        

      • エミッタで基本統計分析を行うとデータ名（または送信スキーマ名）の末尾に”.基本統計名称”が付与されたデータ名として送信されます。

        設定例	内容
        １	PLC：A、レジスタ：B、エミッタで最大を選択した場合 → データ名称「A:B.max」
        ２	PLC：A、レジスタ：B（リアルタイム分析：最大）、エミッタで最小を選択 → データ名称「A:B:max.min」
        ３	PLC：A、レジスタ：B（リアルタイム分析：最大）、エミッタで別名：C、 エミッタで最小を選択 → データ名称「C.min」

3. 更新

   1. 変更対象のデータをクリックします。

   2. 項目を入力後、「更新」をクリックし設定を更新します。

      

4. 削除

   1. 削除対象のデータのチェックボックスをONにします。

   2. 「削除」をクリックし設定を削除します。

      

1.8.2.4 出力したファイルのダウンロード#

エミッタ出力されたcsvまたはjsonファイルをダウンロードします。

1. ファイルダウンロード欄の表示

   1. エミッタ出力されるファイルをダウンロードするために、タイプが「File(Local)」の出力先を設定します。

      

   2. 上記で作成した、タイプが「File(Local)」の出力先を選択して、エミッタを登録します。

      

   3. ファイルダウンロード欄が表示されます。

      

2. ファイルのダウンロード
   出力先ディレクトリのcsvファイル（またはjsonファイル）をzip形式でダウンロードします。
   

   1. 時間範囲を指定します。

      

   2. ダウンロードボタンをクリックし、zipファイルをダウンロードします。

      

      • zipファイルの名前は以下の形式となります。
        「<エミッタのクライアントID>_<年月><日>＜開始時間＞-<年月><日>＜終了時間＞.zip」
        
      • ※zipファイルの中に、①で指定した時間範囲に出力されたcsvファイル（またはjsonファイル）が、年月/時/分の階層でフォルダに格納されています。

3. 出力されるzipファイルのフォルダ構造の例
   時間範囲に「2021年4月18日6時-18時」を指定して、csvファイルをダウンロードした場合の、zipファイルのフォルダ構造を以下に示します。
   ※以下は、実際に出力したzipファイルを展開し、フォルダ構造をtreeコマンドで示したものです。()内はフォルダ名の説明です。
   ※また、本項目の説明は、jsonファイルをダウンロードした場合にも当てはまります。
   
   
   

   C:\CLIANT-A_2021041806-2021041818
   └─202104（年月）
       └─18（日）
           ├─06（時間）
           │  ├─56（分）
           │  │      client-a_20210418065605.csv
           │  │      client-a_20210418065625.csv
           │  │      client-a_20210418065645.csv
           │  │
           │  ├─57（分）
           │  │      client-a_20210418065705.csv
           │  │      client-a_20210418065725.csv
           │  │      client-a_20210418065745.csv
           │  │
           │  ├─58（分）
           │  │      client-a_20210418065805.csv
           │  │      client-a_20210418065825.csv
           │  │      client-a_20210418065845.csv
   ・・・
   

1.8.2.5 エミッタ（送信データ）設定の出力・取込#

前節で設定を行ったエミッタ（送信データ）設定を、１つのファイルとして出力することができます。また、そのファイルを取り込むことで新しいエミッタ（送信データ）設定を新規に登録することもできます。

1. 出力

   1. 対象となるエミッタ設定を選択して「出力」をクリックします。

      

   2. 表示されたダイアログで「含まない」もしくは「含む」を選択します。

      

   3. 出力されたファイルはPCの「ダウンロード」フォルダにダウンロードされます。

2. 取込

   1. 送信データ行の をクリックします。

      

   2. 「取込」をクリックし、ファイル選択ダイアログでエミッタ（送信データ）設定ファイルを選択します。

      

   3. 設定ファイルをもとに新しく出力先設定とエミッタ（送信データ）設定が新規作成されます。

設定ファイルの出力時に、パスワードや秘密鍵などの情報を「含まない」を選択していた場合、その設定ファイルを取り込んだだけでは出力先を完全な状態で復元することはできません。出力先タイプに応じて、パスワードや接続情報、秘密鍵等の再設定を行ってください。

1.9 グローバル変数機能#

1.9.1 機能概要#

グローバル変数機能は、頻繁に変化するデータをメモリ上の変数へ格納する機能です。この変数をSpeeDBee Hive の各種機能（数値変換、登録条件、トリガの条件式など）で利用できます。 これにより、システム稼働中の条件式閾値の更新や特定のデータ値による他データ登録のフィルタリングなどが可能となります。

1.9.1.1 構文#

グローバル変数には2種類の指定方法が存在します。 どちらも64個の変数を使用できます。永続化グローバル変数は、SpeeDBee Hiveを停止しても 次の起動時に最終値が参照できます。通常のグローバル変数は、SpeeDBee Hiveを停止すると値は失われます。

• $GVAR0 ～ $GVAR63（グローバル変数）

  GVAR（グローバル変数）はSpeeDBee Hiveを起動する毎に0で初期化されます。値の代入が行われるまで0のままとなります。

• $PVAR0 ～ $PVAR63（永続化グローバル変数）

  PVAR（永続化グローバル変数）はSpeeDBee Hiveを初めて起動する時に0で初期化されます。値の代入が行われると、次回起動時も値を保持します。

SpeeDBee Hiveの再起動時に、前回起動時に代入された値を使用したい場合は永続化グローバル変数を使用してください。

1. 代入方法

   GVAR0 := $VALUE
   

   PVAR15 := ($VALUE * 20)
   

   ※代入するグローバル変数の先頭には「$」は必要ありません。

   • 数値変換における代入時の注意点

     PVAR0 := $VALUE * 2
     

     上記のように代入を指定すると、登録される値は$VALUEに2を乗算した値となります。 登録される値が変化することに注意してください。 元の値を変えたくない場合、演算は参照側で行うことを推奨します。

   • 条件式における代入時の注意点

     GVAR0 := $VALUE
     

     条件式では、代入のみを指定することはできません。条件式内で、代入したい場合は 以下のように条件式としての指定が必要です。

     0 < (GVAR0 := $VALUE)
     

     この場合、$VALUEが0より大きい場合条件成立となります。GVAR0への代入は常に行われます。

2. 参照方法

   $GVAR0 < $VALUE
   

   $PVAR15 > ($VALUE + 20)
   

   ※参照するグローバル変数の先頭には「$」を付けます。

1.9.2 設定例#

グローバル変数の具体的な設定例を紹介します。

1.9.2.1 コレクタの登録値よりトリガの条件を稼働時にリアルタイムに変化させる例#

1. カスタムコレクタaのデータ1をグローバル変数GVAR0に代入

   1. カスタムコレクタで「hello.py」を使って「カスタムコレクタa」を登録

   2. 編集から「data1」の数値変換へ代入文を設定 （※この設定では、グローバル変数への代入とデータ登録を同時に処理します。）

2. グローバル変数GVAR0が偶数だった場合にOSコマンドを実行する

   1. トリガへ条件式を設定

   2. 登録した条件指定したイベントを設定

   3. 条件成立時のOSコマンドを設定（Windows版を使用）

      echo %HIVE_EVENT_COLDATA% >> C:\ProgramData\SALTYSTER\event.txt
      

      

   4. 処理結果

   SpeeDBee Hiveを起動すると、以下のように条件成立時の偶数値のみがテキストファイル（event.txt）へ出力されます。

   0
   4
   14
   28
   

1.9.2.2 コレクタの特定のデータの値により他のカラムへの登録を抑制する例#

1. PLCコレクタAのアドレスM100をグローバル変数PVAR10に代入

   1. 数値変換で代入文を設定

      PVAR10 := $VALUE
      

      

2. グローバル変数PVAR10が1だった場合に、PLCコレクタAのアドレスD100の値を登録する

   1. 登録条件で条件式を設定

      $PVAR10 = 1
      

      

3. グローバル変数PVAR10が1だった場合に、PLCコレクタAのアドレスD100の値を登録する

   1. 処理結果

   M100が0の場合は、D100の値が登録されません。

   M100が1の場合のみ、D100の値が登録されます。

   PLC側でレジスタの値を制御することで、SpeeDBee Hiveのデータ登録タイミングを制御できます。

1.10 補足#

1.10.1 制限事項#

1.10.1.1 エミッタの送信メッセージ書式#

エミッタは送信するデータをJSON形式に変換し、指定された送信先に送信します。送信するJSON書式には、「実データを送信する」と「分析データを送信する」の２種類があります。

1.10.1.2 実データを指定した場合#

各データにおいてタイムスタンプが異なるため、レジスタの値＋タイムスタンプ（ISO8601書式の文字列）を一つのデータセットとして構成して、records配列に格納し送信します。

{
  "records": [
    {
      "timestamp": "2020-10-06T11:22:50.178616824Z"
      "PLC1:REG1": 1409
    },
    {
      "timestamp": "2020-10-06T11:22:50.178616824Z"
      "PLC1:REG2": 200
    },
    （省略）
  ]
}

1.10.1.3 分析データを指定した場合#

複数のデータに対し、指定された時間幅で代表値を決定し、一つのタイムスタンプの複数のレジスタ値を格納する。（統計値などを含める事も可能）

{
  "records": [
    {
      "datetime": "2020-10-06T11:22:50.178616824Z",
      "PLC1:REG1": 1409,
      "PLC1:REG2": 20.1,
      "PLC2:REG1.max": 100
    },
    （省略）
  ]
}

1.10.2 各メーカー（プロトコル）別の注意事項#

各PLC本体のTCP/IP設定は、各メーカーが提供するマニュアルをご参照ください。

1.10.2.1 三菱シーケンサー（MCプロトコル）#

• A互換１EフレームとQnA互換３Eフレームをサポートします。
• ワードレジスタは".0~f"でビット指定可能です。
• 下記のレジスタを指定する事ができます。（シリーズにより異なる事があります）
• 機種によって、アドレスの範囲は下表と異なる場合があります。

** 【QnA互換3Eフレーム】 **

** 【QnA互換1Eフレーム】 **

1.10.2.2 TOYOPUC（コンピュータリンク）#

• 短いサイクルで接続/切断を行うとレスポンスが取得できない事があります。そのため、PLC接続は常時接続のみとなります。
• ワードレジスタは".0~f"でビット指定可能です。
• プログラム番号（1～3、共通）を指定可能です。（現在、Plus/PC10G/PC3Jのみ可能）
• 下記のレジスタを指定する事ができます。

【Nano】

【PC3J】

【Plus】

【PC10G】

1.10.2.3 OMRON（fins）#

• CS/CJ/CP/NSJシリーズに対応しています。
• チャンネルI/Oは、アドレスのプレフィックスとして"CIO"を付加指定可能です。
• 拡張データメモリの有無は、シリーズおよびマシンごとに異なります。
• 下記のレジスタを指定する事ができます。

1.10.2.4 キーエンス（上位リンク）#

• KV-8000/7500/7300シリーズに対応しています。他シリーズもアドレス範囲は異なりますが、上位リンクが利用可能であれば接続できます。
• ワードレジスタは".0~f"でビット指定可能です。
• 下記のレジスタを指定する事ができます。（シリーズにより異なります）

1.10.2.5 Modbus RTU/TCP#

• データ種類により、レジスタのデータ型が決定します。
  • コイル／入力ステータス　 →　ビット
  • 保持レジスタ／入力レジスタ　 →　ワード
• 指定できるアドレス範囲は下記の通りです。
  0x0000～0xFFFF（データ種類関係なし）
  

1.10.2.6 Panasonic MEWTOCOL#

• FP7に対応しています。
• 現時点で対応しているのはMEWTOCOL-COMのみです。MEWTOCOL7-COM, MEWTOCOL-DATには対応していません。
• 下記のデバイスからデータを取得可能です。機種やメモリ選択パターンにより取得可能範囲は異なります。
• 取得単位がBITのものは、型としてBOOLのみ指定可能です。

1.10.3 リアルタイム分析について#

リアルタイム分析を選択すると「基本統計、移動平均値、FFT」の3種類が設定可能です。

リアルタイム分析に☑を入れ、横にある「基本統計、移動平均値、FFT」をクリックすると設定画面が表示されます。

リアルタイム分析に☑を入れ、横にある「基本統計、移動平均値、FFT」をクリックすると設定画面が表示されます。

1.10.3.1 基本統計#

1. 以下の項目を入力します。

   

   項目	説明
   分析幅	分析の幅を設定
   分析単位	分析幅の単位を設定（件数 or 秒）

2. 利用する基本統計種別と永続化の有無を選択します。

1.10.3.2 移動平均値#

1. 以下の項目を入力します。

   

   項目	説明
   移動平均値	移動平均値を取る期間（短期、中期、長期のデータ数）を設定（最大3つまで指定可能） ※左から小さい順に並べてください
   指数加重移動平均値の平準化定数α	指数加重移動平均値の平準化定数αを設定 0 < α < 1の範囲を小数で指定 デフォルト値：「2 /(2 + 1)」

2. 利用する分析、永続化の有無を選択します。

1.10.3.3 FFT解析#

1. 以下の項目を入力します。

   

   項目	説明
   FFT解析を行う	FFT解析を実行の有無
   永続化する	ストレージ上に保存する
   件数	FFTウィンドウの件数
   サンプルレート	FFTサンプルレート（入力不可）
   ウィンドウ関数	使用する窓関数を設定
   標準化する	標準化の有無

1.10.3.4 ニーモニックファイル出力方法#

• キーエンス
  【KV STUDIO ユーザーズマニュアル】を参照してください。
  『参照ページ』
  「4章　ファイル・印刷」→
  「4-1 ファイルの各機能について」→
  「ニモニックリスト保存」に出力方法が記載されています。
  手順に従い、MNMファイルを出力してください。
  

• OMRON
  【CX-Programmer オペレーションマニュアル 】を参照してください。
  『参照ページ』
  「第5章　プログラムの再利用」→
  「5-2 再利用ファイルの保存/読み出し」に出力方法が記載されています。
  手順に従い、CXRファイルを出力してください。
  

• 三菱
  【三菱 GX Works】では以下の手順を参考にファイルを作成してください。
  

  1. GX Worksからプロジェクトを開く
     
  2. 画面右側のラダー部を右クリック→メニューに表示されたクロスリファレンスをクリック
     
  3. 画面下部のクロスリファレンス部で、すべてのデバイス/ラベルを選んで検索をクリック
     
  4. 下部の表形式部へ内容が表示されるので、表形式部の左上クリックで全範囲指定→右クリック→コピーをクリック
     
  5. テキストエディタ、またはExcelへペーストしてCSVファイルとして保存