PPMP
General
The Production Performance Management Protocol (PPMP) is an IT protocol developed by Bosch for Industry 4.0 for communication between machines.
Technically, the data is sent as a JSON payload via REST, AMQP, MQTT or other methods. You can use http or https for this. Communication via PPMP is unidirectional and always goes from the machine to a recipient. The recipient is the client and, in the simplest case, provides a REST API.
PPMP is available in the forms "Machine Message", "Measurement Message" and "Process Message" with differently defined structures. The protocol is promoted by The Eclipse IoT Working Group and is licensed as open source and free for everyone to use.
Endpoint
The URI of the Information Router endpoint is built as in the following pattern:
https://{serverUrl}:{port}/connectivity/messaging/{apiVersion}/{tenantId}/{messageFormat}/{messageVersion}{messageType}
The table bellow explains the components of the URI pattern.
| Component | Meaning | Supported Values | Example |
|---|---|---|---|
serverUrl |
The fully qualified name or IP address where the Information Router service is running. |
10.20.30.40 |
|
port |
The port on which the service is running |
443 |
|
apiVersion |
The version of the Information Router machine API. |
Current version: v1 |
v1 |
tenantId |
The unique identifier of the tenant to which the machine is assigned to. |
7311ea8c-5d48-43fe-acf9-980eedf24b6c |
|
messageFormat |
The format of the message that the machine sends to the Information Router service. |
Currently supported: |
ppmp |
messageVersion |
The version of the Ppmp payload. This part of the URL is optional and defaults to v3 when omitted. |
v2 |
v3 |
messageType |
The type of the message payload that the machine sends to the Information Router service. |
For the ppmp message format, the available message types are: |
process |
Example URI’s are:
-
https://serverurl.com:8000/connectivity/messaging/v1/7311ea8c-5d48-43fe-acf9-980eedf24b6c/ppmp/v2/measurement -
https://serverurl.com:443/connectivity/messaging/v1/7311ea8c-5d48-43fe-acf9-980eedf24b6c/ppmp/measurement