[Pro-face] セキュリティー対策、System Monitorユーザーマニュアル、System Monitor APIリファレンス、16DI/8DO APIリファレンス

本ガイドで言及されているPro-faceブランドならびにシュナイダーエレクトリックSEおよびその子会社の商標は、シュナイダーエレクトリックSEまたはその子会社の所有物です。その他すべてのブランドは、各所有者の商標である場合があります。本ガイドおよびその記載内容は、該当する著作権法で保護されており、情報提供のみを目的とし作成されています。本ガイドのいかなる部分も、いかなる形式や手段（電子的、機械的、複写、記録、またはその他）によっても、どのような目的であっても、シュナイダーエレクトリックから書面による事前の許可を得ずに、再製または頒布することはできません。
シュナイダーエレクトリックは、「現状のまま」本ガイドを調べる非独占な個人ライセンスを除き、本ガイドまたはその記載内容を商業的に使用する権利またはライセンスを付与することはありません。
シュナイダーエレクトリックの製品および設備の設置、運転、メンテナンス、管理は必ず、適格な担当者が行ってください。 規格、仕様、および設計は随時変更されるため、本ガイドに記載されている情報は予告なく変更されることがあります。 適用法により認められる範囲で、シュナイダーエレクトリックおよびその子会社は、本資料の情報コンテンツの誤りや記入漏れまたは本資料に含まれる情報の使用に起因する結果、もしくはその結果から生じる結果に関し、一切責任を負いません。

本ドキュメントでは、PS6000シリーズ（以下本製品）をお使いいただくための

• セキュリティー対策
• System Monitor Sample Dashboard（以下System Monitor）の使用方法
• 本製品専用Node
• System Monitor API
• System Monitor FAQ
• 16DI/8DO API

についての情報を記載しています。

• 2024/03  Windows Security Virus & threat protection updateの有効化方法, ERROR LED API追加
• 2021/08  System Monitor API, 16DI/8DO API追加

• 本製品をネットワーク環境で使用される場合、構築するネットワーク自体をセキュアな状態にしてください。
  （Firewall機器等ネットワークセキュリティー機器の設置等）
  詳細については設備のネットワーク管理者へご相談ください。

• Windows Automatic Updateは出荷時にはポリシー設定によってDisableに設定されています。 自動更新が必要な場合には設定を変更してください。
  Windows Automatic Updateの有効化方法
• Write Filterを使用する場合にはWrite FilterをDisableにした状態でアップデートを行ってください。
• 本製品設置後も、定期的に「マイクロソフト更新プログラムの認定」ページを確認して、記載の認定済みセキュリティーアップデート（QFE）を適用し、OSを最新の状態に維持してください。
• セキュリティーアップデートを定期的に適用できない使用環境の場合には、オプションのTrellixライセンスをご購入いただき、許可リスト方式のセキュリティー対策の実施をお勧めします。

• 通常の使用時には、アカウントの種類（Account type）をStandard Userとして作成したユーザーを使用してください。
  アカウントの種類がAdministratorのユーザーはシステムの設定変更が必要な場合のみ使用してください。
  Standard Userのユーザーアカウント作成

• Node-REDの環境設定ファイルは、各ユーザーアカウントに保持されます。設定変更の場合は、各ユーザーアカウントへ 更新やコピーが必要となります。

• デフォルトのユーザー名は「admin」、パスワードは「Pw#12345」
• Node-REDのユーザー名、パスワードは初回ログイン後必ず変更してください。パスワードは強力なパスワードに設定してください。ユーザー名、パスワードの変更方法はこちらのページを参照してください。
• ログイン情報（トークン）の有効期限はデフォルトで7日となっています。 フローエディターにログインしログアウトしないままエディターを閉じるとログイン状態が7日間保持されますので、エディター画面を終了する場合にはログアウトを行ってください。
• ログイン情報（トークン）の有効期限の変更方法も上記URLに記載されています。

• Node-REDはデフォルトでTCPポート1880を使用します。他のアプリケーションで使用している場合には、他のポート番号を使用してください。
• もしNode-REDのポート番号を変更する必要が有る場合にはこちらのページを参照してください。

• 下記URLに記載のとおり、起動時にWindowsサービスとしてNode.js、Node-REDを自動起動する設定を行った場合、ログインしなくてもフローを動作させることが可能です。ただし、サービスをシステムアカウントで起動するとフローによって全ての操作（OSの設定変更など）が可能となってしまいます。システムのセキュリティーリスクを上げてしまう可能性があることを考慮の上、設定してください。
  https://nodered.jp/docs/faq/starting-node-red-on-boot
• 本製品のプリインストールOSではセキュリティーを高めるため、Node.js、Node-REDはログインしたユーザーアカウントで起動する設定となっています。

• Node-REDを構成するファイルは％USERPROFILE% フォルダー以下に保存されています。Standard Userのユーザーアカウントを使用していても自由に編集や削除することが可能です。下記手順でNode-REDの構成ファイルのアクセス権限を変更することによって、システムの安全性を高めることが可能です。
  ファイルアクセス権の設定

1. スタートボタンを右クリックし、Runを選択します。
   
2. "gpedit.msc"と入力し[OK]をクリックします。
   
3. “Computer Configuration\Administrative Templates\Windows Components\Windows Update\Configure Automatic Update”を開きます。
   
    
   
4. 設定を[Disable]から[Enable]に変更し、使用環境に応じて[Options]を設定してください。
   

1. スタートボタンを右クリックし、Runを選択します。
   
2. "gpedit.msc"と入力し[OK]をクリックします。
   
3. “Computer Configuration\Administrative Templates\Windows Components\Microsoft Defender Antivirus\Security Intelligence Updates\Define the order of sources for downloading security intelligence updates”を開きます。
   
    
   
4. 設定を[Enabled]から[Not Configured]に変更します。
   
5. “Computer Configuration\Administrative Templates\Windows Components\Microsoft Defender Antivirus\Security Intelligence Updates\Define the file shares for downloading security intelligence updates”を開きます。
   
6. 設定を[Enabled]から[Not Configured]に変更します。
   

1. Settings -> Accounts を開きます。
   
2. Family & other users - Add someone else to this PC をクリックしユーザー名（ここでは”StandardUser0”とします）、パスワードを設定します。
   
3. StandardUser0 が作成されました。
   
4. 作成した StandardUser0 アカウントで Sign in する事によってユーザーの環境ファイル一式（%USERPROFILE%）を作成します。
   Start -> Sign out をクリックします。
   
5. サインイン画面でユーザー名を選択し Sign in します。
   
6. デスクトップが表示されたら、Launcher アイコンをダブルクリックします。
   
7. Launcher から System Monitor を選択します。
   
8. Dashboard が表示されます。
   
9. Start -> Sign out を選択します。
   
10. 元の Administrator アカウントのユーザーで Sign in します。
    

以上で新規の Standard User 権限のユーザーアカウントが作成されました。

• Windows 10 64bit (ビルドバージョン 1809 以上)
  The Watchdog Timer (WDT) function requires the following two conditions to be met
  OS: Pre-installed OS version 2.0 or higher, or OS with the latest Dedicated Utility installed
  BIOS: version WAR02 or higher

• Microsoft Visual Studio 2017 (C++)

• System Monitor API ダウンロードページ

• C:\Windows\System32\SysMonApi.dll
• C:\Windows\SysWOW64\SysMonApi32.dll
• C:\Windows\System32\RasApi.dll

Note: DLL files are installed by a dedicated_utility_for_ps6000_series. If you need the DLL to install in your development environment, please contact your local distributer.

• SysMonApi.h
• RAS_MappedFile.h (included from SysMonApi.h)
• RAS_API_PFXPHMIP6.h (for WDT functions)

• SysMonApi.lib ( for x64 application )
• SysMonApi32.lib ( for x86 application )
• RasApi.lib ( for WDT functions, for 64bit application )

• SysMonGetLibVersion()
  SYSMON_API BOOL WINAPI SysMonGetLibVersion ( char * pchStr )
  API function for get RAS library version from sysmonsrv.
  Parameters
       pchStr : Pointer to buffer address for store data.
  Returns
       TRUE : Success.
       FALSE : Error.
• SysMonGetCurrentValue()
  SYSMON_API BOOL WINAPI SysMonGetCurrentValue ( int iSelector, int * piValue )
  API function for get current values.
  Parameters
       iSelector : Type of sensor etc. (RDI_XXX_)
       piValue : Pointer to buffer address for store data.
  Returns
       TRUE : Success.
       FALSE : Error.
• SysMonGetLogValue()
  SYSMON_API BOOL WINAPI SysMonGetLogValue ( int iSelector, int * piValue, struct tm * pstTime )
  API function for get log values.
  Parameters
       iSelector : Type of sensor. (RDI_TEMP_xx_MIN_, RDI_TEMP_xx_MAX_).
       piValue : Pointer to buffer address for store data.
       pstTime : Pointer to buffer address for log time.
  Returns
       TRUE : Success.
       FALSE : Error.
• SysMonGetWarningFlag()
  SYSMON_API BOOL WINAPI SysMonGetWarningFlag ( int iSelector, int * plFlag )
  API function for get warning flag.
  Parameters
       iSelector : Type of sensor. (RDI_XXX_).
       piFlag : Pointer to buffer address for store data. RAS_WARNING_ or RAS_NOT_WARNING_
  Returns
       TRUE : Success.
       FALSE : Error.
• SysMonGetIsWarning()
  SYSMON_API BOOL WINAPI SysMonGetIsWarning ( int * piFlag )
  API function to determine whether the warning flag is valid.
  Parameters
       piFlag : Pointer to buffer address for store data. RAS_WARNING_ or RAS_NOT_WARNING_
  Returns
       TRUE : Success.
       FALSE : Error.
• SysMonGetSensorName()
  SYSMON_API BOOL WINAPI SysMonGetSensorName ( int iSelector, PTCHAR ptcStr )
  API function for get Sensor name from sysmonsrv.
  Parameters
       iSelector : Type of sensor. (RDI_XXX_).
       ptcStr : Pointer to buffer address for store data.
  Returns
       TRUE : Success.
       FALSE : Error.
• RAS_SetWDTCounter()
  DLL_API BOOL RAS_SetWDTCounter ( int iValue )
  Set WDT counter values.
  Parameters
       iValue : Counter value (1 - 65535 sec).
  Returns
       TRUE : Success.
       FALSE : Error.
• RAS_StopWDTCounter()
  DLL_APIBOOLRAS_StopWDTCounter(void)
  Stop WDT counter countdown.
  Parameters
       void:
  Returns
       TRUE : Success.
       FALSE : Error.
• RAS_GetWDTStatus()
  DLL_APIBOOLRAS_GetWDTStatus(int*iState)
  Get WDT status.
  Parameters
       iState:Pointertoreturnstatus.
  Returns
       TRUE : Success.
       FALSE : Error.
• RAS_ClrWDTTimeoutStatus()
  DLL_APIBOOLRAS_ClrWDTTimeoutStatus(void)
  Clear WDT timeout status.
  Parameters
       void:
  Returns
       TRUE : Success.
       FALSE : Error.
• RAS_SetWDTResetMask()
  DLL_APIBOOLRAS_SetWDTResetMask(intiMask)
  Set WDT reset mask.
  Parameters
       iMask:WDT_HWRESET_DISABLEorWDT_HWRESET_ENABLE
  Returns
       TRUE : Success.
       FALSE : Error.
• RAS_GetWDTResetMask()
  DLL_APIBOOLRAS_GetWDTResetMask(int*iMask)
  Get WDT reset mask.
  Parameters
       iMask:Pointertoreturnvalue.
  Returns
       TRUE : Success.
       FALSE : Error.

• LauncherからSystem Monitorを初回起動する時にFirewallの設定で「Node.js Server-side JavaScript」の通信を有効にする必要があ ります。
  
  外部のPC上のブラウザープリケーションで本製品 のIPアドレスへアクセスします。
  例) https://ipaddress:1880/ui
• 外部PCからリモート接続するためには本製品でNode.js、Node-REDが実行状態である必要があります。

• Windowsの時計設定を確認してください。
  Timezoneと時計情報が正しく設定されている必要があります。本製品 のプリインストールOSのTimezoneはデフォルトでUTCに設定されています。ご使用になる地域に合わせて変更したうえで、必ず正しい現地時間に設定してください。

• PS6000 Basic Model

• Windows 10 64bit (ビルドバージョン 21H2 以上)

• Microsoft Visual Studio 2017 (C++)

• System Monitor API ダウンロードページ

• ErrorLedApi.dll
• VSensorApi.dll

• ErrorLedApi.h

• ErrorLedApi.lib ( for x64 application )

• GetErrorLed()
  ERRORLED_API DWORD WINAPI GetErrorLed (LPINT piStatus)
  API function for get Error LED status.
  Parameters
       piStatus : Pointer to buffer address (ERROR_LED_ON/ERROR_LED_OFF).
  Returns
       ERROR_SUCCESS : Success.
       ERROR_NOT_SUPPORTED : Not Basic model.
       Other : Error (Win32 error code).
• SetErrorLed()
  ERRORLED_API DWORD WINAPI SetErrorLed (INT iStatus)
  API function for set Error LED status.
  Parameters
       iStatus : LED status (ERROR_LED_STATUS_ON/ERROR_LED_STATUS_OFF).
  Returns
       ERROR_SUCCESS : Success.
       ERROR_NOT_SUPPORTED : Not Basic model.
       Other : Error (Win32 error code).

• 16DI/8DO Optional interface (PFXYP6MPX16Y8)

• Windows 10 64bit (Build version is 1809 or more.)

• Microsoft Visual Studio 2017 (C++ / C# / VB)
• Microsoft .NET Framework 4.8 (C# / VB)

• 16DI/8DO API サンプルコード

• For C# and VB environment
  Please refer to PFXPHMIP6_DIDO_SampleCode folder.
     PFXPHMIP6_DIDO_SampleCode.sln
     PFXPHMIP6_DIDO_SampleCode_CS.csproj   Sample Code for C#
     PFXPHMIP6_DIDO_SampleCode_VB.vbproj   Sample Code for Visual Basic

• DIDO_PFXPHMIP6.dll For 64bit application.
• DIDO_PFXPHMIP6_32.dll For 32bit application.

• For C++ environment
  DIDO_PFXPHMIP6.h

• DIDO_PFXPHMIP6.lib   For 64bit application.
• DIDO_PFXPHMIP6_32.lib   For 32bit applcation.

• OpenDido()
  HANDLE OpenDido(void)
       Open DIDO function.
  Parameters
       void :
  Returns
       HANDLE : Handle of DIDO device.
• CloseDido()
  void CloseDido(HANDLE hComHandle)
       DIDO Close function.
  Parameters
       HANDLE : Handle of DIDO device.
  Returns
       void:
• GetFwVersion()
  int GetFwVersion(HANDLE hHandle, PTCHAR ptcBl, PTCHAR ptcApp)
       DIDO GetFwVersion function.
  Parameters
       HANDLE : Handle of DIDO device.
       PTCHAR : Pointer to get version of the Bootloader.
       PTCHAR : Pointer to get version of the Bootloader.
  Returns
       int : Error code. SERI_ERROR_xxx_
• SetDout()
  int SetDout(HANDLE hHandle, BYTE byData)
       DIDO set dout port function.
  Parameters
       HANDLE : Handle of DIDO device.
       BYTE : Dout data.
  Returns
       int : Error code. SERI_ERROR_xxx_
• SetDoutDefault()
  int SetDoutDefault(HANDLE hHandle, BYTE byData)
       DIDO set dout port default value function.
  Parameters
       HANDLE : Handle of DIDO device.
       BYTE : Dout data.
  Returns
       int : Error code. SERI_ERROR_xxx_
• GetDout()
  int GetDout(HANDLE hHandle, PBYTE pbyData)
       DIDO get dout port function.
  Parameters
       HANDLE : Handle of DIDO device.
       PBYTE : Potinter to get Dout data.
  Returns
       int : Error code. SERI_ERROR_xxx_
• GetDin()
  int GetDin(HANDLE hHandle, PWORD pwData)
       DIDO get din port function.
  Parameters
       HANDLE : Handle of DIDO device.
       PWORD : Potinter to get Din data.
  Returns
       int : Error code. SERI_ERROR_xxx_
• GetCounter()
  int GetCounter(HANDLE hHandle, int iCounterId, PDWORD pdwData)
       DIDO get counter value function.
  Parameters
       HANDLE : Handle of DIDO device.
       int : ID of counter. DIDO_COUNTER0_ or DIDO_COUNTER1_
       PDWORD : Pointer to get counter value.
  Returns
       int : Error code. SERI_ERROR_xxx_
• SetCounter()
  int SetCounter(HANDLE hHandle, int iCounterId, int iControl)
       DIDO counter contrl function.
  Parameters
       HANDLE : Handle of DIDO device.
       int : ID of counter. DIDO_COUNTER0_ or DIDO_COUNTER1_
       int : Control code. DIDO_COUNTER_xxx_
  Returns
       int : Error code. SERI_ERROR_xxx_