Documentație

API HTTP

Următoarele funcții oferă o corespondență între registrele Modbus și HTTP.
Notă: Nu este necesar ca Modbus să fie activ pentru a utiliza API HTTP.

Utilizați o cerere HTTP GET sau POST la adresa controlerului de încărcare cFos, de exemplu
http://192.168.2.111/cnf?cmd=modbus&device=meter1&read=35154.
Răspunsurile sunt în format JSON.

  • cmd este întotdeauna modbus
  • dispozitiv = metru1 sau metru2 sau evse
  • read = adresa registrului de citit
  • write = adresa registrului de citit
  • value = valoarea de scris
  • values = matrice de valori de scris, de exemplu [1,2,3,4]

Adresele pot avea un sufix pentru a specifica tipul de date (valoarea implicită este de 16 biți întregi):

  • d = număr întreg de 32 de biți (2 registre modbus)
  • q = număr întreg de 64 de biți (4 registre modbus)
  • s = șir de caractere
controler de încărcare cFos - Registrele Modbus

Iată câteva exemple de utilizare a API HTTP

Modbus

/cnf?cmd=modbus&device=meter1&read=8002
Răspuns:
1

/cnf?cmd=modbus&device=meter1&read=8062d
Răspuns:
-1

/cnf?cmd=modbus&device=meter1&read=8016s
Răspuns:
"cFos Power Brain"

/cnf?cmd=modbus&device=meter1&read=8002&count=10
Răspuns:
[1,257,256,0,256,0,26211,26165,11619,13366]

/cnf?cmd=modbus&device=meter2&read=all
Răspuns:
{"8000d":-821755904,"8002":1,"8003":257,"8004":16777216,"8006":256,"8007":0,"8008s":"fcf5-c46d-310c","8016s":"cFos Power Brain","8040":41,"8041":1,"8042d":1000,"8044":1,"8045":230,"8046":230,"8047":230,"8050q":0,"8054d":0,"8056":0,"8057":0,"8058q":0,"8062d":-1,"8064d":0,"8066d":0,"8068d":0,"8070":0,"8071":0,"8120d":0}

/cnf?cmd=modbus&device=evse&write=8044&value=7
Răspuns:
"ok"

/cnf?cmd=modbus&device=evse&write=8050q&value=1"
Răspuns:
"ok"

/cnf?cmd=modbus&device=evse&write=8044d&value=1"
Răspuns:
"bad modbus register size"

/cnf?cmd=modbus&device=evse&write=8044&values=[7,230,230,230 ]
Răspuns:
"ok"

Cereri generale

Solicită starea tuturor dispozitivelor Charging Manager:
/cnf?cmd=get_dev_info

Setarea unui cod PIN sau RFID:
/cnf?cmd=enter_rfid&rfid=r&dev_id=d
r este PIN-ul sau RFID (cifre), d este un ID de dispozitiv opțional pentru a selecta un anumit EVSE. Dacă nu se selectează niciun ID de dispozitiv, Charging Manager încearcă să atribuie automat PIN-ul sau RFID-ul.

Suprascriere pentru tranzacția curentă:
/cnf?cmd=override_device&dev_id=d&flags=f&mamps=ma&rfid=id
d este ID-ul dispozitivului, id este un cod RFID/PIN, eventual necesar, și stegulețe, după cum urmează:
"C": Dezactivează încărcarea (este necesar un cod de utilizator sau un cod PIN/RFID de utilizator)
"c": Dezactivarea din nou a încărcării (este necesară parola de administrator sau codul PIN/RFID al utilizatorului)
"E": Dezactivarea regulilor de încărcare EVSE (este necesară parola de administrator)
"e": Dezactivarea din nou a regulilor de încărcare a EVSE (este necesar pwd-ul administratorului)
'U': Deactivate user's charging rules (user RFID/PIN required)
'u': Deactivate user's charging rules again (user RFID/PIN required)

Steagurile astfel setate rămân până când mașina este deconectată de la EVSE.

mamps=ma: Suprascrie (limitează) curentul de încărcare cu ma mA.

Setarea contorului de energie simulat:
/cnf?cmd=soft_meter&dev_id=d&val=v
v (opțional) este energia care urmează să fie setată în Wh/VAh. Dacă v nu este prezent, contorul este doar citit. d este ID-ul dispozitivului EVSE. Valoarea returnată este vechea citire a contorului înainte de setare.

Contoare HTTP și EVSE-uri

Contor

Puteți crea un contor (tip de dispozitiv "HTTP Input") care nu este citit de Charging Manager, dar ale cărui valori curente pot fi specificate din exterior prin HTTP POST sau GET:
/cnf?cmd=set_ajax_meter&dev_id=x
x este ID-ul dispozitivului, așa cum apare în configurația dispozitivului, de exemplu M1.

Corpul POST conține un obiect JSON, după cum urmează:

{
            "model": string,
            "import_vah": number,
            "export_wh": number,
            "voltage": [v1, v2, v3],
            "current": [c1, c2, c3],
            "power_w": number
            "is_va": bool
         }

Aici, valorile energetice sunt exprimate în Wh, tensiunile în V, curenții în mA și puterile în W. "model" este șirul de modele, așa cum se arată în dale.

Unii dintre utilizatorii noștri (#diebestenuserderwelt) folosesc instrumentul curl pentru a furniza date contorului, de exemplu:
curl -i -X POST -H 'Content-Type: application/json' -d '{ "model": "TestModell", "import_wh": 12345, "export_wh": 23456, "voltage": [231, 232, 233], "current": [10001, 10002, 10003] }' --user admin:1234abcd 'http://192.168.2.111/cnf?cmd=set_ajax_meter&dev_id=M3'

Ca și HTTP GET, cererea este scrisă astfel:
http://192.168.2.111/cnf?cmd=set_ajax_meter&dev_id=M3&model=TestModell&import_wh=12345&export_wh=23456&voltage=231,232,233&current=10001,10002,10003

Iată o altă postare pe forum despre conectarea unui contor inteligent folosind contoare de intrare cFos HTTP și ioBroker.

EVSE

De asemenea, puteți crea un wallbox (tip de dispozitiv "HTTP Input") care nu este citit sau controlat de Charging Manager, dar ale cărui valori pot fi specificate din exterior prin HTTP POST sau GET. Valorile de control sunt apoi returnate ca răspuns:
/cnf?cmd=set_ajax_evse&dev_id=x
x este ID-ul dispozitivului, așa cum apare în configurația dispozitivului, de exemplu, E1.

Corpul POST conține un obiect JSON, după cum urmează:

{
            "state": number,
            "max_charging_current": number,
            "current": [c1, c2, c3],
            "total_energy": number,
            "model": string,
            "rfid": string
         }

"model" este șirul de caractere al modelului, așa cum se arată în dale. Cu "rfid" se poate adăuga un RFID la procesul de încărcare, valorile energiei sunt date în Wh, iar curenții în mA. "state" are următoarele valori:
1 = în așteptare (A), 2 = VE prezent (B), 3 = încărcare (C), 4 = încărcare cu ventilație (D), 5 = eroare (E)

Ca și HTTP GET, cererea este scrisă astfel:
http://192.168.2.111/cnf?cmd=set_ajax_evse&dev_id=M3&model=TestModell&state=st&max_charging_current=m&current=c1,c2,c3&total_energy=t&rfid=r

Ca răspuns, această cerere returnează următorul obiect JSON:

{
             "device_enabled": true/false, // dispozitivul este activat/dezactivat
             "charging_enabled": true/false, // încărcare permisă / nepermisă
             "paused": true/false, // true = dispozitivul este temporar în pauză
             "charging_current": number // curent de încărcare specificat în mA
         }

Acest obiect de retur trebuie evaluat de către apelant și EVSE trebuie să fie setat în consecință, de exemplu, curentul de încărcare trebuie modificat în consecință.

Interfață web

Toate cererile returnează un răspuns în format JSON. Valorile etichetate r/o sunt numai pentru citire. Vă rugăm să rețineți: nu garantăm stabilitatea acestei API. Funcționalitatea, parametrii, valorile etc. pot fi modificate fără notificare prealabilă.

Obțineți informații despre echilibrarea sarcinii și toate dispozitivele

/cnf?cmd=get_dev_info
Valori de returnare (exemplu):
         {
         "params" : {
         "title" : "cFos Power Brain",
         "desc" : "Standard-Konfiguration",
         "max_total_current" : 32000,   // total installed power in mA
         "reserve_current" : 0,   // reserve in mA (subtracted from max_total_current)       
         "overdraft_cur" : 0,       // generated overdraft in mA, can be set to 0
         "max_total_evse_current" : 0,   // max current available to all EVSEs in mA
         "cons_evse_power" : 0,    // r/o, consumed EVSE power in W
         "avail_evse_power" : 32000,   // r/o, available EVSE power in W
         "lb_enabled" : false,   // true: load balancing enabled, false: disabled (observation mode)
         "disable_policy" : 1,   // on device disable: 0 disable EVSE, 1 use min. charging current, -1 remove charging current limit (free charging)
         "cycle_time" : 3009,   // current update cycle time in msec
         "max_evses" : 3,   // maximum number of licensed EVSEs
         "shareware_mode" : false,   // false, if licensed, true if trial version
         "version" : "1.8.1095",
         "time" : 1645281534,   // current time stamp
         "vsn" : 
         {
         "vendorid" : 52997,   // cFos
         },
         "ocpp_gateway_license_cnt" : 0,  // number of licensed OCPP gateways
         "ocpp_gateway_licenses_used" : 0   // number of used OCPP gateways
         },
         "devices" : [   // array of configured devices
         {
         "dev_type" : "evse_powerbrain",   // a sample EVSE
         "device_enabled" : 1,   // 1 = device enabled, 0 = disabled
         "name" : "Wallbox",   // config item: name
         "address" : "evse",   // address: URL, IP address or COM Port + Parameters
         "id" : 1,   // Modbus ID
         "dev_id" : "E1",   // unique device ID, EVSE always begin with E
         "number" : 1,   // config item: number
         "desc" : "cFos Power Brain Wallbox 11kW",   // config item: description
         "com_err" : false,   // true, if active communication error
         "com_err_secs" : 1404660,   // time since last com error
         "com_errors" : 0,   // number of com errors
         "last_error" : "",   // text of last error
         "is_evse" : true,   // true for EVSEs, false for meters
         "used_phases" : 0,   // 0=determine, otherwise bitfield: bit0 L1, bit1 L2, bit2 L3
         "label" : "",   // config item: text displayed when plugged in
         "min_charging_cur" : 6000,   // minimum charging current in mA
         "max_charging_cur" : 11040,   // maximum charging current in mA or expression
         "prio" : 1,   // charging priority
         "charging_enabled" : true,   // r/o, true if charging allowed
         "cur_charging_power" : 0,   // r/o, current charging power in W
         "total_energy" : 7120572,   // r/o, total used charging energy in Wh
         "phases" : 0,   // currently used phases, bitfield: bit0 L1, bit1 L2, bit2 L3
         "state" : 1,   // 1 = waiting for EV, 2 = EV presend, 3 = charging, 4 = charging/vent, 5 = error, 6 = offline
         "model" : "cFos Power Brain,1.0,1.8.1095,6d-31-0c",   // r/o, model string: Manufacturer,device,device version, firmware version, serial number
         "paused" : false,   // true, if device paused due to energy shortage or phase imbalance
         "pause_time" : 300,   // current elapsed pause time in secs
         "pause_min_time" : 300,   // min. secs before end of pause
         {
         "dev_type" : "meter_powerbrain",  // a sample meter
         "device_enabled" : 1,   // 1 = device enabled, 0 = disabled
         "name" : "S0 Zähler 1",   // config item: name
         "address" : "meter1",   // address: URL, IP address or COM Port + Parameters
         "id" : 2,   // Modbus ID
         "dev_id" : "M1",   // unique device ID, meters always begin with M
         "number" : 1,   // config item: number
         "desc" : "cFos Power Brain, S0 Zähler 1",   // config item: description
         "com_err" : false,   // true, if active communication error
         "com_err_secs" : 1404660,   // time since last com error
         "com_errors" : 0,   // number of com errors
         "last_error" : "",   // text of last error
         "is_evse" : true,   // true for EVSEs, false for meters
         "used_phases" : 0,   // 0=determine, otherwise bitfield: bit0 L1, bit1 L2, bit2 L3
         "is_va" : false,   // true if display is VA, false for W
         "invert" : false,   // if true, current and power values are inverted
         "import" : 15,   // imported energy in Wh
         "export" : 0,   // exported energy in Wh
         "power_w" : 0,   // current active power in W
         "current_l1" : 0,   // current L1 in mA
         "current_l2" : 0,   // current L2 in mA
         "current_l3" : 0,   // current L3 in mA
         "voltage_l1" : 230,   // Voltage L1 in V
         "voltage_l2" : 230,   // Voltage L2 in V
         "voltage_l3" : 230,   // Voltage L31 in V
         "role" : 0,   // 0 = display, 1 = consumption, 2 = production, 3 = grid demand, 4 = vehicle consumption, 5 = storage
         "model" : "cFos Power Brain,1.0,1.8.1095,6d-31-0c"   // r/o, model string: Manufacturer,device,device version, firmware version, serial number
         }
         ]
         }
                  

Setați/citiți parametrii Charging Manager

/cnf?cmd=get_params
/cnf?cmd=set_params

HTTP GET get_params returnează un obiect JSON,
HTTP POST set_params necesită un obiect JSON în textul mesajului

Valori de returnare (exemplu):
         //         see values for get_dev_info.
         //        In Addition there is a device meta struct to allow for selection of device types:
         "dev_meta": 
         {
         "evse_powerbrain" : "cFos Power Brain",   // EVSE device type : name
         "evse_mennekes_modbus" : "Heidelberg Energy Control",
         "meter_elenker_meter" : "ModbusMeter 5A",   // meter device type : name
         "meter_kostal_powermeter" : "Kostal Powermeter",
         "meter_orno_we516" : "Orno OR-WE-516",
         }         
                  

Setați setările dispozitivului

/cnf?cmd=set_params
POST date utilizator (exemplu):
         {
            devices: [   // array of device objects, currently may only contain 1 device
            {   // for most of the device properties, see get_dev_info
         attach: ""   // device ID of an attached meter
         battery_save_threshold: 0   // in mA, if charging current falls below this threshold, charging will be stopped, 0 = disable
         charging_rules: [   // array of charging rules
         // charging rules are work in progress, expect frequent changes to their object layout.
         {
            "days": d,     // d is a bitfields a weekdays: bit0 Monday...bit6 Sunday
            "mode": m,     // m mode of the rule: 0=absolule current, 1=relative current, 2=current solar current, 3=relative current solar current, 4=solar current minus current value, 5=solar surplus
            "current": c,  // c current in mA
            "enabled": e,  // e = true for an active rule, false for ignored rules
            "udur": u,     // u = undercut duration in secs
            "time": t      // t in minutes after midnight (for time based rules)
            "dur":  dur    // dur in minutes (for time based rules)
            "expr": expr   // expr is evaluated to determine the rule current (for expression rules)
            "input": in    // in = string specifying the input and level (for input based rules)
            "price_level", p   // p = price level (for cost baseed rules)
            "solar": s     // solar current in mA (for solar based rules)
         }
         ]
         enable_snooze: true   // true, allow device snooze
         enable_wakeup: true   // true, allow device wakeup for charging
         fixed_rfid: ""   // use fixed RFID for OCPP
         group: 0   // device belongs to this group, 0 = main group
         ocpp_gateway_client_id: "CP42"
         phase_rotation: 0
         soft_meter: 7120572   // estimated charged energy in W (if device has no meter)
         users: ["1170223812"]   // array of user ids which are allowed to charge at this EVSE
            ]
         }
                  

Benutzerinformationen setzen/auslesen

/cnf?cmd=get_users
/cnf?cmd=get_user
/cnf?cmd=set_user

get_user recuperează un singur obiect de utilizator,
set_user postează un singur obiect de utilizator,
get_users recuperează o matrice de obiecte de utilizator
set_user poate fi apelat fără o parolă de administrator dacă conține un ID de utilizator valid. Crearea de noi utilizatori necesită acces de administrator

Valori de returnare (exemplu):
         [   // array of users
         {
         "id" : "2167520770",   // unique user ID
         "name" : "wusel",   // name
         "display" : true,   // true if user may be displayed while plugged in
         "dev_ids" :    // EVSEs the user may use
         [
         "E1"
         ],
         "rfids" : 
         [   // array of RFIDs
         {
         "id" : "4711",   // RFID / PIN
         "name" : "TeSt",   // Name
         "ac_auth" : true,   // true: used to authorize
         "ac_ovch" : false,  // true: used to stop charging
         "used_phases" : 7   // used to override used phases, 0 = don't override
         }
         ],
         "charging_rules" : 
         [   // array of charging rules for this user
         ]
         }
         ]
                  

Acceptarea licenței

/cnf?cmd=accept_license&acc=1&allow_usage_stats=a
a = 1 permite raportarea statisticilor de utilizare către cFos eMobililty, a = 0 interzice acest lucru

Modificarea parolei de administrator

/cnf?cmd=change_admin_pwd&old_pwd=alt&new_pwd=neu
old, new sunt parola veche și cea nouă de administrator

Ștergeți un dispozitiv

/cnf?cmd=del_device&dev_id=d
d este un ID de dispozitiv valid

Recuperarea unui ID unic de utilizator (pentru a crea un nou utilizator)

/cnf?cmd=get_new_user_id
returnează un nou ID de utilizator sub forma unui șir JSON

Resetarea unui dispozitiv

/cnf?cmd=reset_device&dev_id=d
d este un ID de dispozitiv valid. Dispozitivul este șters și recreat

Pornirea/oprirea înregistrării diagnosticului

/cnf?cmd=set_diag_logging&enable=e
e = 1 pentru a începe, e = 0 pentru a opri înregistrarea diagnosticului. Funcționează timp de 5 minute dacă nu este oprit