kopia lustrzana https://github.com/f4exb/sdrangel
2746 wiersze
85 KiB
YAML
2746 wiersze
85 KiB
YAML
swagger: "2.0"
|
|
info:
|
|
description: >
|
|
This is the web REST/JSON API of SDRangel SDR software. SDRangel is an Open Source Qt5/OpenGL 3.0+ (4.3+ in Windows) GUI and server Software Defined Radio and signal analyzer in software. It supports Airspy, BladeRF, HackRF, LimeSDR, PlutoSDR, RTL-SDR, SDRplay RSP1, USRP and FunCube
|
|
|
|
---
|
|
Limitations and specifcities:
|
|
|
|
* In SDRangel GUI the first Rx device set cannot be deleted. Conversely the server starts with no device sets and its number of device sets can be reduced to zero by as many calls as necessary to /sdrangel/deviceset with DELETE method.
|
|
* Preset import and export from/to file is a server only feature.
|
|
* Device set focus is a GUI only feature.
|
|
* The following channels are not implemented (status 501 is returned): ATV and DATV demodulators, Channel Analyzer NG, LoRa demodulator
|
|
* The device settings and report structures contains only the sub-structure corresponding to the device type. The DeviceSettings and DeviceReport structures documented here shows all of them but only one will be or should be present at a time
|
|
* The channel settings and report structures contains only the sub-structure corresponding to the channel type. The ChannelSettings and ChannelReport structures documented here shows all of them but only one will be or should be present at a time
|
|
|
|
---
|
|
|
|
version: "4.15.0"
|
|
title: SDRangel
|
|
contact:
|
|
url: "https://github.com/f4exb/sdrangel"
|
|
email: "f4exb06@gmail.com"
|
|
# basePath prefixes all resource paths
|
|
basePath: /
|
|
#
|
|
schemes:
|
|
# tip: remove http to make production-grade
|
|
- http
|
|
# format of bodies a client can send (Content-Type)
|
|
consumes:
|
|
- application/json
|
|
# format of the responses to the client (Accepts)
|
|
produces:
|
|
- application/json
|
|
|
|
paths:
|
|
|
|
/sdrangel:
|
|
# binds a127 app logic to a route
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: SDRangel instance summary
|
|
# used as the method name of the controller
|
|
operationId: instanceSummary
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
# a pointer to a definition
|
|
$ref: "#/definitions/InstanceSummaryResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: Stop SDRangel instance (server only)
|
|
# used as the method name of the controller
|
|
operationId: instanceDelete
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"202":
|
|
description: Message to stop the SDRangel instance was sent successfully
|
|
schema:
|
|
# a pointer to a definition
|
|
$ref: "#/definitions/InstanceSummaryResponse"
|
|
"400":
|
|
description: Unsupported (GUI instance)
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/config:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get the Preferences, Presets and Commands of the MainSettings saved by Qt. Supports config backup.
|
|
operationId: instanceConfigGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
# a pointer to a definition
|
|
$ref: "#/definitions/InstanceConfigResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: Replace the Preferences, Working preset, Presets and Commands of the MainSettings object with the contents of the payload. Supports config restore.
|
|
operationId: instanceConfigPut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Config information
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/InstanceConfigResponse"
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
patch:
|
|
description: Replace the Preferences, Working preset, Presets and Commands of the MainSettings object with the contents of the payload. Presets and Commands if available in the payload are added. Channels in the working preset are added. Devices in the working preset are patched or added (upsert).
|
|
operationId: instanceConfigPatch
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Config information
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/InstanceConfigResponse"
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/devices:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get a list of sampling devices that can be used to take part in a device set
|
|
operationId: instanceDevices
|
|
tags:
|
|
- Instance
|
|
parameters:
|
|
- name: direction
|
|
in: query
|
|
description: 0 for Rx only, 1 for Tx only or 2 for any number and direction (default 0)
|
|
required: false
|
|
type: integer
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/InstanceDevicesResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/channels:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get a list of channel plugins available in this instance
|
|
operationId: instanceChannels
|
|
tags:
|
|
- Instance
|
|
parameters:
|
|
- name: direction
|
|
in: query
|
|
description: 0 for Rx only, 1 for Tx only or 2 for any number and direction (default 0)
|
|
required: false
|
|
type: integer
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/InstanceChannelsResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/logging:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get logging information for this instance
|
|
operationId: instanceLoggingGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/LoggingInfo"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: Change logging parmeters for this instance
|
|
operationId: instanceLoggingPut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Logging information
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/LoggingInfo"
|
|
responses:
|
|
"200":
|
|
description: Return new data on success
|
|
schema:
|
|
$ref: "#/definitions/LoggingInfo"
|
|
"400":
|
|
description: Invalid data
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/audio:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get audio devices list available to this instance
|
|
operationId: instanceAudioGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/AudioDevices"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/audio/input/parameters:
|
|
x-swagger-router-controller: instance
|
|
patch:
|
|
description: Set audio input device paramaters
|
|
operationId: instanceAudioInputPatch
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Audio input parameters. Index is used to identify the device. Only settable fields are considered.
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AudioInputDevice"
|
|
responses:
|
|
"200":
|
|
description: Success. Returns actual data in particular the actual sample rate.
|
|
schema:
|
|
$ref: "#/definitions/AudioInputDevice"
|
|
"404":
|
|
description: Audio input device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: Delete audio input device paramaters and return to defaults
|
|
operationId: instanceAudioInputDelete
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Audio input parameters. Index is used to identify the device.
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AudioInputDevice"
|
|
responses:
|
|
"200":
|
|
description: Success. Returns default parameters.
|
|
schema:
|
|
$ref: "#/definitions/AudioInputDevice"
|
|
"404":
|
|
description: Audio input device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
|
|
/sdrangel/audio/input/cleanup:
|
|
x-swagger-router-controller: instance
|
|
patch:
|
|
description: Remove registered parameters for devices not in list of available input devices for this instance
|
|
operationId: instanceAudioInputCleanupPatch
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success.
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/audio/output/parameters:
|
|
x-swagger-router-controller: instance
|
|
patch:
|
|
description: Set audio output device parameters
|
|
operationId: instanceAudioOutputPatch
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Audio output parameters. Index is used to identify the device. Only settable fields are considered.
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AudioOutputDevice"
|
|
responses:
|
|
"200":
|
|
description: Success. Returns actual data in particular the actual sample rate.
|
|
schema:
|
|
$ref: "#/definitions/AudioOutputDevice"
|
|
"404":
|
|
description: Audio output device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: Delete audio output device paramaters and return to defaults
|
|
operationId: instanceAudioOutputDelete
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Audio output parameters. Index is used to identify the device.
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AudioOutputDevice"
|
|
responses:
|
|
"200":
|
|
description: Success. Returns actual data in particular the actual sample rate.
|
|
schema:
|
|
$ref: "#/definitions/AudioOutputDevice"
|
|
"404":
|
|
description: Audio output device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/audio/output/cleanup:
|
|
x-swagger-router-controller: instance
|
|
patch:
|
|
description: Remove registered parameters for devices not in list of available output devices for this instance
|
|
operationId: instanceAudioOutputCleanupPatch
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success.
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/location:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get instance geolocation information
|
|
operationId: instanceLocationGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return location
|
|
schema:
|
|
$ref: "#/definitions/LocationInformation"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: Set instance geolocation information
|
|
operationId: instanceLocationPut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Location of instance in latitude and longitude
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/LocationInformation"
|
|
responses:
|
|
"200":
|
|
description: On success return location
|
|
schema:
|
|
$ref: "#/definitions/LocationInformation"
|
|
"400":
|
|
description: Location invalid
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/ambe/serial:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: get a list of available DV serial devices
|
|
operationId: instanceAMBESerialGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return list of device paths possibly empty
|
|
schema:
|
|
$ref: "#/definitions/DVSerialDevices"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/ambe/devices:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: get the list of AMBE devices (serial or address) used for AMBE frames decoding in digital voice modes
|
|
operationId: InstanceAMBEDevicesGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return list of devices possibly empty
|
|
schema:
|
|
$ref: "#/definitions/AMBEDevices"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: Replace the list of active devices
|
|
operationId: InstanceAMBEDevicesPut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: List of AMBE devices (serial or address)
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AMBEDevices"
|
|
responses:
|
|
"200":
|
|
description: On success return list of devices
|
|
schema:
|
|
$ref: "#/definitions/AMBEDevices"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: Emtpy the active devices thus effectively closing down AMBE devices support
|
|
operationId: InstanceAMBEDevicesDelete
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: Success.
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
patch:
|
|
description: Add and/or delete devices to/from the active list
|
|
operationId: InstanceAMBEDevicesPatch
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: List of AMBE devices (serial or address)
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AMBEDevices"
|
|
responses:
|
|
"200":
|
|
description: On success return list of devices
|
|
schema:
|
|
$ref: "#/definitions/AMBEDevices"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/limerfe/serial:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: get a list of available serial interfaces to LimeRFE device
|
|
operationId: instanceLimeRFESerialGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return list of device paths possibly empty
|
|
schema:
|
|
$ref: "#/definitions/LimeRFEDevices"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/limerfe/config:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: get LimeRFE configuration
|
|
operationId: instanceLimeRFEConfigGet
|
|
tags:
|
|
- Instance
|
|
parameters:
|
|
- name: serial
|
|
in: query
|
|
description: device serial path
|
|
required: true
|
|
type: string
|
|
responses:
|
|
"200":
|
|
description: On success return configuration information for the given device in input
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/LimeRFE.yaml#/LimeRFESettings"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: replace LimeRFE configuration
|
|
operationId: instanceLimeRFEConfigPut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Give device serial path in devicePath field. To switch Rx and/or Tx on or off use the run API.
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/LimeRFE.yaml#/LimeRFESettings"
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Error
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/limerfe/run:
|
|
x-swagger-router-controller: instance
|
|
put:
|
|
description: set Rx and Tx on or off
|
|
operationId: instanceLimeRFERunPut
|
|
tags:
|
|
- Instance
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Give device serial path in devicePath field and run status in rxOn and txOn
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/LimeRFE.yaml#/LimeRFESettings"
|
|
responses:
|
|
"200":
|
|
description: Success
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Error
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/limerfe/power:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: get forward and reflected relative powers in centi-Bels
|
|
operationId: instanceLimeRFEPowerGet
|
|
tags:
|
|
- Instance
|
|
parameters:
|
|
- name: serial
|
|
in: query
|
|
description: device serial path
|
|
required: true
|
|
type: string
|
|
responses:
|
|
"200":
|
|
description: On success return forward and reflected powers in centi-Bels
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/LimeRFE.yaml#/LimeRFEPower"
|
|
"400":
|
|
description: Error
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/presets:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: List all presets in the instance
|
|
operationId: instancePresetGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return preset list
|
|
schema:
|
|
$ref: "#/definitions/Presets"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/preset:
|
|
x-swagger-router-controller: instance
|
|
patch:
|
|
description: Load a preset in a device set
|
|
operationId: instancePresetPatch
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: Load preset settings to the device set
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/PresetTransfer"
|
|
responses:
|
|
"202":
|
|
description: On successful sending of the message the selected preset identification is returned
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
"400":
|
|
description: Invalid JSON request or preset type and device set type mismatch
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: No preset or device set found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: Update an existing preset with device set settings.
|
|
operationId: instancePresetPut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: save device set settings to the preset
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/PresetTransfer"
|
|
responses:
|
|
"202":
|
|
description: On successful sending of the message the selected preset identification is returned
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
"400":
|
|
description: Invalid JSON request
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: No preset or device set found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
post:
|
|
description: Create a new preset from a device set settings. Frequency and type is ignored and taken from the the device set values.
|
|
operationId: instancePresetPost
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: save device set settings on a new preset
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/PresetTransfer"
|
|
responses:
|
|
"202":
|
|
description: On successful sending of the message the created preset identification is returned
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
"400":
|
|
description: Invalid JSON request
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device set not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"409":
|
|
description: Preset already exists
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: Deletes a preset
|
|
operationId: instancePresetDelete
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: delete this preset
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
responses:
|
|
"202":
|
|
description: On successful sending of the message the selected preset identification is returned
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
"400":
|
|
description: Invalid JSON request
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Preset not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/preset/file:
|
|
x-swagger-router-controller: instance
|
|
put:
|
|
description: import a preset from file as a new preset (server only).
|
|
operationId: instancePresetFilePut
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: import details
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/PresetImport"
|
|
responses:
|
|
"200":
|
|
description: On success return preset identification
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
"400":
|
|
description: Invalid JSON request
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: File not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
post:
|
|
description: export a preset to file (server only).
|
|
operationId: instancePresetFilePost
|
|
tags:
|
|
- Instance
|
|
consumes:
|
|
- application/json
|
|
parameters:
|
|
- name: body
|
|
in: body
|
|
description: export details
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/PresetExport"
|
|
responses:
|
|
"200":
|
|
description: On success return preset identification
|
|
schema:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
"400":
|
|
description: Invalid JSON request
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Preset or file path not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/devicesets:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get summary information about device sets opened in the instance
|
|
operationId: instanceDeviceSetsGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return device set list
|
|
schema:
|
|
$ref: "#/definitions/DeviceSetList"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featuresets:
|
|
x-swagger-router-controller: instance
|
|
get:
|
|
description: Get summary information about feature sets opened in the instance
|
|
operationId: instanceFeatureSetsGet
|
|
tags:
|
|
- Instance
|
|
responses:
|
|
"200":
|
|
description: On success return feature set list
|
|
schema:
|
|
$ref: "#/definitions/FeatureSetList"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset:
|
|
x-swagger-router-controller: instance
|
|
post:
|
|
description: Add (append) a new device set with default values
|
|
operationId: instanceDeviceSetPost
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- name: direction
|
|
in: query
|
|
description: 0 for Rx only, 1 for Tx only or 2 for any number and direction (default 0)
|
|
required: false
|
|
type: integer
|
|
responses:
|
|
"202":
|
|
description: Message to add a new device set was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: Remove last device set. The GUI version does not remove the first device.
|
|
operationId: instanceDeviceSetDelete
|
|
tags:
|
|
- DeviceSet
|
|
responses:
|
|
"202":
|
|
description: Message to remove last device set was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"404":
|
|
description: "No more device sets to be deleted"
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: Get device set information
|
|
operationId: devicesetGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
responses:
|
|
"200":
|
|
description: On success return details on the device set
|
|
schema:
|
|
$ref: "#/definitions/DeviceSet"
|
|
"404":
|
|
description: Invalid index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/focus:
|
|
x-swagger-router-controller: deviceset
|
|
patch:
|
|
description: Set focus on device set (GUI only)
|
|
operationId: devicesetFocusPatch
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
responses:
|
|
"202":
|
|
description: Message to focus on device set was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Unsupported (srver instance)
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Invalid index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/device:
|
|
x-swagger-router-controller: deviceset
|
|
put:
|
|
description: Set the device used in the device set
|
|
operationId: devicesetDevicePut
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Device item to look for. Specify only the fields you want to search for. You must at least specify one among displayedName, hwType or serial. index and deviceŃbStreams are ignored. Rx is assumed by default.
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/DeviceListItem"
|
|
responses:
|
|
"202":
|
|
description: On successful semdomg of the message it returns the details of the device being set
|
|
schema:
|
|
$ref: "#/definitions/DeviceListItem"
|
|
"400":
|
|
description: Device set and device type mismatch (Rx vs Tx)
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Invalid device set index or device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/device/settings:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: Get device settings
|
|
operationId: devicesetDeviceSettingsGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
responses:
|
|
"200":
|
|
description: On success returns current settings values
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
"404":
|
|
description: Invalid device set index or device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: Apply all settings unconditionally (force)
|
|
operationId: devicesetDeviceSettingsPut
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Device settings to apply
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
responses:
|
|
"200":
|
|
description: On success returns new settings values
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
"404":
|
|
description: Invalid device set index or device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
patch:
|
|
description: Apply settings differentially (no force)
|
|
operationId: devicesetDeviceSettingsPatch
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Device settings to apply
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
responses:
|
|
"200":
|
|
description: On success returns new settings values
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
"404":
|
|
description: Invalid device set index or device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/device/run:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: get device run status for a single subsystem device (Rx or Tx)
|
|
operationId: devicesetDeviceRunGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
responses:
|
|
"200":
|
|
description: On success return current state
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
post:
|
|
description: start device for a single subsystem device (Rx or Tx)
|
|
operationId: devicesetDeviceRunPost
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Originator information in the reverse API case
|
|
required: false
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return state before change
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: stop device for a single subsystem device (Rx or Tx)
|
|
operationId: devicesetDeviceRunDelete
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Originator information in the reverse API case
|
|
required: false
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return state before change
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/subdevice/{subsystemIndex}/run:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: get device run status for a multi-subsystem device (Rx/Tx combination i.e. MIMO)
|
|
operationId: devicesetDeviceSubsystemRunGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: subsystemIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of subsystem (0 for Rx, 1 for Tx)
|
|
responses:
|
|
"200":
|
|
description: On success return current state
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device or subsystem not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
post:
|
|
description: start device for a multi-subsystem device (Rx/Tx combination i.e. MIMO)
|
|
operationId: devicesetDeviceSubsystemRunPost
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: subsystemIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of subsystem (0 for Rx, 1 for Tx)
|
|
- name: body
|
|
in: body
|
|
description: Originator information in the reverse API case
|
|
required: false
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return state before change
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device or subsystem not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: stop device for a multi-subsystem device (Rx/Tx combination i.e. MIMO)
|
|
operationId: devicesetDeviceSubsystemRunDelete
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: subsystemIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of subsystem (0 for Rx, 1 for Tx)
|
|
- name: body
|
|
in: body
|
|
description: Originator information in the reverse API case
|
|
required: false
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceSettings.yaml#/DeviceSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return state before change
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device or subsystem not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/device/report:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: get the device report
|
|
operationId: devicesetDeviceReportGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
responses:
|
|
"200":
|
|
description: On success return device report
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceReports.yaml#/DeviceReport"
|
|
"400":
|
|
description: Invalid device set
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/channels/report:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: get channels report
|
|
operationId: devicesetChannelsReportGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
responses:
|
|
"200":
|
|
description: On success return channels report information
|
|
schema:
|
|
$ref: "#/definitions/ChannelsDetail"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/device/actions:
|
|
x-swagger-router-controller: deviceset
|
|
post:
|
|
description: post an action on a device
|
|
operationId: devicesetDeviceActionsPost
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Action(s) to apply to the device
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/DeviceActions.yaml#/DeviceActions"
|
|
responses:
|
|
"202":
|
|
description: Message to perform action was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/channel:
|
|
x-swagger-router-controller: deviceset
|
|
post:
|
|
description: add a channel
|
|
operationId: devicesetChannelPost
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- name: body
|
|
in: body
|
|
description: Channel identification (no settings data)
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
responses:
|
|
"202":
|
|
description: Message to add a channel was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/channel/{channelIndex}:
|
|
x-swagger-router-controller: deviceset
|
|
delete:
|
|
description: delete a channel
|
|
operationId: devicesetChannelDelete
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: channelIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of channel in the channels list
|
|
responses:
|
|
"200":
|
|
description: On success return deleted channel settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
"400":
|
|
description: Invalid device set or channel index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device set or channel not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/channel/{channelIndex}/settings:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: get a channel settings
|
|
operationId: devicesetChannelSettingsGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: channelIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the channel in the channels list for this device set
|
|
responses:
|
|
"200":
|
|
description: On success return channel settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
"400":
|
|
description: Invalid device set or channel index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device set or channel not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: apply all settings unconditionally (force)
|
|
operationId: devicesetChannelSettingsPut
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: channelIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the channel in the channels list for this device set
|
|
- name: body
|
|
in: body
|
|
description: Channel settings to apply
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return channel new settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
"400":
|
|
description: Invalid device set or channel index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device set or channel not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
patch:
|
|
description: apply settings differentially (no force)
|
|
operationId: devicesetChannelSettingsPatch
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: channelIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the channel in the channels list for this device set
|
|
- name: body
|
|
in: body
|
|
description: Channel settings to apply
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return channel new settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelSettings.yaml#/ChannelSettings"
|
|
"400":
|
|
description: Invalid device set or channel index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device set or channel not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/channel/{channelIndex}/report:
|
|
x-swagger-router-controller: deviceset
|
|
get:
|
|
description: get a channel report
|
|
operationId: devicesetChannelReportGet
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: channelIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the channel in the channels list for this device set
|
|
responses:
|
|
"200":
|
|
description: On success return channel report
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelReport.yaml#/ChannelReport"
|
|
"400":
|
|
description: Invalid device set or channel index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device set or channel not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/deviceset/{deviceSetIndex}/channel/{channelIndex}/actions:
|
|
x-swagger-router-controller: deviceset
|
|
post:
|
|
description: post an action or actions on a channel
|
|
operationId: devicesetChannelActionsPost
|
|
tags:
|
|
- DeviceSet
|
|
parameters:
|
|
- in: path
|
|
name: deviceSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of device set in the device set list
|
|
- in: path
|
|
name: channelIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the channel in the channels list for this device set
|
|
- name: body
|
|
in: body
|
|
description: Action(s) to apply to the channel
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelActions.yaml#/ChannelActions"
|
|
responses:
|
|
"202":
|
|
description: Message to perform action was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Invalid device set or channel index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device or channel not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}:
|
|
x-swagger-router-controller: featureset
|
|
get:
|
|
description: Get feature set information
|
|
operationId: featuresetGet
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the device set list
|
|
responses:
|
|
"200":
|
|
description: On success return details on the feature set
|
|
schema:
|
|
$ref: "#/definitions/FeatureSet"
|
|
"404":
|
|
description: Invalid index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}/feature:
|
|
x-swagger-router-controller: featureset
|
|
post:
|
|
description: add a feature
|
|
operationId: featuresetFeaturePost
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- name: body
|
|
in: body
|
|
description: Feature identification (no settings data)
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
responses:
|
|
"202":
|
|
description: Message to add a feature was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Invalid feature set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}/feature/{featureIndex}:
|
|
x-swagger-router-controller: featureset
|
|
delete:
|
|
description: delete a feature
|
|
operationId: featuresetFeatureDelete
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature in the features list
|
|
responses:
|
|
"200":
|
|
description: On success return deleted feature settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
"400":
|
|
description: Invalid feature set or feature index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature set or feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}/feature/{featureIndex}/run:
|
|
x-swagger-router-controller: featureset
|
|
get:
|
|
description: get feature run status
|
|
operationId: featuresetFeatureRunGet
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature in the features list
|
|
responses:
|
|
"200":
|
|
description: On success return current feature run state
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid feature set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
post:
|
|
description: start feature
|
|
operationId: featuresetFeatureRunPost
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature in the features list
|
|
responses:
|
|
"200":
|
|
description: On success return state before change
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid feature set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
delete:
|
|
description: stop feature
|
|
operationId: featuresetFeatureRunDelete
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature in the features list
|
|
responses:
|
|
"200":
|
|
description: On success return state before change
|
|
schema:
|
|
$ref: "#/definitions/DeviceState"
|
|
"400":
|
|
description: Invalid device set index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Device not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}/feature/{featureIndex}/settings:
|
|
x-swagger-router-controller: featureset
|
|
get:
|
|
description: get a feature settings
|
|
operationId: featuresetFeatureSettingsGet
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the feature in the features list for this feature set
|
|
responses:
|
|
"200":
|
|
description: On success return feature settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
"400":
|
|
description: Invalid feature set or feature index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature set or feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
put:
|
|
description: apply all settings unconditionally (force)
|
|
operationId: featuresetFEatureSettingsPut
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the feature in the features list for this feature set
|
|
- name: body
|
|
in: body
|
|
description: Feature settings to apply
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return feature new settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
"400":
|
|
description: Invalid feature set or feature index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature set or feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
patch:
|
|
description: apply settings differentially (no force)
|
|
operationId: featuresetFeatureSettingsPatch
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the feature in the features list for this feature set
|
|
- name: body
|
|
in: body
|
|
description: Feature settings to apply
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
responses:
|
|
"200":
|
|
description: On success return feature new settings
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSettings.yaml#/FeatureSettings"
|
|
"400":
|
|
description: Invalid feature set or feature index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature set or feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}/feature/{featureIndex}/report:
|
|
x-swagger-router-controller: featureset
|
|
get:
|
|
description: get a feature report
|
|
operationId: featuresetFeatureReportGet
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the feature in the features list for this feature set
|
|
responses:
|
|
"200":
|
|
description: On success return feature report
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureReport.yaml#/FeatureReport"
|
|
"400":
|
|
description: Invalid feature set or feature index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature set or feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/sdrangel/featureset/{featureSetIndex}/feature/{featureIndex}/actions:
|
|
x-swagger-router-controller: featureset
|
|
post:
|
|
description: post an action or actions on a channel
|
|
operationId: featuresetFeatureActionsPost
|
|
tags:
|
|
- FeatureSet
|
|
parameters:
|
|
- in: path
|
|
name: featureSetIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of feature set in the feature set list
|
|
- in: path
|
|
name: featureIndex
|
|
type: integer
|
|
required: true
|
|
description: Index of the feature in the features list for this feature set
|
|
- name: body
|
|
in: body
|
|
description: Action(s) to apply to the feature
|
|
required: true
|
|
schema:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureActions.yaml#/FeatureActions"
|
|
responses:
|
|
"202":
|
|
description: Message to perform action was sent successfully
|
|
schema:
|
|
$ref: "#/definitions/SuccessResponse"
|
|
"400":
|
|
description: Invalid feature set or feature index
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"404":
|
|
description: Feature set or feature not found
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
"500":
|
|
$ref: "#/responses/Response_500"
|
|
"501":
|
|
$ref: "#/responses/Response_501"
|
|
|
|
/swagger:
|
|
x-swagger-pipe: swagger_raw
|
|
|
|
# complex objects have schema definitions
|
|
definitions:
|
|
|
|
InstanceSummaryResponse:
|
|
description: "Summarized information about this SDRangel instance"
|
|
required:
|
|
- version
|
|
- qtVersion
|
|
- dspRxBits
|
|
- dspTxBits
|
|
- pid
|
|
- appname
|
|
- devicesetlist
|
|
- architecture
|
|
- os
|
|
properties:
|
|
version:
|
|
description: "Current software version"
|
|
type: string
|
|
qtVersion:
|
|
description: "Qt version with which the software was compiled"
|
|
type: string
|
|
dspRxBits:
|
|
description: "Number of samples significant bits in software Rx DSP"
|
|
type: integer
|
|
dspTxBits:
|
|
description: "Number of samples significant bits in software Tx DSP"
|
|
type: integer
|
|
pid:
|
|
description: "PID of the SDRangel instance"
|
|
type: integer
|
|
appname:
|
|
description: "Application name: SDRangel for a GUI instance and SDRangelSrv for a server instance"
|
|
type: string
|
|
architecture:
|
|
description: "Codename of the CPU architecture on which the instance is running (available with Qt >= 5.4)"
|
|
type: string
|
|
os:
|
|
description: "Descriptive text of the operating system running the instance (available with Qt >= 5.4)"
|
|
type: string
|
|
logging:
|
|
$ref: "#/definitions/LoggingInfo"
|
|
devicesetlist:
|
|
$ref: "#/definitions/DeviceSetList"
|
|
|
|
InstanceConfigResponse:
|
|
description: Preferences, Presets and Commands of the MainSettings saved by Qt
|
|
properties:
|
|
preferences:
|
|
$ref: "http://swgserver:8081/api/swagger/include/Preferences.yaml#/Preferences"
|
|
workingPreset:
|
|
$ref: "http://swgserver:8081/api/swagger/include/Preset.yaml#/Preset"
|
|
workingFeatureSetPreset:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSetPreset.yaml#/FeatureSetPreset"
|
|
presets:
|
|
type: array
|
|
items:
|
|
$ref: "http://swgserver:8081/api/swagger/include/Preset.yaml#/Preset"
|
|
commands:
|
|
type: array
|
|
items:
|
|
$ref: "http://swgserver:8081/api/swagger/include/Command.yaml#/Command"
|
|
featuresetpresets:
|
|
type: array
|
|
items:
|
|
$ref: "http://swgserver:8081/api/swagger/include/FeatureSetPreset.yaml#/FeatureSetPreset"
|
|
|
|
InstanceDevicesResponse:
|
|
description: "Summarized information about logical devices from hardware devices attached to this SDRangel instance"
|
|
required:
|
|
- devicecount
|
|
properties:
|
|
devicecount:
|
|
description: "Number of devices attached"
|
|
type: integer
|
|
devices:
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/DeviceListItem"
|
|
|
|
InstanceChannelsResponse:
|
|
description: "Summarized information about channel plugins available in this SDRangel instance"
|
|
required:
|
|
- channelcount
|
|
properties:
|
|
channelcount:
|
|
description: "Number of plugins available"
|
|
type: integer
|
|
channels:
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/ChannelListItem"
|
|
|
|
ErrorResponse:
|
|
required:
|
|
- message
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: "KO"
|
|
|
|
SuccessResponse:
|
|
required:
|
|
- message
|
|
properties:
|
|
message:
|
|
type: string
|
|
|
|
LoggingInfo:
|
|
description: "Logging parameters setting"
|
|
properties:
|
|
consoleLevel:
|
|
description: "Minimum level of messages printed to console: debug, info, warning, error"
|
|
type: string
|
|
fileLevel:
|
|
description: "Minimum level of messages written to file: debug, info, warning, error"
|
|
type: string
|
|
dumpToFile:
|
|
description: "not zero (true) if messages are written to file"
|
|
type: integer
|
|
fileName:
|
|
description: "Name of the log file"
|
|
type: string
|
|
|
|
DeviceListItem:
|
|
description: "Summarized information about attached hardware device"
|
|
properties:
|
|
displayedName:
|
|
description: "Displayable name that uniquely identifies this device instance"
|
|
type: string
|
|
hwType:
|
|
description: "Key to identify the type of hardware device"
|
|
type: string
|
|
serial:
|
|
description: "Serial number of the hardware device"
|
|
type: string
|
|
sequence:
|
|
description: "Sequence in the enumeration of same device types"
|
|
type: integer
|
|
direction:
|
|
description: "0 for Rx only, 1 for Tx only or 2 for any number and direction (default 0)"
|
|
type: integer
|
|
deviceNbStreams:
|
|
description: "Number of channels or streams in the device"
|
|
type: integer
|
|
deviceStreamIndex:
|
|
description: "Index of the channel in the device. Applies to single stream directions (Rx or Tx)"
|
|
type: integer
|
|
deviceSetIndex:
|
|
description: "Index of the device set that claimed this device (-1 if not claimed)"
|
|
type: integer
|
|
index:
|
|
description: "Index of the device in the list of registered devices"
|
|
type: integer
|
|
|
|
ChannelListItem:
|
|
description: "Summarized information about channel plugin"
|
|
required:
|
|
- id
|
|
properties:
|
|
name:
|
|
description: "Displayable name of the channel plugin"
|
|
type: string
|
|
idURI:
|
|
description: "Key to identify the channel plugin type in URI form"
|
|
type: string
|
|
id:
|
|
description: "Key to identify the channel plugin type as short object name"
|
|
type: string
|
|
direction:
|
|
description: "0 for Rx only, 1 for Tx only or 2 for any number and direction (default 0)"
|
|
type: integer
|
|
version:
|
|
description: "Channel plugin version number"
|
|
type: string
|
|
index:
|
|
description: "Index of the channel in the list of registered channels"
|
|
type: integer
|
|
|
|
DeviceSet:
|
|
description: "Sampling device and its associated channels"
|
|
required:
|
|
- samplingDevice
|
|
- channelcount
|
|
properties:
|
|
samplingDevice:
|
|
$ref: "#/definitions/SamplingDevice"
|
|
channelcount:
|
|
description: "Number of channels in the set"
|
|
type: integer
|
|
channels:
|
|
description: "Channels list"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/Channel"
|
|
DeviceSetList:
|
|
description: "List of device sets opened in this instance"
|
|
required:
|
|
- devicesetcount
|
|
properties:
|
|
devicesetcount:
|
|
description: "Number of device sets opened in this instance"
|
|
type: integer
|
|
devicesetfocus:
|
|
description: "Index of the deviceset that has focus (relevant for GUI only)"
|
|
type: integer
|
|
deviceSets:
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/DeviceSet"
|
|
|
|
Feature:
|
|
description: "Feature summarized information"
|
|
required:
|
|
- index
|
|
- id
|
|
- uid
|
|
- title
|
|
properties:
|
|
index:
|
|
description: "Index in the list of features"
|
|
type: integer
|
|
id:
|
|
description: "Key to identify the type of feature"
|
|
type: string
|
|
uid:
|
|
description: "Feature instance unique id"
|
|
type: integer
|
|
format: int64
|
|
title:
|
|
description: "Freeform title of the feature"
|
|
type: string
|
|
FeatureSet:
|
|
description: "Grouping of features"
|
|
required:
|
|
- featurecount
|
|
properties:
|
|
featurecount:
|
|
description: "Number of features in the set"
|
|
type: integer
|
|
features:
|
|
description: "Features list"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/Feature"
|
|
FeatureSetList:
|
|
description: "List of feature sets opened in this instance"
|
|
required:
|
|
- featuresetcount
|
|
properties:
|
|
featuresetcount:
|
|
description: "Number of feature sets opened in this instance"
|
|
type: integer
|
|
featureSets:
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/FeatureSet"
|
|
|
|
DeviceState:
|
|
description: "Device running state"
|
|
properties:
|
|
state:
|
|
description: "Unique state: notStarted, idle, ready, running, error"
|
|
type: string
|
|
|
|
SamplingDevice:
|
|
description: "Information about a logical device available from an attached hardware device that can be used as a sampling device"
|
|
required:
|
|
- index
|
|
- hwType
|
|
- streamIndex
|
|
- sequence
|
|
- serial
|
|
- centerFrequency
|
|
- bandwidth
|
|
properties:
|
|
index:
|
|
description: "Index in the list of device sets opened in this instance"
|
|
type: integer
|
|
hwType:
|
|
description: "Key to identify the type of hardware device"
|
|
type: string
|
|
direction:
|
|
description: "0 for Rx only, 1 for Tx only or 2 for any number and direction (default 0)"
|
|
type: integer
|
|
deviceNbStreams:
|
|
description: "Number of channels or streams in the device"
|
|
type: integer
|
|
deviceStreamIndex:
|
|
description: "Index of the channel in the device. Applies to single stream directions (Rx or Tx)"
|
|
type: integer
|
|
sequence:
|
|
description: "Sequence in the enumeration of same device types"
|
|
type: integer
|
|
serial:
|
|
description: "Serial number of the hardware device"
|
|
type: string
|
|
centerFrequency:
|
|
description: "Center frequency in Hz at which the device is tuned possibly taking NCO into account"
|
|
type: integer
|
|
format: int64
|
|
bandwidth:
|
|
description: "Bandwidth in Hz or complex S/s of baseband"
|
|
type: integer
|
|
state:
|
|
description: "Single subsystem state: notStarted, idle, ready, running, error"
|
|
type: string
|
|
stateRx:
|
|
description: "Rx subsystem state (MIMO): notStarted, idle, ready, running, error"
|
|
type: string
|
|
stateTx:
|
|
description: "Tx subsystem state (MIMO): notStarted, idle, ready, running, error"
|
|
type: string
|
|
|
|
Channel:
|
|
description: "Channel summarized information"
|
|
required:
|
|
- index
|
|
- id
|
|
- uid
|
|
- title
|
|
- deltaFrequency
|
|
properties:
|
|
direction:
|
|
description: 0 for Rx only, 1 for Tx only or 2 for any direction (MIMO)
|
|
type: integer
|
|
index:
|
|
description: "Index in the list of channels"
|
|
type: integer
|
|
id:
|
|
description: "Key to identify the type of channel"
|
|
type: string
|
|
uid:
|
|
description: "Channel instance unique id"
|
|
type: integer
|
|
format: int64
|
|
title:
|
|
description: "Freeform title of the channel"
|
|
type: string
|
|
deltaFrequency:
|
|
description: "Channel shift frequency in Hz from the center of baseband"
|
|
type: integer
|
|
report:
|
|
$ref: "http://swgserver:8081/api/swagger/include/ChannelReport.yaml#/ChannelReport"
|
|
|
|
ChannelsDetail:
|
|
description: "All channels detailed information"
|
|
required:
|
|
- channelcount
|
|
properties:
|
|
channelcount:
|
|
description: "Number of channels in the set"
|
|
type: integer
|
|
channels:
|
|
description: "Channels list"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/Channel"
|
|
|
|
|
|
AudioDevices:
|
|
description: "List of audio devices available in the system"
|
|
required:
|
|
- nbInputDevices
|
|
- nbOutputDevices
|
|
properties:
|
|
nbInputDevices:
|
|
description: "Number of input audio devices"
|
|
type: integer
|
|
inputDevices:
|
|
description: "List of input devices"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/AudioInputDevice"
|
|
nbOutputDevices:
|
|
description: "Number of output audio devices"
|
|
type: integer
|
|
outputDevices:
|
|
description: "List of output devices"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/AudioOutputDevice"
|
|
|
|
AudioInputDevice:
|
|
description: "Audio input device"
|
|
properties:
|
|
name:
|
|
description: "Displayable name of the device"
|
|
type: string
|
|
index:
|
|
description: "Index in attached devices list. -1 for system default"
|
|
type: integer
|
|
sampleRate:
|
|
description: "Device sample rate in S/s"
|
|
type: integer
|
|
isSystemDefault:
|
|
description: "1 if this device is the system default else 0"
|
|
type: integer
|
|
defaultUnregistered:
|
|
description: "1 if this device is unregistered and therefore will inherit default values else 0"
|
|
type: integer
|
|
volume:
|
|
description: "Audio input volume [0.0..1.0]"
|
|
type: number
|
|
format: float
|
|
|
|
AudioOutputDevice:
|
|
description: "Audio output device"
|
|
properties:
|
|
name:
|
|
description: "Displayable name of the device"
|
|
type: string
|
|
index:
|
|
description: "Index in attached devices list. -1 for system default"
|
|
type: integer
|
|
sampleRate:
|
|
description: "Device sample rate in S/s"
|
|
type: integer
|
|
isSystemDefault:
|
|
description: "1 if this device is the system default else 0"
|
|
type: integer
|
|
defaultUnregistered:
|
|
description: "1 if this device is unregistered and therefore will inherit default values else 0"
|
|
type: integer
|
|
copyToUDP:
|
|
description: '1 if audio is copied to UDP else 0'
|
|
type: integer
|
|
udpUsesRTP:
|
|
description: '1 if RTP protocol is used over UDP else 0'
|
|
type: integer
|
|
udpChannelMode:
|
|
description: 'How audio data is copied to UDP: 0: left 1: right 2: mixed 3: stereo (AudioOutput::UDPChannelMode)'
|
|
type: integer
|
|
udpChannelCodec:
|
|
description: 'Index of codec used in UDP/RTP transmission. See AudioOutput::UDPChannelCodec.'
|
|
type: integer
|
|
udpDecimationFactor:
|
|
description: 'Decimation used before codec in UDP/RTP transmission. Ranges from 1 to 6.'
|
|
type: integer
|
|
udpAddress:
|
|
description: "UDP destination address"
|
|
type: string
|
|
udpPort:
|
|
description: "UDP destination port"
|
|
type: integer
|
|
|
|
LocationInformation:
|
|
description: "Instance geolocation information"
|
|
required:
|
|
- latitude
|
|
- longitude
|
|
properties:
|
|
latitude:
|
|
description: "Lautitude in decimal degrees positive to the north"
|
|
type: number
|
|
format: float
|
|
longitude:
|
|
description: "Longitude in decimal degrees positive to the east"
|
|
type: number
|
|
format: float
|
|
|
|
DVSerialDevices:
|
|
description: "List of DV serial devices available in the system"
|
|
required:
|
|
- nbDevices
|
|
properties:
|
|
nbDevices:
|
|
description: "Number of DV serial devices"
|
|
type: integer
|
|
dvSerialDevices:
|
|
description: "Device names of DV serial devices"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/DVSerialDevice"
|
|
|
|
DVSerialDevice:
|
|
description: "DV serial device details"
|
|
properties:
|
|
deviceName:
|
|
description: "Name of the serial device in the system"
|
|
type: string
|
|
|
|
AMBEDevices:
|
|
description: "List of AMBE devices (serial or server address)"
|
|
required:
|
|
- nbDevices
|
|
properties:
|
|
nbDevices:
|
|
description: "Number of DV serial devices"
|
|
type: integer
|
|
ambeDevices:
|
|
description: "List of AMBE devices"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/AMBEDevice"
|
|
|
|
AMBEDevice:
|
|
description: "AMBE devices active in the system"
|
|
properties:
|
|
deviceRef:
|
|
description: "Serial device name or server address"
|
|
type: string
|
|
delete:
|
|
description: "1 if device is to be removed from active list"
|
|
type: integer
|
|
|
|
LimeRFEDevices:
|
|
description: "List of LimeRFE devices (serial or server address)"
|
|
required:
|
|
- nbDevices
|
|
properties:
|
|
nbDevices:
|
|
description: "Number of LimeRFE serial interfaces"
|
|
type: integer
|
|
limeRFEDevices:
|
|
description: "List of LimeRFE devices"
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/LimeRFEDevice"
|
|
|
|
LimeRFEDevice:
|
|
description: "LimeRFE device active in the system"
|
|
properties:
|
|
deviceRef:
|
|
description: "Serial device name or server address"
|
|
type: string
|
|
|
|
Presets:
|
|
description: "Settings presets"
|
|
required:
|
|
- nbGroups
|
|
properties:
|
|
nbGroups:
|
|
description: "Number of preset groups"
|
|
type: integer
|
|
groups:
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/PresetGroup"
|
|
|
|
PresetGroup:
|
|
description: "Group of presets"
|
|
required:
|
|
- groupName
|
|
- nbPresets
|
|
properties:
|
|
groupName:
|
|
description: "Name of the preset group"
|
|
type: string
|
|
nbPresets:
|
|
description: "Number of presets in the group"
|
|
type: integer
|
|
presets:
|
|
type: array
|
|
items:
|
|
$ref: "#/definitions/PresetItem"
|
|
|
|
PresetIdentifier:
|
|
description: "Settings preset item"
|
|
required:
|
|
- groupName
|
|
- centerFrequency
|
|
- type
|
|
- name
|
|
properties:
|
|
groupName:
|
|
description: "Name of the preset group"
|
|
type: string
|
|
centerFrequency:
|
|
description: "Center freqeuency in Hz"
|
|
type: integer
|
|
format: int64
|
|
type:
|
|
description: "Type of device set (R: Rx, T: Tx)"
|
|
type: string
|
|
name:
|
|
description: "Descriptive name of the preset"
|
|
type: string
|
|
|
|
PresetItem:
|
|
description: "Settings preset item"
|
|
required:
|
|
- centerFrequency
|
|
- type
|
|
- name
|
|
properties:
|
|
centerFrequency:
|
|
description: "Center freqeuency in Hz"
|
|
type: integer
|
|
format: int64
|
|
type:
|
|
description: "Type of device set (R: Rx, T: Tx)"
|
|
type: string
|
|
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"
|
|
|
|
PresetImport:
|
|
description: "Details to import preset from file in preset list"
|
|
required:
|
|
- filePath
|
|
properties:
|
|
groupName:
|
|
description: "If present overrides imported preset group name with this name"
|
|
type: string
|
|
description:
|
|
description: "If present overrides imported preset description with this description"
|
|
type: string
|
|
filePath:
|
|
description: "Path of the import file"
|
|
type: string
|
|
|
|
PresetExport:
|
|
description: "Details to export a preset to file"
|
|
properties:
|
|
filePath:
|
|
description: "Path of the import file"
|
|
type: string
|
|
preset:
|
|
$ref: "#/definitions/PresetIdentifier"
|
|
|
|
responses:
|
|
|
|
Response_500:
|
|
description: Error
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
|
|
Response_501:
|
|
description: Function not implemented
|
|
schema:
|
|
$ref: "#/definitions/ErrorResponse"
|
|
|