Add extracted tools: CitrineOS, OpenOCPP, ShapeShifter

- CitrineOS core extracted (CSMS OCPP 2.0.1)
- OpenOCPP extracted (firmware OCPP 1.6J/2.0.1)
- ShapeShifter library installed (pip install -e)
- ShapeShifter specification extracted
- EVerest extracted

TODO updated with progress

tools/EVerest-main/lib/everest/framework/schemas/interface.yaml

@@ -0,0 +1,158 @@
+$schema: http://json-schema.org/draft-07/schema#
+description: Json schema for EVerest interface files
+$defs:
+  # all subschemas can not use allOf with the draft-07 schema because that will cause our validator to
+  # add all draft-07 default values which never validate (the {"not": true} default contradicts everything)
+  # --> validating against draft-07 will be done in an extra step in config.cpp
+  var_subschema:
+    type: object
+    # require at least a type declaration for this command/result schema
+    required:
+      - type
+      - description
+    properties:
+      type:
+        type:
+          - string
+          - array
+        items:
+          type: string
+        uniqueItems: true
+      description:
+        type: string
+        minLength: 2
+      qos:
+        "type": "integer"
+        "minimum": 0
+        "maximum": 2
+        "default": 2
+      # we don't allow default values
+      default: false
+    # allow all sorts of entries (should be a json schema!)
+    additionalProperties: true
+  cmd_arguments_subschema:
+    type: object
+    patternProperties:
+      # arbitrary argument name
+      ^[a-zA-Z_][a-zA-Z0-9_.-]*$:
+        type: object
+        # require at least a type declaration for this command/result schema
+        required:
+          - type
+          - description
+        properties:
+          type:
+            type:
+              - array
+              - string
+            items:
+              type: string
+            uniqueItems: true
+            pattern: ^(?!null).*$
+          description:
+            type: string
+            minLength: 2
+          # we don't allow default values
+          default: false
+        # allow all sorts of entries (should be a json schema!)
+        additionalProperties: true
+    # only allow argument names conforming to our pattern above
+    additionalProperties: false
+    default: {}
+  cmd_result_subschema:
+    type: object
+    # require at least a type declaration for this command/result schema
+    required:
+      - type
+      - description
+    properties:
+      type:
+        type:
+          - array
+          - string
+        items:
+          type: string
+        uniqueItems: true
+        pattern: ^(?!null).*$
+      description:
+        type: string
+        minLength: 2
+      # we don't allow default values
+      default: false
+    # allow all sorts of entries (should be a json schema!)
+    additionalProperties: true
+    default:
+      type: 'null'
+      description: This returns nothing
+type: object
+required:
+  - description
+properties:
+  description:
+    type: string
+    minLength: 2
+  cmds:
+    description: >-
+      This describes a list of commands for this unit having arguments
+      and result declared as json schema
+    type: object
+    patternProperties:
+      # arbitrary command name
+      ^[a-zA-Z_][a-zA-Z0-9_.-]*$:
+        type: object
+        description: >-
+          the keys 'arguments' and 'result' declare json schemas defining
+          the arguments and result for this command (default: 'type': 'null')
+        required:
+          - description
+        properties:
+          description:
+            type: string
+            minLength: 2
+          # default is an empty arguments/result list
+          arguments:
+            $ref: '#/$defs/cmd_arguments_subschema'
+          result:
+            $ref: '#/$defs/cmd_result_subschema'
+        default: {}
+        # don't allow arbitrary additional properties
+        additionalProperties: false
+    # don't allow arbitrary additional properties
+    additionalProperties: false
+    # add empty cmds if not already present
+    default: {}
+  vars:
+    description: This describes a list of exported variables of this unit
+    type: object
+    patternProperties:
+      # arbitrary variable name
+      ^[a-zA-Z_][a-zA-Z0-9_.-]*$:
+        description: >-
+          json schema declaring the contents of the variables exported
+          by this unit
+        $ref: '#/$defs/var_subschema'
+    # don't allow arbitrary additional properties
+    additionalProperties: false
+    # add empty vars if not already present
+    default: {}
+  errors:
+    description: This describes a list of error list allowed to be raised by this unit
+    type: array
+    items:
+      type: object
+      required:
+        - reference
+      properties:
+        reference:
+          anyOf:
+              # reference to a complete error list
+              # (e.g. /errors/example)
+            - type: string
+              pattern: ^/errors/[a-z][a-zA-Z0-9_]*$
+              # reference to a single error
+              # (e.g. /errors/example#/ExampleErrorA)
+            - type: string
+              pattern: ^/errors/[a-z][a-zA-Z0-9_]*#/[A-Z][A-Za-z0-9]*$
+      additionalProperties: false
+    default: []
+additionalProperties: false