Documentatión

API HTTP

Las siguientes funciones proporcionan un mapeo de los Registros Modbus a HTTP.
Nota: No es necesario que Modbus esté activo para utilizar la API HTTP.

Utilice una solicitud HTTP GET o POST a la dirección del controlador de carga cFos, por ejemplo,
http://192.168.2.111/cnf?cmd=modbus&device=meter1&read=35154.
Las respuestas están en JSON.

  • cmd es siempre modbus
  • dispositivo = meter1 o meter2 o evse
  • read = dirección del registro a leer
  • write = dirección del registro a leer
  • valor = valor a escribir
  • valores = matriz de valores a escribir, por ejemplo [1,2,3,4]

Las direcciones pueden tener un sufijo para especificar el tipo de datos (por defecto es un entero de 16 bits):

  • d = número entero de 32 bits (2 registros modbus)
  • q = número entero de 64 bits (4 registros modbus)
  • s = cadena
controlador de carga cFos - Registros Modbus

Estos son algunos ejemplos de cómo utilizar la API HTTP

Modbus

/cnf?cmd=modbus&device=meter1&read=8002
Respuesta:
1

/cnf?cmd=modbus&device=meter1&read=8062d
Respuesta:
-1

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

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

/cnf?cmd=modbus&device=meter2&read=all
Respuesta:
{"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
Respuesta:
"ok"

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

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

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

Solicitudes generales

Solicita el estado de todos los dispositivos del Charging Manager:
/cnf?cmd=get_dev_info

Configurar un PIN o RFID:
/cnf?cmd=enter_rfid&rfid=r&dev_id=d
r es el PIN o RFID (dígitos), d es un identificador de dispositivo opcional para seleccionar un EVSE específico. Si no se selecciona ningún identificador de dispositivo, el Charging Manager intenta asignar el PIN o RFID automáticamente.

Sobrescribir para la transacción actual:
/cnf?cmd=override_device&dev_id=d&flags=f&mamps=ma&rfid=id
d es el ID del dispositivo, id es un RFID/PIN posiblemente requerido, banderas, como sigue:
'C': Desactivar la carga (se requiere la pwd del administrador o el PIN/RFID del usuario)
'c': Desactivar la carga de nuevo (se requiere la pwd del administrador o el PIN/RFID del usuario)
'E': Desactivar las reglas de carga del EVSE (se requiere pwd de administrador)
'e': Desactivar de nuevo las reglas de carga del EVSE (se requiere la pwd del administrador)
'U': Desactivar las reglas de carga del usuario (se requiere RFID/PIN del usuario)
'u': Desactivar de nuevo las reglas de carga del usuario (se requiere RFID/PIN del usuario)

Las banderas establecidas de este modo permanecen hasta que el coche se desenchufa del EVSE.

mamps=ma: Sobrescribe (limita) la corriente de carga con ma mA.

Ajuste del contador de energía simulado:
/cnf?cmd=soft_meter&dev_id=d&val=v
v (opcional) es la energía que se debe establecer en Wh/VAh. Si v no está presente, sólo se lee el contador. d es el id del dispositivo del EVSE. El valor de retorno es la lectura antigua del contador antes del ajuste.

Contadores HTTP y EVSEs

Medidor

Puede crear un contador (tipo de dispositivo "Entrada HTTP") que no sea leído por el Gestor de Carga, pero cuyos valores actuales pueden ser especificados externamente a través de HTTP POST o GET:
/cnf?cmd=set_ajax_meter&dev_id=x
x es el ID del dispositivo como se ve en la configuración del dispositivo, por ejemplo, M1.

El cuerpo del POST contiene un objeto JSON, como el siguiente:

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

Aquí, los valores de energía se dan en Wh, los voltajes en V, las corrientes en mA y las potencias en W. "modelo" es la cadena del modelo tal y como se muestra en las fichas.

Algunos de nuestros usuarios (#diebestenuserderwelt) utilizan la herramienta curl para suministrar datos al medidor, por ejemplo
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'

Como HTTP GET la petición se escribe así:
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

Aquí hay otro post en el foro sobre la conexión de un contador inteligente utilizando contadores de entrada cFos HTTP y ioBroker.

EVSE

También se puede crear un wallbox (tipo de dispositivo 'HTTP Input') que no es leído ni controlado por el Charging Manager, pero cuyos valores pueden ser especificados externamente usando HTTP POST o GET. Los valores de control se devuelven como respuesta:
/cnf?cmd=set_ajax_evse&dev_id=x
x es el ID del dispositivo como se ve en la configuración del dispositivo, por ejemplo, E1.

El cuerpo del POST contiene un objeto JSON, como el siguiente:

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

"model" es la cadena del modelo como se muestra en las fichas. Con "rfid" puedes añadir un RFID al proceso de carga, los valores de energía se dan en Wh, las corrientes en mA. "state" tiene los siguientes valores:
1 = espera (A), 2 = EV presente (B), 3 = carga (C), 4 = carga con ventilación (D), 5 = error (E)

Como HTTP GET la petición se escribe así:
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

En respuesta, esta solicitud devuelve el siguiente objeto JSON:

{
             "device_enabled": true/false, // el dispositivo está activado/desactivado
             "charging_enabled": true/false, // carga permitida/no permitida
             "paused": true/false, // true = el dispositivo está temporalmente en pausa
             "charging_current": número // corriente de carga especificada en mA
         }

Este objeto de retorno debe ser evaluado por la persona que llama y el EVSE debe ser ajustado en consecuencia, por ejemplo, la corriente de carga debe ser modificada en consecuencia.

Interfaz web

Todas las peticiones devuelven una respuesta en JSON. Los valores etiquetados como r/o son de sólo lectura. Nota: No garantizamos la estabilidad de esta API. La funcionalidad, los parámetros, los valores, etc. están sujetos a cambios sin previo aviso.

Recuperar información sobre el equilibrio de carga y todos los dispositivos

/cnf?cmd=get_dev_info
Valores de retorno (ejemplo):
         {
         "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
         }
         ]
         }
                  

Establecer/lectura de los parámetros del Gestor de Carga

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

HTTP GET get_params devuelve un objeto JSON,
HTTP POST set_params requiere un objeto JSON en el texto del mensaje

Valores de retorno (ejemplo):
         //         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",
         }         
                  

Establecer la configuración del dispositivo

/cnf?cmd=set_params
POST datos de usuario (ejemplo):
         {
            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 recupera un único objeto de usuario,
set_user POSTs un único objeto de usuario,
get_users recupera un array de objetos de usuario
set_user puede ser llamado sin contraseña de administrador si contiene un ID de usuario válido. La creación de nuevos usuarios requiere acceso de administrador

Valores de retorno (ejemplo):
         [   // 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
         ]
         }
         ]
                  

Aceptar licencia

/cnf?cmd=accept_license&acc=1&allow_usage_stats=a
a = 1 permite informar de las estadísticas de uso a cFos eMobililty, a = 0 lo prohíbe

Cambiar la contraseña de administrador

/cnf?cmd=change_admin_pwd&old_pwd=alt&new_pwd=neu
old, new son la antigua y la nueva contraseña de administrador

Borrar un dispositivo

/cnf?cmd=del_device&dev_id=d
d es un ID de dispositivo válido

Recuperar un ID de usuario único (para crear un nuevo usuario)

/cnf?cmd=get_new_user_id
devuelve un nuevo ID de usuario como cadena JSON

Reiniciar un dispositivo

/cnf?cmd=reset_device&dev_id=d
d es un ID de dispositivo válido. El dispositivo se elimina y se vuelve a crear

Iniciar/detener el registro de diagnósticos

/cnf?cmd=set_diag_logging&enable=e
e = 1 para iniciar, e = 0 para detener el registro de diagnóstico. Se ejecuta durante 5 minutos si no se detiene