Bir şarj cihazının Heartbeat aralığı, ölçüm gönderme sıklığı, çevrimdışı davranışı ve daha onlarca ayarı OCPP üzerinden uzaktan yönetilebilir. OCPP 1.6J'de bu işin iki aracı vardır: ayarları okumak için GetConfiguration, değiştirmek için ChangeConfiguration. Bu yazıda ikisini ve sahada dikkat edilmesi gereken noktaları anlatıyoruz.

Yapılandırma anahtarları

OCPP 1.6J, cihaz ayarlarını "anahtar = değer" çiftleri olarak tanımlar. Spesifikasyon bir dizi standart anahtar belirler; üreticiler bunlara kendi özel anahtarlarını da ekleyebilir. Bazı standart anahtarlar:

  • HeartbeatInterval: Heartbeat aralığı (saniye).
  • MeterValueSampleInterval: Şarj sırasında ölçüm gönderme aralığı.
  • MeterValuesSampledData: Hangi ölçümlerin gönderileceği.
  • ConnectionTimeOut: Yetkilendirme sonrası kablo takılması için bekleme süresi.
  • LocalAuthorizeOffline: Çevrimdışıyken yerel liste ile yetkilendirme.
  • AuthorizeRemoteTxRequests: Uzaktan başlatmada Authorize yapılıp yapılmayacağı.
  • NumberOfConnectors: Konnektör sayısı (yalnızca okunur).
  • WebSocketPingInterval: WebSocket ping aralığı.

GetConfiguration: ayarları okumak

İstek boş gönderilirse cihaz tüm anahtarları döner. Belirli anahtarlar istenirse yalnızca onları döner.

[2, "10001", "GetConfiguration", {"key": ["HeartbeatInterval", "MeterValueSampleInterval"]}]

Cevapta iki liste vardır:

  • configurationKey: Her anahtar için key, readonly ve value alanları.
  • unknownKey: Cihazın tanımadığı anahtarlar.

Yeni bir cihaz modelini ağa eklerken ilk iş, boş bir GetConfiguration ile tüm anahtarları okuyup kaydetmektir. Bu liste, o modelin neleri desteklediğini ve üreticiye özel hangi ayarları içerdiğini gösterir.

ChangeConfiguration: ayar değiştirmek

[2, "10002", "ChangeConfiguration", {"key": "MeterValueSampleInterval", "value": "60"}]

Dikkat: değer her zaman metin olarak gönderilir, sayı bile olsa. Cihazın olası cevapları:

  • Accepted: Ayar değişti ve hemen geçerli.
  • Rejected: Değer geçersiz veya anahtar salt okunur.
  • RebootRequired: Ayar kaydedildi ama geçerli olması için yeniden başlatma gerekiyor.
  • NotSupported: Anahtar cihazda yok.

RebootRequired cevabında cihazı uygun bir zamanda Soft Reset ile yeniden başlatmanız gerekir; aksi halde ayar etkinleşmez. Bkz. OCPP Reset komutu.

Salt okunur anahtarlar

readonly: true olan anahtarlar değiştirilemez. NumberOfConnectors veya SupportedFeatureProfiles gibi anahtarlar cihazın yeteneklerini bildirir. Bunları değiştirmeye çalışmak Rejected ile sonuçlanır.

Liste değerleri

Bazı anahtarlar virgülle ayrılmış liste alır. Örneğin MeterValuesSampledData için Energy.Active.Import.Register,Power.Active.Import,SoC. Listede cihazın desteklemediği bir ölçüm varsa tüm değişiklik reddedilebilir. Ayrıntılar: MeterValuesSampledData.

İyi uygulama: model bazlı şablonlar

Her cihazı tek tek yapılandırmak hem zaman alır hem de tutarsızlık yaratır. Daha iyi yöntem:

  1. Her cihaz modeli için önerilen ayarları içeren bir şablon hazırlayın.
  2. Yeni cihaz BootNotification ile bağlandığında şablonu otomatik uygulayın.
  3. Periyodik olarak GetConfiguration ile ayarların değişmediğini doğrulayın.
  4. Firmware güncellemesinden sonra ayarları yeniden kontrol edin; bazı güncellemeler varsayılanlara döndürür.

OCPP 2.0.1 ve 2.1'de ne değişti?

Yeni sürümlerde düz anahtar listesi yerine cihaz modeli kullanılır. Ayarlar bileşen ve değişken olarak tanımlanır; okuma ve yazma GetVariables ve SetVariables ile yapılır, tüm yapılandırmanın raporu ise GetBaseReport ile istenir. Ayrıntılar için SetVariables ve GetVariables yazımıza bakabilirsiniz.

Sık karşılaşılan hatalar

  • Değeri sayı olarak göndermek: "value": 60 yerine "value": "60" olmalıdır. Bazı cihazlar sayıyı FormationViolation ile reddeder.
  • Büyük/küçük harf farkı: Anahtar adları birebir yazılmalıdır; heartbeatinterval ile HeartbeatInterval farklıdır.
  • Üreticiye özel anahtarları tahmin etmek: Belgelenmemiş bir anahtarı değiştirmek, cihazda öngörülemeyen davranışlara yol açabilir.
  • Değişikliği doğrulamamak: ChangeConfiguration'dan sonra aynı anahtarı GetConfiguration ile tekrar okumak, değerin gerçekten uygulandığını gösterir.

Sonuç

GetConfiguration ve ChangeConfiguration, OCPP 1.6J cihazları uzaktan yönetmenin temel araçlarıdır. Değerlerin metin olarak gönderildiğini, salt okunur anahtarların değiştirilemeyeceğini ve RebootRequired cevabının bir reset gerektirdiğini unutmayın. Üreticy'nin OCPP yazılımı, cihaz yapılandırmasını panelden okumanızı ve değiştirmenizi sağlar; tüm komutların sonucu kayıt altında tutulur.