# UpdateFirmware
## Description
Request for a device to download and install new firmware. The request contains a URL defining the location of the new firmware image. The device should download the firmware from that location.
Response communicates status.
## Message definitions
```javascript
message UpdateFirmwareRequest {
required string firmwareDomain = 1; // [(nanopb).max_size = 100]; // Servername
required string firmwareUrl = 2; // [(nanopb).max_size = 255]; // /firmware/TSTMAN/TSTMOD/RXX
}
message UpdateFirmwareResponse {
required Status status = 1;
}
```
## Data types
```javascript
enum Status {
OK = 0;
FAILURE = 1; // general failure
REJECTED = 2; // request received in wrong state
}
```
## Example
Soap requests and responses sent to and from platform:
```markup
LianderNetManagement
liander gebruiker
WEB_NET_MANAGEMENT
device-01
TSTMAN/TSTMOD/SSLD-V17
LianderNetManagement|||device-01|||20160104145959438
device-01
LianderNetManagement
liander gebruiker
WEB_NET_MANAGEMENT
LianderNetManagement|||device-01|||20160104145959438
device-01
OK
```
OSLP UpdateFirmwareRequest sent to 'device-01' to update firmware:
```javascript
updateFirmwareRequest {
firmwareDomain: "flexovltest.cloudapp.net"
firmwareUrl: "/firmware/TSTMAN/TSTMOD/SSLD-V17.hex"
}
```
OSLP UpdateFirmwareResponse sent to the platform:
```javascript
updateFirmwareResponse {
status: OK
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://grid-exchange-fabric.gitbook.io/gxf/protocols/oslp/oslp-v0.6.1/updatefirmware.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.