arrow-left

All pages
gitbookPowered by GitBook
1 of 7

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Installation

Describes the actions as defined in

SmartMeteringInstallation.wsdlarrow-up-right

AddDevice

hashtag
Description

AddDevice is a request to add a device to the OSGP database. For the list of parameters, see the .xsd file (link below).

All requests have similar response behaviour which is described in ResponseMessages

GetAddDeviceResponse returns if the result is successful from the request. The response contains the DeviceIdentification and CorrelationUid which is received from the AddDevice request.

hashtag
References

XSD:

WSDL:

hashtag
Example scenario

hashtag
Example XML Message

GetCoupleMbusDeviceResponse

hashtag
Description

GetCoupleMbusDeviceResponse returns if the result is successful from the CoupleMbusDevice request. The response contains the DeviceIdentification and CorrelationUid which is received from the request.

All requests have similar response behaviour which is described in .

hashtag
References

XSD: sm-installation.xsdarrow-up-right

WSDL: SmartMeteringInstallation.wsdlarrow-up-right

CoupleMbusDevice
ResponseMessages
sm-installation.xsdarrow-up-right
SmartMeteringInstallation.wsdlarrow-up-right
  Scenario: Add a new device
    When receiving a smartmetering add device request
      | DeviceIdentification  | TEST1024000000001 |
      | DeviceType            | SMART_METER_E  |
      | CommunicationMethod   | GPRS  |
      | CommunicationProvider | KPN   |
      | ICC_id                | 1234  |
      | DSMR_version          | 4.2.2 |
      | Supplier              | Kaifa |
      | HLS3_active           | false |
      | HLS4_active           | false |
      | HLS5_active           | true  |
      | Master_key            | m_key |
      | Authentication_key    | a_key |
      | Encryption_key        | e_key |
    Then the get add device response should be returned
      | DeviceIdentification  | TEST1024000000001 |
      | Result                | OK                |
    And the dlms device with identification "TEST1024000000001" exists
    And a request to the device can be performed after activation
    And the stored keys are not equal to the received keys
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.opensmartgridplatform.org/schemas/common/2014/10" xmlns:ns1="http://www.opensmartgridplatform.org/schemas/smartmetering/sm-installation/2014/10">
   <soapenv:Header>
      <ns:ApplicationName>AutomaticTest</ns:ApplicationName>
      <ns:UserName>SoapUI</ns:UserName>
      <ns:OrganisationIdentification>test-org</ns:OrganisationIdentification>
   </soapenv:Header>
   <soapenv:Body>
      <ns1:AddDeviceRequest>
         <ns1:Device>
            <!--Optional:-->
            <ns1:Device_Identification>TEST1024000000001</ns1:Device_Identification>
            <!--Optional:-->
            <ns1:Device_type>SMART_METER_E</ns1:Device_type>
            <!--Optional:-->
            <ns1:Communication_method>GPRS</ns1:Communication_method>
            <!--Optional:-->
            <ns1:Communication_provider>KPN</ns1:Communication_provider>
            <!--Optional:-->
            <ns1:ICC_id>icc_id</ns1:ICC_id>
            <!--Optional:-->
            <ns1:DSMR_version>4.2.2</ns1:DSMR_version>
            <!--Optional:-->
            <ns1:Supplier>Kaifa</ns1:Supplier>
            <!--Optional:-->
            <ns1:HLS3_active>false</ns1:HLS3_active>
            <!--Optional:-->
            <ns1:HLS4_active>false</ns1:HLS4_active>
            <!--Optional:-->
            <ns1:HLS5_active>true</ns1:HLS5_active>
            <!--Optional:-->
            <ns1:Master_key>m_key</ns1:Master_key>
            <!--Optional:-->
            <ns1:Global_encryption_unicast_key>e_key</ns1:Global_encryption_unicast_key>
            <!--Optional:-->
            <ns1:Authentication_key>a_key</ns1:Authentication_key>
            <ns1:Delivery_date>2017-05-17 06:16:57.07</ns1:Delivery_date>
         </ns1:Device>
      </ns1:AddDeviceRequest>
   </soapenv:Body>
</soapenv:Envelope>

GetAddDeviceResponse

hashtag
Description

GetAddDeviceResponse returns if the result is successful from the AddDevice request. The response contains the DeviceIdentification and CorrelationUid which is received from the AddDevice request.

All requests have similar response behaviour which is described in ResponseMessages.

hashtag
References

XSD:

WSDL:

DeCoupleMbusDevice

hashtag
Description

DeCoupleMbusDevice is a request to decouple an Mbus device (such as a gas meter) from a device to the OSGP database. The request needs the following parameters:

  • DeviceIdentification

  • MbusDeviceIdentification

All requests have similar response behaviour which is described in

returns if the result is successful from the request. The response contains the DeviceIdentification and CorrelationUid which is received from the DeCoupleMbusDevice request.

hashtag
References

XSD:

WSDL:

GetDeCoupleMbusDeviceResponse

hashtag
Description

GetDeCoupleMbusDeviceResponse returns if the result is successful from the DeCoupleMbusDevice request. The response contains the DeviceIdentification and CorrelationUid which is received from the DeCoupleMbusDevice request.

All requests have similar response behaviour which is described in ResponseMessages.

hashtag
References

XSD:

WSDL:

CoupleMbusDevice

hashtag
Description

CoupleMbusDevice is a request to couple a gateway and a m-bus device. The request needs the following parameters:

  • DeviceIdentification

  • MbusDeviceIdentification

  • Force

All requests have similar response behaviour which is described in

If Force has value true, the check if Mbus device is connected to other device will be ignored

returns if the result is successful from the request. The response request contains the DeviceIdentification and CorrelationUid which is received from the CoupleMbusDevice request.

hashtag
References

XSD:

WSDL:

sm-installation.xsdarrow-up-right
SmartMeteringInstallation.wsdlarrow-up-right
ResponseMessages
GetDeCoupleMbusDeviceResponse
sm-installation.xsdarrow-up-right
SmartMeteringInstallation.wsdlarrow-up-right
sm-installation.xsdarrow-up-right
SmartMeteringInstallation.wsdlarrow-up-right
ResponseMessages
GetCoupleMbusDeviceResponse
sm-installation.xsdarrow-up-right
SmartMeteringInstallation.wsdlarrow-up-right