# GetConfiguration
## Description
Request which queries a device for its current configuration.
Response which returns the result of the request and, if 'result = OK', contains the configuration of the device.
## IEC61850 Fields
| **ATTRIBUTE** | **FC** | **SUB ATTRIBUTE** | **DATATYPE** | **DESCRIPTION** |
| ------------- | ------ | ----------------- | ------------ | --------------------------------------------------------- |
| XSWC1.SwType | ST | stVal | INT8 | Switch type for relay 1, tariff = 0, light = 1. |
| XSWC2.SwType | ST | stVal | INT8 | Switch type for relay 2, tariff = 0, light = 1. |
| XSWC3.SwType | ST | stVal | INT8 | Switch type for relay 3, tariff = 0, light = 1. |
| CSLC.SWCf | CF | LT | VisString64 | Device light type, always set to RELAY. |
| CSLC.SWCf | CF | adSetOft | INT16 | Offset in minutes with respect to astronomical sunset. |
| CSLC.SWCf | CF | adRiseOft | INT16 | Offset in minutes with respect to astronomical sunrise. |
| CSLC.Reg | CF | svrAddr | VisString64 | OSGP server address for device registration. |
| CSLC.Reg | CF | svrPort | INT32 | OSGP server port for device registration. |
| CSLC.Clock | CF | dstBegT | VisString255 | Daylight savings time begin time. |
| CSLC.Clock | CF | dstEndT | VisString255 | Daylight savings time end time. |
| CSLC.Clock | CF | enbDst | BOOLEAN | Flag indicating whether daylight savings time is enabled. |
| CSLC.Clock | CF | enbNtpC | BOOLEAN | Flag inidicating whether NTP client is enabled. |
| CSLC.Clock | CF | ntpSvrA | VisString255 | NTP server address. |
| CSLC.Clock | CF | syncPer | INT16U | Time sync period. |
| CSLC.IPCf | CF | enbDHCP | BOOLEAN | Flag indicating whether DHCP client is enabled. |
| CSLC.IPCf | CF | ipAddr | VisString32 | Fixed IP address when DHCP is disabled. |
| CSLC.IPCf | CF | netmask | VisString32 | Netmask when DHCP is disabled. |
| CSLC.IPCf | CF | gateway | VisString32 | Gateway when DHCP is disabled. |
## Example
Soap requests and responses sent to and from platform:
```markup
SoapUI
Sander
LianderNetManagement
KAI-0000000053
LianderNetManagement|||KAI-0000000053|||20180925073838432
KAI-0000000053
SoapUI
Sander
LianderNetManagement
LianderNetManagement|||KAI-0000000053|||20180925073838432
KAI-0000000053
OK
RELAY
1
1
TARIFF
2
2
LIGHT
3
3
LIGHT
ETHERNET
1440
192.168.0.110
255.255.0.0
192.168.0.1
true
168.63.97.65
50003
0.nl.pool.ntp.org
true
1440
true
0
0
2019-03-30T23:00:00.000Z
2018-10-27T22:00:00.000Z
```
Platform message of the data read from the device:
```javascript
LogicalDevice: SWDeviceGenericIO
messageType: GetConfiguration {
XSWC1.SwType[ST].stVal: 0
XSWC2.SwType[ST].stVal: 1
XSWC3.SwType[ST].stVal: 1
CSLC.SWCf[CF].LT: RELAY
CSLC.SWCf[CF].adSetOft: 0
CSLC.SWCf[CF].adRiseOft: 0
CSLC.Reg[CF].svrPort: 50003
CSLC.Reg[CF].svrAddr: 168.63.97.65
CSLC.Clock[CF].dstBegT: M3.5.0
CSLC.Clock[CF].dstEndT: M10.5.0
CSLC.Clock[CF].enbDst: true
CSLC.Clock[CF].enbNtpC: true
CSLC.Clock[CF].ntpSvrA: 0.nl.pool.ntp.org
CSLC.Clock[CF].syncPer: 1440
CSLC.IPCf[CF].enbDHCP: true
CSLC.IPCf[CF].ipAddr: 192.168.0.110
CSLC.IPCf[CF].netmask: 255.255.0.0
CSLC.IPCf[CF].gateway: 192.168.0.1
}
```
IEC61850 protocol adapter logging:
```
2018-09-25 07:38:39.006] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/XSWC1.SwType
2018-09-25 07:38:39.058] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/XSWC2.SwType
2018-09-25 07:38:39.074] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/XSWC3.SwType
2018-09-25 07:38:39.091] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.s.c.Iec61850GetConfigurationCommand@apply:90 - Reading the software configuration values
2018-09-25 07:38:39.091] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/CSLC.SWCf
2018-09-25 07:38:39.108] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, LT has value RELAY
2018-09-25 07:38:39.110] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.s.c.Iec61850GetConfigurationCommand@apply:126 - Reading the registration configuration values
2018-09-25 07:38:39.110] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/CSLC.Reg
2018-09-25 07:38:39.129] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, svrAddr has value 168.63.97.65
2018-09-25 07:38:39.129] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.s.c.Iec61850GetConfigurationCommand@apply:144 - Reading the IP configuration values
2018-09-25 07:38:39.130] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/CSLC.IPCf
2018-09-25 07:38:39.146] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, ipAddr has value 192.168.0.110
2018-09-25 07:38:39.146] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, netmask has value 255.255.0.0
2018-09-25 07:38:39.146] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, gateway has value 192.168.0.1
2018-09-25 07:38:39.147] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.s.c.Iec61850GetConfigurationCommand@apply:175 - Reading the clock configuration values
2018-09-25 07:38:39.147] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.h.DeviceConnection@createObjectReference:94 - Device: KAI-0000000053, ObjectReference: SWDeviceGenericIO/CSLC.Clock
2018-09-25 07:38:39.163] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, dstBegT has value M3.5.0
2018-09-25 07:38:39.163] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, dstEndT has value M10.5.0
2018-09-25 07:38:39.163] [osgp-tst-03] [iec61850RequestsMessageListenerContainer-11] INFO o.o.a.p.i.i.n.helper.NodeContainer@getString:88 - Device: KAI-0000000053, ntpSvrA has value 0.nl.pool.ntp.org
```
---
# 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/iec61850/swdevice-010805/getconfiguration.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.