HTTP API

Οι ακόλουθες λειτουργίες παρέχουν μια αντιστοίχιση των καταχωρητών Modbus σε HTTP.
Σημείωση: Το Modbus δεν χρειάζεται να είναι ενεργό για να χρησιμοποιήσετε το API HTTP.

Χρησιμοποιήστε ένα αίτημα HTTP GET ή POST στη διεύθυνση του ελεγκτή χρέωσης cFos, π.χ.
http://192.168.2.111/cnf?cmd=modbus&device=meter1&read=35154.
Οι απαντήσεις είναι σε JSON.

• cmd είναι πάντα modbus
• συσκευή = meter1 ή meter2 ή evse
• read = διεύθυνση του καταχωρητή προς ανάγνωση
• write = διεύθυνση του καταχωρητή προς ανάγνωση
• value = τιμή προς εγγραφή
• values = πίνακας τιμών προς εγγραφή, π.χ. [1,2,3,4]

Οι διευθύνσεις μπορούν να έχουν μια κατάληξη για τον προσδιορισμό του τύπου δεδομένων (προεπιλογή είναι ακέραιος 16 bit):

• d = ακέραιος αριθμός 32 bit (2 καταχωρητές modbus)
• q = ακέραιος αριθμός 64 bit (4 καταχωρητές modbus)
• s = συμβολοσειρά

Ακολουθούν μερικά παραδείγματα χρήσης του API HTTP

Modbus

/cnf?cmd=modbus&device=meter1&read=8002
Απάντηση:
1

/cnf?cmd=modbus&device=meter1&read=8062d
Απάντηση:
-1

/cnf?cmd=modbus&device=meter1&read=8016s
Απάντηση:
"cFos Power Brain"

/cnf?cmd=modbus&device=meter1&read=8002&count=10
Απάντηση:
[1,257,256,0,256,0,26211,26165,11619,13366]

/cnf?cmd=modbus&device=meter2&read=all
Απάντηση:
{"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
Απάντηση:
"ok"

/cnf?cmd=modbus&device=evse&write=8050q&value=1"
Απάντηση:
"ok"

/cnf?cmd=modbus&device=evse&write=8044d&value=1"
Απάντηση:
"bad modbus register size"

/cnf?cmd=modbus&device=evse&write=8044&values=[7,230,230,230 ]
Απάντηση:
"ok"

Γενικά αιτήματα

Ζητήστε την κατάσταση όλων των συσκευών Charging Manager:
/cnf?cmd=get_dev_info

Ρύθμιση PIN ή RFID:
/cnf?cmd=enter_rfid&rfid=r&dev_id=d
r είναι το PIN ή το RFID (ψηφία), d είναι ένα προαιρετικό αναγνωριστικό συσκευής για την επιλογή ενός συγκεκριμένου EVSE. Εάν δεν έχει επιλεγεί αναγνωριστικό συσκευής, ο Διαχειριστής φόρτισης προσπαθεί να εκχωρήσει το PIN ή το RFID αυτόματα.

Αντικατάσταση για την τρέχουσα συναλλαγή:
/cnf?cmd=override_device&dev_id=d&flags=f&mamps=ma&rfid=id
d είναι το αναγνωριστικό της συσκευής, id είναι ένας ενδεχομένως απαιτούμενος αριθμός RFID/PIN, σημαίες, ως εξής:
"C": Απενεργοποίηση χρέωσης (απαιτείται κωδικός πρόσβασης διαχειριστή ή PIN χρήστη/RFID)
'c': Απενεργοποίηση χρέωσης ξανά (απαιτείται admin pwd ή User PIN/RFID)
'E': Απενεργοποίηση κανόνων φόρτισης EVSE (απαιτείται Admin pwd)
'e': Απενεργοποίηση κανόνων φόρτισης EVSE ξανά (απαιτείται κωδικός πρόσβασης διαχειριστή)
'U': Απενεργοποίηση των κανόνων φόρτισης του χρήστη (απαιτείται RFID/PIN χρήστη)
'u': Deactivate user's charging rules again (user RFID/PIN required)

Οι σημαίες που τίθενται με αυτόν τον τρόπο παραμένουν μέχρι να αποσυνδεθεί το αυτοκίνητο από το EVSE.

mamps=ma: Αντικατάσταση (όριο) του ρεύματος φόρτισης με ma mA.

Ρύθμιση του προσομοιωμένου μετρητή ενέργειας:
/cnf?cmd=soft_meter&dev_id=d&val=v
v (προαιρετικό) είναι η ενέργεια που πρέπει να ρυθμιστεί σε Wh/VAh. Εάν το v δεν υπάρχει, ο μετρητής διαβάζεται μόνο. d είναι το αναγνωριστικό συσκευής του EVSE. Η τιμή επιστροφής είναι η παλαιά ένδειξη του μετρητή πριν από τη ρύθμιση.

Μετρητές HTTP και EVSE

Μετρητής

Μπορείτε να δημιουργήσετε έναν μετρητή (τύπος συσκευής 'HTTP Input') που δεν διαβάζεται από τη Διαχείριση χρέωσης, αλλά του οποίου οι τρέχουσες τιμές μπορούν να καθοριστούν εξωτερικά μέσω HTTP POST ή GET:
/cnf?cmd=set_ajax_meter&dev_id=x
x είναι το αναγνωριστικό της συσκευής όπως φαίνεται στη διαμόρφωση της συσκευής, π.χ. M1.

Το σώμα POST περιέχει ένα αντικείμενο JSON, ως εξής:

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

Εδώ, οι τιμές ενέργειας δίνονται σε Wh, οι τάσεις σε V, τα ρεύματα σε mA και οι ισχύι σε W. "model" είναι η συμβολοσειρά του μοντέλου όπως φαίνεται στα πλακίδια.

Ορισμένοι από τους χρήστες μας (#diebestenuserderwelt) χρησιμοποιούν το εργαλείο curl για να τροφοδοτήσουν τον μετρητή με δεδομένα, π.χ.:
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'

Ως HTTP GET η αίτηση γράφεται ως εξής:
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

Εδώ είναι μια άλλη δημοσίευση στο φόρουμ σχετικά με τη σύνδεση ενός έξυπνου μετρητή χρησιμοποιώντας μετρητές εισόδου cFos HTTP και ioBroker.

EVSE

Μπορείτε επίσης να δημιουργήσετε ένα wallbox (τύπος συσκευής "HTTP Input") που δεν διαβάζεται ούτε ελέγχεται από τη Διαχείριση φόρτισης, αλλά του οποίου οι τιμές μπορούν να καθοριστούν εξωτερικά με χρήση HTTP POST ή GET. Οι τιμές ελέγχου επιστρέφονται στη συνέχεια ως απάντηση:
/cnf?cmd=set_ajax_evse&dev_id=x
x είναι το αναγνωριστικό της συσκευής όπως φαίνεται στη διαμόρφωση της συσκευής, π.χ. E1.

Το σώμα POST περιέχει ένα αντικείμενο JSON, ως εξής:

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

"model" είναι η συμβολοσειρά του μοντέλου όπως φαίνεται στα πλακίδια. Με το "rfid" μπορείτε να προσθέσετε ένα RFID στη διαδικασία φόρτισης, οι τιμές ενέργειας δίνονται σε Wh, τα ρεύματα σε mA. "state" έχει τις ακόλουθες τιμές:
1 = αναμονή (Α), 2 = EV παρόν (Β), 3 = φόρτιση (Γ), 4 = φόρτιση με εξαερισμό (Δ), 5 = σφάλμα (Ε)

Ως HTTP GET η αίτηση γράφεται ως εξής:
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

Ως απάντηση, η αίτηση αυτή επιστρέφει το ακόλουθο αντικείμενο JSON:

{
             "device_enabled": true/false, // η συσκευή είναι ενεργοποιημένη/απενεργοποιημένη
             "charging_enabled": true/false, // η χρέωση επιτρέπεται / δεν επιτρέπεται
             "paused": true/false, // true = η συσκευή είναι προσωρινά σε παύση
             "charging_current": number // καθορισμένο ρεύμα φόρτισης σε mA
         }

Αυτό το αντικείμενο επιστροφής πρέπει να αξιολογηθεί από τον καλούντα και το EVSE πρέπει να ρυθμιστεί αναλόγως, π.χ. το ρεύμα φόρτισης πρέπει να αλλάξει αναλόγως.

Διαδικτυακή διεπαφή

Όλες οι αιτήσεις επιστρέφουν μια απάντηση σε JSON. Οι τιμές με την ένδειξη r/o είναι μόνο για ανάγνωση. Σημείωση: Δεν εγγυόμαστε τη σταθερότητα αυτού του API. Η λειτουργικότητα, οι παράμετροι, οι τιμές κ.λπ. μπορούν να αλλάξουν χωρίς προειδοποίηση.

Ανάκτηση πληροφοριών σχετικά με την εξισορρόπηση φορτίου και όλες τις συσκευές

         {
         "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
         }
         ]
         }
                  

Ορισμός/ανάγνωση παραμέτρων του Charging Manager

HTTP GET get_params επιστρέφει ένα αντικείμενο JSON,
HTTP POST set_params απαιτεί ένα αντικείμενο JSON στο κείμενο του μηνύματος

         //         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",
         }         
                  

Ορισμός ρυθμίσεων συσκευής

         {
            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

get_user ανακτά ένα μεμονωμένο αντικείμενο χρήστη,
set_user POST ένα μεμονωμένο αντικείμενο χρήστη,
get_users ανακτά έναν πίνακα αντικειμένων χρηστών
set_user μπορεί να κληθεί χωρίς κωδικό πρόσβασης διαχειριστή, αν περιέχει ένα έγκυρο αναγνωριστικό χρήστη. Η δημιουργία νέων χρηστών απαιτεί πρόσβαση διαχειριστή

         [   // 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
         ]
         }
         ]
                  

Αποδοχή άδειας

Αλλαγή κωδικού πρόσβασης διαχειριστή

Διαγραφή μιας συσκευής

Ανάκτηση ενός μοναδικού αναγνωριστικού χρήστη (για τη δημιουργία ενός νέου χρήστη)

Επαναφορά συσκευής

Έναρξη/διακοπή διαγνωστικής καταγραφής