openapi: add documentation for new OPAL format

doc/openapi/components/schemas/config/format.yaml

@@ -18,6 +18,12 @@ properties:
     description: |
       If set, include the origin timestamp in the output.
 
+  ts_received:
+    type: boolean
+    default: true
+    description: |
+      If set, include the received timestamp in the output.
+
   sequence:
     type: boolean
     default: true

doc/openapi/components/schemas/config/format_obj.yaml

@@ -18,6 +18,7 @@ discriminator:
     json.edgeflex: formats/_json_edgeflex.yaml
     json.kafka: formats/_json_kafka.yaml
     json.reserve: formats/_json_reserve.yaml
+    opal.asyncip: formats/_opal_asyncip.yaml
     protobuf: formats/_protobuf.yaml
     raw: formats/_raw.yaml
     tsv: formats/_tsv.yaml

doc/openapi/components/schemas/config/format_spec.yaml

@@ -16,6 +16,7 @@ oneOf:
   - json.edgeflex
   - json.kafka
   - json.reserve
+  - opal.asyncip
   - protobuf
   - raw
   - tsv

doc/openapi/components/schemas/config/formats/_opal_asyncip.yaml

@@ -0,0 +1,3 @@
+allOf:
+- $ref: ../format_obj.yaml
+- $ref: opal_asyncip.yaml

doc/openapi/components/schemas/config/formats/opal_asyncip.yaml

@@ -0,0 +1,9 @@
+# yaml-language-server: $schema=http://json-schema.org/draft-07/schema
+---
+
+allOf:
+- type: object
+  properties:
+    dev_id:
+      type: integer
+- $ref: ../format.yaml