easy-ocpp

OCPP 1.6J · 2.0.1 · 1.5 SOAP

Su propio servidor OCPP para hasta diez cargadores

easy-ocpp es un sistema de gestión de puntos de carga (CSMS) autoalojado para pequeñas y medianas empresas. Habla OCPP 1.6J, 2.0.1 y 1.5 SOAP. Un solo binario, un solo archivo SQLite, sin suscripción en la nube ni conexión permanente a internet.

Descargar versión Código fuente en GitHub

Sin nube, sin suscripción

Todo funciona en una máquina suya. Basta un servidor pequeño, un NUC o incluso un PC de oficina que le sobre. Los datos de carga no salen de su red.

Un binario, un archivo

Sin servidor de base de datos, sin broker de mensajes, sin pila de contenedores. Descomprima, ejecute y listo. Todos sus datos caben en un archivo SQLite que basta copiar para hacer una copia de seguridad.

Pensado para 1–10 cargadores

Deliberadamente no es una plataforma corporativa. Lo que una empresa con unos pocos puntos de carga necesita de verdad, sin la carga operativa que suele acompañarla.

Qué hace

Inventario de cargadores

Estado en línea, conectores, firmware y número de serie por punto de carga, directamente desde la conexión OCPP.

Gestión de tarjetas

Las tarjetas nuevas se dan de alta mediante una ventana de aprendizaje de dos minutos: acerque la tarjeta y el servidor captura el tag.

Tarjetas y personas

Una tarjeta pertenece a una persona o es de invitado. La categoría se deriva de la asignación y no puede contradecirla.

Mediciones en vivo

kWh cargados, potencia actual y estado de carga durante la sesión, actualizados cada diez segundos.

Límites de carga

Parada automática al alcanzar la energía objetivo o cumplirse el tiempo, lo que ocurra primero.

Cargas de invitados

Desbloquee de forma remota para una visita e impute la carga a una etiqueta de invitado.

Informes

Lista de cargas con exportación CSV, estadísticas por mes, trimestre y año, y un PDF mensual por persona.

Cuatro idiomas

Toda la interfaz en alemán, inglés, francés y español, conmutable por usuario.

Dos roles, claramente separados

Solo existe un tipo de persona en el sistema: el usuario. Un empleado es un usuario, y sus tarjetas, sus cargas y sus límites cuelgan directamente de esa cuenta. Lo que puede hacer un empleado está deliberadamente acotado.

AdminEmpleado
Cargadores, tarjetas, gestión de usuarios
Cargas de todas las personas
Sus propias cargas, CSV, estadísticas, PDF mensual
Ver su carga en curso y detenerla
kWh objetivo y temporizador en su carga
Valores predeterminados de cualquier empleado

El servidor aplica estas restricciones. Ocultarlas en la interfaz no bastaría. Tras iniciar sesión, un empleado llega a su propia página y la navegación solo le muestra lo que realmente puede abrir.

Límites que detienen la carga de verdad

Una carga termina sola en cuanto alcanza una energía objetivo o un temporizador, lo que ocurra primero. Ambos son opcionales. Cada persona tiene valores predeterminados que se aplican a cada carga nueva y que fija el propio empleado o un administrador; en una carga en curso los valores siguen siendo modificables.

Un vigilante comprueba cada 15 segundos y envía RemoteStopTransaction. El límite de energía se comprueba además en cuanto llegan nuevas mediciones, para no sobrepasar el objetivo esperando al siguiente ciclo. Si un cargador rechaza la parada, se vuelve a intentar.

Empezar

Descargue una versión para Windows o Linux, descomprima y ejecute. La interfaz queda entonces en el puerto 8080; el primer acceso es admin / admin.

O compile desde el código fuente:

git clone https://github.com/hilman2/easy-ocpp.git
cd easy-ocpp
cargo run --release

Conectar un cargador

Apunte el punto de carga a su servidor. Los subprotocolos se negocian automáticamente, y un punto de carga desconocido se registra solo en la primera conexión.

ws://<host>:8080/ocpp/<ChargePointId>

Para equipos OCPP 1.5 antiguos por SOAP:

POST http://<host>:8080/ocpp15

Protocolos admitidos

VersiónTransporteEstado
OCPP 1.6JWebSocketCompleto (boot, heartbeat, estado, autorización, transacciones, mediciones, arranque/parada remotos, configuración)
OCPP 2.0.1WebSocketEsqueleto (BootNotification y TransactionEvent)
OCPP 1.5SOAPEsqueleto (boot y heartbeat)

Preguntas frecuentes

¿Qué es un CSMS?

Un Charging Station Management System es el backend con el que habla un punto de recarga. Autoriza tarjetas RFID, registra las cargas y las lecturas del contador y puede iniciar o detener una carga de forma remota. OCPP es el protocolo con el que ambos se comunican.

¿Funciona con mi cargador?

Cualquier punto de carga que hable OCPP 1.6J sobre WebSocket debería funcionar, lo que cubre la gran mayoría de equipos vendidos en los últimos años. El hardware más antiguo limitado a OCPP 1.5 SOAP puede conectarse para boot y heartbeat.

¿Necesito conexión a internet?

No. Los cargadores se conectan a su servidor por la red local. Internet solo hace falta si quiere acceder a la interfaz desde fuera.

¿Cómo veo quién ha cargado cuánto?

Cada carga va ligada a la tarjeta RFID con la que se inició, y cada tarjeta pertenece a una persona. La lista, las estadísticas y el PDF mensual se agrupan en consecuencia. Las cargas con tarjetas sin asignar se contabilizan como cargas de invitado.

¿Ven los empleados las cargas de los demás?

No. Un empleado solo ve las cargas iniciadas con sus propias tarjetas. Únicamente un administrador lo ve todo.

¿Cuánto cuesta?

Nada. easy-ocpp es código abierto bajo licencia MIT. No hay versión de pago ni tarifa por punto de carga.