E.1 File format definition
This section provides a file format definition for the valve signature files. It includes a file naming convention:
Filname:
‘Date_Time_ValveTagId’, where Date-Format: yyyyMMdd and Time-Format: HHmmss.
Time in filename is only to be used for file handling purposes. Accurate Valve-Signature time-stamp is given in TriggerTime variable.
Variables:
| BrowsePath | A browse path that uniquely identifies the valve in signature file (without namespace). | Mandatory |
| TagId | TagId of the Valve | Optional |
| Description | Valve description. | Mandatory |
| Command | "open", "close", "partial-stroke" | Mandatory |
| TriggerTime | Timestamp for signature, SEM time when valve movement started. the string should be in this format "1510835812.330" | Optional |
| Instrument | Instrument data start. | |
| InstrumentId | TagId or BrowseName for instrument. | Mandatory |
| InstrumentDescription | Description. | Mandatory |
| EUrangeHigh | High range for plot, may be different from actual instrument range. (example: for flow transmitter EUrangeHigh should correspond to valve volume not flow instrument max range) | Optional |
| EUrangeLow | Low range for plot, may be different from actual sensor range. | Optional |
| EngineeringUnits | Instrument Engineering unit, same unit as EngineeringUnits under ProcessVariable. | Mandatory |
| Samples | Sample values. | |
| Time | SEM time for sample. In OPC UA DateTime (see OPC 10000-5 section 5.2.2.5 DateTime)) the string should be in this format "1510835812.330" | Mandatory |
| Value | Instrument sample value. | Mandatory |
| Fault | Sensor fault. | Optional |
Additional comments:
First instrument sample value may be earlier in time than TriggerTime, dependent on subsea vendor SEM configuration, to include a pre-operation sample in the plot.
The normative definition of the JSON schema is available in the file found here:
For the latest version:
https://reference.opcfoundation.org/files/Profile-Schema.json?u=http://opcfoundation.org/UA/MDIS