Swagger: updated model (3)

swagger/sdrangel/README.md

@@ -96,5 +96,8 @@ The language option `-l` allows to generate code or documentation in a lot of la
   - python: Python client
   - angular2: Typescript for Angular2 client
 
+<h3>Links</h3>
 
+  - [Github repository](https://github.com/swagger-api/swagger-codegen)
+  - [Server side code generation](https://github.com/swagger-api/swagger-codegen/wiki/Server-stub-generator-HOWTO) although not useful in this case
 

swagger/sdrangel/api/swagger/swagger.yaml

@@ -231,18 +231,10 @@ paths:
       parameters:
         - name: body
           in: body
-          description: Load this preset
+          description: Load preset settings to the device set
           required: true
           schema:
-            required:
+            $ref: "#/definitions/PresetTransfer"
-              - deviceSetIndex
-              - preset
-            properties:
-              deviceSetIndex:
-                description: "Index of the device set" 
-                type: integer
-              preset:
-                $ref: "#/definitions/PresetIdentifier"
       responses:
         "200":
           description: On success return preset identification
@@ -262,18 +254,10 @@ paths:
       parameters:
         - name: body
           in: body
-          description: save device set settings on this preset
+          description: save device set settings to the preset
           required: true
           schema:
-            required:
+            $ref: "#/definitions/PresetTransfer"
-              - deviceSetIndex
-              - preset
-            properties:
-              deviceSetIndex:
-                description: "Index of the device set" 
-                type: integer
-              preset:
-                $ref: "#/definitions/PresetIdentifier"
       responses:
         "200":
           description: On success return preset identification
@@ -293,18 +277,10 @@ paths:
       parameters:
         - name: body
           in: body
-          description: save current settings on a new preset
+          description: save device set settings on a new preset
           required: true
           schema:
-            required:
+            $ref: "#/definitions/PresetTransfer"
-              - deviceSetIndex
-              - preset
-            properties:
-              deviceSetIndex:
-                description: "Index of the device set" 
-                type: integer
-              preset:
-                $ref: "#/definitions/PresetIdentifier"
       responses:
         "200":
           description: On success return preset identification
@@ -354,6 +330,12 @@ paths:
     post:
       description: Add (append) a new device set
       operationId: instanceDeviceSetsPost
+      parameters:
+        - name: tx
+          in: query
+          description: Set to true for a Tx device set
+          required: false
+          type: boolean
       responses:
         "200":
           description: On success return new device set
@@ -692,3 +674,14 @@ definitions:
       name:
         description: "Descriptive name of the preset"
         type: string
+  PresetTransfer:
+    description: "Preset transfer to or from a device set"
+    required:
+      - deviceSetIndex
+      - preset
+    properties:
+      deviceSetIndex:
+        description: "Index of the device set" 
+        type: integer
+      preset:
+        $ref: "#/definitions/PresetIdentifier"