Yönerge Ekle (Obis Yazma)

Haberleşme ünitesine bir yönerge tanımlayacak komuttur.

directive içerisindeki adımlar iki alan içerir:

• operation: Bu adımda haberleşme ünitesinin yapacağı işin adıdır.
• parameter: Yukarıdaki işi yaparken haberleşme ünitesinin kullanacağı parametrik değerdir.
  • Parametrik değer operationın cinsine göre değişir.

Çalışma Zamanı

Haberleşme merkezi yazılımı tarafından komut gönderildiğinde çalışır.

Çalışma Şekli

Push

Bu fonksiyon için push olarak çalışma desteklenmemektedir.

Pull

1. Haberleşme merkezi yazılımı, haberleşme ünitesine directive - add komutu gönderir.
2. Haberleşme ünitesi isteği aldığına dair haberleşme merkezi yazılımına ACK mesajı gönderir.

Mesaj Formatları

Protokol genel formatı dahilinde haberleşme sağlanır.

• paremeteralanındaki parametrelerin nasıl kullanılacağı yazma sayfasında anlatılmıştı.

directive-add talebi

{
  "device": {
    "flag": "XYZ",
    "serialNumber": "0123456789ABCDE"
  },
  "function": "directive",
  "referenceId": "3d0b242e-1866-4a41-a8ca-1372f1b34ab7",
  "request": {
    "operation": "add",
    "directives": [
      {
        "id": "WriteDirective1",
        "steps": [
          {
            "order" : 1,
            "operation": "setBaud",
            "parameter": 300
          },
          {
            "order" : 2,
            "operation": "setFraming",
            "parameter": "7E1"
          },
          {
            "order" : 3,
            "operation": "sendData",
            "parameter": [47, 63, "METERSERIALNUMBER", 33, 13, 10]
          },
          {
            "order" : 4,
            "operation": "wait",
            "parameter": 10
          },
          {
            "order" : 5,
            "operation": "readData",
            "parameter": "id"
          },
          {
            "order" : 6,
            "operation": "sendData",
            "parameter": [6, 48, 54, 49, 13, 10]
          },
          {
            "order" : 7,
            "operation": "setBaud",
            "parameter": 19200
          },
          {
            "order" : 8,
            "operation": "wait",
            "parameter": 10
          },
          {
            "order" : 9,
            "operation": "sendData",
            "parameter": "PASSWORD"
          },
          {
            "order" : 10,
            "operation": "readData",
            "parameter": "passResponse"
          },
          {
            "order" : 11,
            "operation": "wait",
            "parameter": 10
          },
          {
            "order" : 12,
            "operation": "sendData",
            "parameter": "DATA"
          },
          {
            "order" : 13,
            "operation": "readData",
            "parameter": "obisResponse"
          },
          {
            "order" : 14,
            "operation": "wait",
            "parameter": 10
          },
          {
            "order" : 15,
            "operation": "sendData",
            // "parameter": "<SOH>B0<ETX><XOR>"
            "parameter" : [1 66 48 3 113]
          },
        ]
      }
    ]
  }
}

Parametre	Veri Tipi	Zorunluluk	Açıklama
id	string	Zorunlu	Listelenmesi istenen yönergenin id'si. Request'te id girilirse cevapta sadece bir yönerge dönebilir
operation	string	Zorunlu	Bu adımda haberleşme ünitesinin yapacağı işin adıdır
parameter	string	Zorunlu	Yukarıdaki işi yaparken haberleşme ünitesinin kullanacağı parametrik değerdir
setBaud	string	Opsiyonel	Haberleşme ünitesi-ölçüm cihazı arası haberleşmenin baud değerinin belirlenmesi
setFraming	string	Opsiyonel	Haberleşme ünitesi-ölçüm cihazı arası haberleşmenin frame değerinin belirlenmesi
sendData	string	Opsiyonel	Ölçüm cihazına komut gönderilmesi işlemi, gönderilecek veri parameter alanında
readData	string	Opsiyonel	Ölçüm cihazından veri okunması işlemi, parametre değeri ise okunan verinin atanacağın değişken
wait	string	Opsiyonel	Haberleşme ünitesinin haberleşmeye ara verip beklemede kalması, bekleme miktarı parameter alanında