Наступні функції забезпечують відображення регістрів Modbus в HTTP.
Примітка: Modbus не повинен бути активним для використання HTTP API.
Використовуйте HTTP GET або POST запит на адресу контролера cFos Power Brain Controller, наприклад,http://192.168.2.111/cnf?cmd=modbus&device=meter1&read=35154.
Відповіді у форматі JSON.
cmd - це завжди modbusdevice = meter1 або meter2 або evseread = адреса регістра для читанняwrite = адреса регістра для читанняvalue = значення для записуvalues = масив значень для запису, наприклад [1,2,3,4]Адреси можуть мати суфікс для визначення типу даних (за замовчуванням - 16-бітне ціле число):
d = 32-бітове ціле число (2 регістри Modbus)q = 64-бітове ціле число (4 регістри Modbus)s = string/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-код адміністратора або PIN-код користувача/RFID)
'c': Знову вимкнути зарядку (потрібен PIN-код адміністратора або PIN-код користувача/RFID)
'E': Вимкнення правил заряджання EVSE (потрібен пароль адміністратора)
'e': Повторне вимкнення правил заряджання EVSE (потрібен пароль адміністратора)
'U': Деактивація правил заряджання користувача (потрібен RFID/PIN-код користувача)
'u': Знову деактивувати правила заряджання користувача (потрібен RFID/PIN-код користувача)
Встановлені таким чином прапорці залишаються доти, доки автомобіль не буде від'єднано від EVSE.mamps=ma: Перезаписати (обмежити) зарядний струм за допомогою ma mA.
Налаштування імітаційного лічильника електроенергії:/cnf?cmd=soft_meter&dev_id=d&val=v
v (необов'язково) - енергія, яку потрібно встановити у Вт-год/ВА-год. Якщо v відсутнє, лічильник лише зчитується. d - ідентифікатор пристрою EVSE. Значення, що повертається, - старі показання лічильника перед налаштуванням.
Ви можете створити лічильник (тип пристрою "HTTP-вхід"), який не зчитується Диспетчером зарядки, але поточні значення якого можуть бути вказані ззовні за допомогою 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
}Тут значення енергії подано у Вт-год, напруги у В, струмів у мА та потужностей у Вт. "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¤t=10001,10002,10003
Ось ще одне повідомлення на форумі про підключення розумного лічильника за допомогою cFos HTTP вхідних лічильників та ioBroker.
Ви також можете створити зарядний пристрій (тип пристрою "HTTP-вхід"), який не зчитується і не контролюється Диспетчером заряджання, але значення якого можна вказати ззовні за допомогою 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 до процесу зарядки, значення енергії вказані в Вт, струми в мА. "state" має наступні значення:
1 = очікування (A), 2 = електромобіль присутній (B), 3 = зарядка (C), 4 = зарядка з вентиляцією (D), 5 = помилка (E)
У вигляді HTTP GET запит записується так:http://192.168.2.111/cnf?cmd=set_ajax_evse&dev_id=M3&model=TestModell&state=st&max_charging_current=m¤t=c1,c2,c3&total_energy=t&rfid=r
У відповідь цей запит повертає наступний JSON об'єкт:
{
"device_enabled": true/false, // пристрій увімкнено/вимкнено
"charging_enabled": true/false, // зарядка дозволена/не дозволена
"paused": true/false, // true = пристрій тимчасово призупинено
"charging_current": number // заданий струм заряду в мА
}Цей об'єкт повернення повинен бути оцінений абонентом, який викликає, і EVSE повинен бути налаштований відповідним чином, наприклад, зарядний струм повинен бути змінений відповідно.
Всі запити повертають відповідь у форматі JSON. Значення з позначкою r/o доступні тільки для читання. Зверніть увагу: ми не гарантуємо стабільність цього API. Функціональність, параметри, значення тощо можуть бути змінені без попередження.
/cnf?cmd=get_dev_info
{
"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
}
]
}
/cnf?cmd=get_params/cnf?cmd=set_paramsHTTP 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",
}
/cnf?cmd=set_params
{
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
]
}
/cnf?cmd=get_users/cnf?cmd=get_user/cnf?cmd=set_userget_user повертає один об'єкт користувача,
set_user відправляє один об'єкт користувача,
get_users повертає масив об'єктів користувача
set_user можна викликати без пароля адміністратора, якщо він містить дійсний ID користувача. Створення нових користувачів вимагає доступу адміністратора
[ // 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
]
}
]
/cnf?cmd=accept_license&acc=1&allow_usage_stats=a/cnf?cmd=change_admin_pwd&old_pwd=alt&new_pwd=neu/cnf?cmd=del_device&dev_id=d/cnf?cmd=get_new_user_id/cnf?cmd=reset_device&dev_id=d/cnf?cmd=set_diag_logging&enable=e
Ми використовуємо файли cookie. Багато з них необхідні для роботи веб-сайту та його функцій, інші - для статистичних або маркетингових цілей. Вибравши "Приймати тільки необхідні файли cookie", ми будемо поважати Вашу конфіденційність і не будемо встановлювати файли cookie, які не є необхідними для роботи сайту.