TIC 4.0
TIC4.0 Semantic
Translate reality in figures is not easy. Bottom to top approach requires being able to aggregate or consolidate the information that comes from data. The transversal approach (process driving) requires defining where, when, what and who very precisely. Top to bottom approach requires to be human-friendly base on concepts (ideas). In any case, the exchange of information should be defined as technology-independent to allow competition and the improvement of the technology in the future.
The most restrictive requirement comes from the need to define from whom, who, what, where, when and how much the reality is or does. To comply with these requirements TIC 4.0 propose a semantic base on the human one.
GRAMMAR:
The semantic combines 6 basic elements: HEADER, SUBJECT, CONCEPT, OBSERVED PROPERTY, POINT OF MEASUREMENT and VALUE to represent a unique reality.
HEADER identifies the message in origin, (destination), time of reference for the message and unique reference.
SUBJECT (who) is the entity that is doing or being the CONCEPT.
CONCEPT (what is-does) refers always to a particular subject (or subject-subsystem) specifying what the subject is (status) or does (action-event)
OBSERVED PROPERTY (how much) is the magnitude of the concept (status, pieces, length, volume, time, speed, power, duration, acceleration…) represented in the value.
POINT OF MEASUREMENT (where) defines where in place and time (past, present, future) the value representing the concept observed property of the subject is measured and represented.
VALUE is the actual measured result for a specific combination of time of measurement + subject+ concept + observed property + point of measurement. Same value can be represented in several units.
The combination of a SUBJECT with multiple combinations of CONCEPTs, OBSERVED PROPERTies and POINT OF MEASUREMENTs give us a unique meaning of a VALUE.
TIC 4.0 aims to define each of these elements.
HEADER
HEADER identifies the message with the origin, (destination), time and unique reference.
1 HEADER could contain as many SUBJECTs as necessary (with multiple CONCEPTs, subSUBJECTs, OBSERVED PROPERTies, POINT OF MEASUREMENTs, and VALUEs). (99.9% cases will be only 1 message per subject).
Mandatory
Header message identifier: (id) Unique identifier reference for any message. Default format: (GUID generator → 128bit number combined by e.g. MAC, time and random number) + sender as URL/IP (Format could be by JSON Schema).
Header sender identifier: (sender) Unique device identification that publishes the data. (Typically is the Subject id).
Header message timestamp: (timestamp) Number code that defines the time when a message was generated (timestamp of the message creation); Format: ISO8601; Example: 2020-06-04T09:37:08.000Z
Optional:
Header topic: (topic) Subject to publish-subscribe the information to be used for publishing – subscribing technology (broker).
Header destination identifier: (destination) Unique device identification that message is target to.
Header Content Creation Time: (creation_timestamp) is the time that corresponds to the content of the value in the message. This is necessary when the message is not built at the same time that the content data.
Header Time Start-End: (start_timestamp; end_timestamp) is the start and end time of the frame time that corresponds to the content of the value in the message (for aggregated values as average, max, counter etc).
Protocol: what protocol is written the message
Version: Version of the TIC 4.0 Data model
A message could contains 1 header, unlimited subjects, compatible sub-subjects, list of compatible concepts per subject, list of observed properties per concepts, list of compatible points of application and units per observed property.
Example:
JSON header example
{
"msg": {
"id": "",
"sender": "",
"timestamp": "2021-04-16T14:04:35.470Z",
"topic": "",
"destinantion": "",
"creation_timestamp": "2021-04-16T14:04:35.470Z",
"start_timestamp": "2021-04-16T14:04:35.470Z",
"end_timestamp": "2021-04-16T14:04:35.470Z",
"protocol": "JSON",
"version": "2021.1"
}
}SUBJECT:
SUBJECT identifies and defines the perimeter of the element that is executing or being something defined in the CONCEPT. The subject can be broken down into hierarchical pieces (sub-subject = sub-systems).
Any SUBJECT belongs to another SUBJECT so all of them are subSUBJECT of someone and usually every SUBJECT usually has subSUBJECT
ie: Terminal->RS->Spreader
The SUBJECT and subSUBJECT hierarchy is defined within the context of the message defined by the HEADER
ie:
Message from RS: RS = SUBJECT = ; Spreader = subSUBJECT ; flipper = subSUBJECT
RS; RS.Spreader; RS.Spreader.flipper
The VALUE refers always to the SUBJECT, this means that the VALUE of the subSUBJECT does not have to match with the VALUE of the subject.
Example: messages sent at the “same time”
Message 1: {subject.id: XXXXX; subject.type: CHE; CHE.type: RTG; powersource.id : AAAA; che.powersource.on.totaltimer.hours : 15.254; }
The engine is replaced.
Message 2: {subject.id: XXXXX; subject.type: CHE; CHE.type: RTG; powersource.id : BBBB; che.powersource.on.totaltimer.hours : 15.255; }
Message 3: {subject.id: AAAA; subject.type: powersource; powersource.on.totaltimer.hours: 15.254}
Message 4: {subject.id: BBBB; subject.type: powersource; powersource.on.totaltimer.hours: 387}
In message 1 and 2 CHE.powersource.on.totaltimer.hours refers to the number of hours done by any engine installed in the CHE
In message 3 and 4, powersource.on.totaltimer.hours refers to the engine itself, because the subject id corresponds to the engine itself = power unit.
Mandatory attributes
Identifier (id): Unique device identification of the data subject. This id has to be unique not only for one specific data pool (DB, terminal group, manufacturer) but also at a global level. A Combination of Manufacturer name + manufacturer id (typically a serial number).
Name: (name) A common name for the subject, human-readable. MT_MFT_RTG_003. don't need to be unique but we suggest to use a combination of (UN location code) + (terminal code) + subject type + (number)
examples: MT_MFT_RTG_003 ; DEHAM_CTH_VC_025; MT_MFT_TZ_STS-SC; ES_VLC_APMT_TOS ; MT_MFT_TT_225
Type:
It is a “tag” for filtering or facilitating the description of the subject (sub-subject or device group). Several tags could be applied in one message for the same object if the tags are compatible.
Terminal
Container
Bulk
Ro-Ro
BERTH
Deepsea
Barged
Bollard
Yard
Reefer
Full
Empty
Electrified
Rail
TZ
GATE
CHE
STS
RTG
TT
ECH
RS
SC
MC
RMG
ASC
VESSEL
Mainliner
Feeder
Lightpole
Lighting
Communication
CCTV
IT
TOS
GOS (Gate operating system)
MMS
ERP
….
Powersource
genset
IC_engine
fuelcell
cablereel
busbar
Control
plc
controler
tool (to be defined)
Optional attributes
Number (number): The numerical running number of the subject at the local level. Normally the machine or device number part of the name (not of the unique id). It is not unique. Type of data: integer
Family (family): a group of identical equipment-devices with the same specs features and software (useful at equipment-hardware level).
Model (model): a group of similar equipment-devices of the same type, with the same features but different details specifications and software-firmware version.
Brand (brand): the manufacturer brand.
Source: related to the energy origin that use the subject. Valid for powersource or tank. Enumarator {electric, H2, fuel, gas, hydraulic}
softwareid: indicates the software/firmware version that runs the subject
SubSUBJECT
SubSUBJECT defines a main component of the SUBJECT about the CONCEPT is related (specifying what the subSUBJECT is or does).
SubSUBJECT List:
control
health
powersource
deftank
energytank
drive
axe
wheel
tyre
motor
brake
spreader
twislock
hoist
trolley
boom
firefighting
cabin
seatoperator
Drivers
wharf
yard
gate
rail
planning
execution
…. (to be extended)
Subject - sub-system matrix compatibility list:
SUBJECT / sub-system | CHE | TOS | MMS | IT | TERMINAL | … | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Subject Type | STS | RTG | SC | RS | ECH | TT |
|
|
| Sea | Dry | Rail |
|
Control | Yes | Yes | Yes | Yes | Yes | Yes | No | Opt. | No | No | No | No |
|
Spreader | Yes | Yes | Yes | Yes | Yes | Opt. | No | Opt. | No | No | No | No |
|
Trolley | Yes | Yes | No | No | No | No | No | Opt. | No | No | No | No |
|
drive | Yes | Yes | Yes | Yes | Yes | Yes | No | Opt. | No | No | No | No |
|
Drivers | Yes | Yes | Opt. | Opt. | No | Opt. | No | Opt. | No | No | No | No |
|
Boom | Yes | No | No | Yes | Yes | No | No | Opt. | No | No | No | No |
|
powersource | Opt. | Opt. | Yes | Yes | Yes | Yes | No | Opt. | No | No | No | No |
|
Wharf | No | No | No | No | No | No | Opt. | No | Opt. | Yes | No | No |
|
Yard | No | No | No | No | No | No | Opt. | No | Opt. | Yes | Yes | Yes |
|
Gate | No | No | No | No | No | No | Opt. | Opt. | Opt. | Yes | Yes | Yes |
|
Rail | No | No | No | No | No | No | |||||||
© Copyright - TIC 4.0 All rights reserved | Design web by Fundación Valenciaport