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: "/doc/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: "/doc/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: "/doc/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: "/doc/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}/spectrum/settings: x-swagger-router-controller: deviceset get: description: Get main spectrum settings operationId: devicesetSpectrumSettingsGet 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 main spectrum schema: $ref: "http://localhost:8081/api/swagger/include/GLSpectrum.yaml#/GLSpectrum" "404": description: Invalid index schema: $ref: "#/definitions/ErrorResponse" "500": $ref: "#/responses/Response_500" "501": $ref: "#/responses/Response_501" put: description: Apply main spectrun settings unconditionnaly (force) operationId: devicesetSpectrumSettingsPut 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: Spectrum settings to apply required: true schema: $ref: "http://localhost:8081/api/swagger/include/GLSpectrum.yaml#/GLSpectrum" responses: "200": description: On success returns new settings values schema: $ref: "http://localhost:8081/api/swagger/include/GLSpectrum.yaml#/GLSpectrum" "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 main spectrun settings differentially (no force) operationId: devicesetSpectrumSettingsPatch 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: Spectrum settings to apply required: true schema: $ref: "http://localhost:8081/api/swagger/include/GLSpectrum.yaml#/GLSpectrum" responses: "200": description: On success returns new settings values schema: $ref: "http://localhost:8081/api/swagger/include/GLSpectrum.yaml#/GLSpectrum" "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}/spectrum/server: x-swagger-router-controller: deviceset get: description: Get main spectrum websocket server status operationId: devicesetSpectrumServerGet 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 main spectrum server status schema: $ref: "#/definitions/SpectrumServer" "404": description: Invalid index schema: $ref: "#/definitions/ErrorResponse" "500": $ref: "#/responses/Response_500" "501": $ref: "#/responses/Response_501" post: description: Start main spectrum websocket server operationId: devicesetSpectrumServerPost tags: - DeviceSet parameters: - in: path name: deviceSetIndex type: integer required: true description: Index of device set in the device set list responses: "200": description: Server successfully started 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" delete: description: Stop main spectrum websocket server operationId: devicesetSpectrumServerDelete tags: - DeviceSet parameters: - in: path name: deviceSetIndex type: integer required: true description: Index of device set in the device set list responses: "200": description: Server successfully stopped 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}/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: "/doc/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: "/doc/swagger/include/DeviceSettings.yaml#/DeviceSettings" responses: "200": description: On success returns new settings values schema: $ref: "/doc/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: "/doc/swagger/include/DeviceSettings.yaml#/DeviceSettings" responses: "200": description: On success returns new settings values schema: $ref: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/swagger/include/ChannelSettings.yaml#/ChannelSettings" responses: "200": description: On success return channel new settings schema: $ref: "/doc/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: "/doc/swagger/include/ChannelSettings.yaml#/ChannelSettings" responses: "200": description: On success return channel new settings schema: $ref: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/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: "/doc/swagger/include/FeatureSettings.yaml#/FeatureSettings" responses: "200": description: On success return feature new settings schema: $ref: "/doc/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: "/doc/swagger/include/FeatureSettings.yaml#/FeatureSettings" responses: "200": description: On success return feature new settings schema: $ref: "/doc/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: "/doc/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: "/doc/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: "/doc/swagger/include/Preferences.yaml#/Preferences" workingPreset: $ref: "/doc/swagger/include/Preset.yaml#/Preset" workingFeatureSetPreset: $ref: "/doc/swagger/include/FeatureSetPreset.yaml#/FeatureSetPreset" presets: type: array items: $ref: "/doc/swagger/include/Preset.yaml#/Preset" commands: type: array items: $ref: "/doc/swagger/include/Command.yaml#/Command" featuresetpresets: type: array items: $ref: "/doc/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" SpectrumServer: description: "Spectrum server state" properties: run: description: "Boolean: 1: websocket spectrum server running 0: not running" type: integer clients: description: "List of clients" type: array items: type: object properties: address: type: string port: type: integer 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: "/doc/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"