Skip to main content

alfen-cli

Command line client for the local HTTPS API of Alfen Eve / NG9xx EV chargers (the API that ACE Service Installer and the charger's web UI use).

pip install alfen-cli            # add [signed] for `alfen verify`
export ALFEN_HOST=192.168.1.20 ALFEN_USERNAME=admin ALFEN_PASSWORD=...

alfen info                       # identity / model / firmware, no login
alfen categories
alfen get -c ocpp                # all properties in a category
alfen get 2126_0 OD_commBackOfficeURL_serverDomainAndPort
alfen set 20F2_3=ws://csms.example:8081 --string
alfen logs -n 100                # event log, plain text (unlike OCPP GetLog, which is encrypted)
alfen logs -f                    # follow
alfen transactions
alfen whitelist
alfen reboot --yes
alfen verify <meterPublicKey> <signedMeterData>   # Alfen/DZG signed meter value

--json gives machine-readable output.

Notes

  • The charger accepts one API session at a time. Logging in ends an open ACE Service Installer / web session and vice versa. alfen logs out when each command finishes.
  • The charger uses a self-signed certificate and old TLS ciphers; certificate checks are off.
  • Repeated wrong passwords can lock the account. Check credentials before scripting.
  • set writes raw property ids. Some changes only apply after reboot.

Credits

Property id → name mapping and the API flow are based on alfeneve (MIT, Nick Douma).

Metadata

Release files for alfen-cli 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alfen-cli 0.1.0
File Size Uploaded
alfen_cli-0.1.0.tar.gz 13.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for alfen-cli 0.1.0
File Interpreter ABI Platform
alfen_cli-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 27.8 kB

Release files / alfen_cli-0.1.0.tar.gz

Download URL alfen_cli-0.1.0.tar.gz
Size 13.0 kB
Tags Source
SHA-256 checksum
How to use checksums
a183fc975e91fedf0b3c15a20f177886888ca8753e19d73c52d1ecbef78d181b
BLAKE2b-256 checksum
How to use checksums
b1bb2c6a2f7c765a0b4e9ea90d19c80632b386178b0b94a5ab71ccef23d2a938
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / alfen_cli-0.1.0-py3-none-any.whl

Download URL alfen_cli-0.1.0-py3-none-any.whl
Size 14.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8e6fc48be0b7fc4460021992a7ecba50d8ed5b99543dfcbdf486a468bab66d10
BLAKE2b-256 checksum
How to use checksums
c38f8df1bba71e8a1a118b30ecfd0f0ceb871ac3cec114dcef3102f6b473aaef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

0.1.1

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page