Chargy Desktop App
Chargy is a transparency software for secure and transparent e-mobility charging processes, as defined by the German "Eichrecht". The software allows you to verify the cryptographic signatures of energy measurements within charge detail records and comes with a couple of useful extentions to simplify the entire process for endusers and operators.
Benefits of Chargy
- Chargy comes with meta data. True charging transparency is more than just signed smart meter values. Chargy allows you to group multiple signed smart meter values to entire charging sessions and to add additional meta data like EVSE information, geo coordinates, tariffs, ... within your backend in order to improve the user experience for the ev drivers.
- Chargy is secure. Chargy implements a public key infrastructure for managing certificates of smart meters, EVSEs, charging stations, charging station operators and e-mobility providers. By this the ev driver will always retrieve the correct public key to verify a charging process automatically and without complicated manual lookups in external databases.
- Chargy is platform agnostic. The entire software is available for desktop and smart phone operating systems and .NET. If you want ports to other platforms or programming languages, we will support your efforts.
- Chargy is Open Source. In contrast to other vendors in e-mobility, we belief that true transparency is only trustworthy if the entire process and the required software is open and reusable under a fair copyleft license (AGPL).
- Chargy is open for your contributions. We currently support adapters for the protocols of different charging station vendors like chargeIT mobility, ABL (OCMF), chargepoint. The certification at the Physikalisch-Technische Bundesanstalt (PTB) is provided by chargeIT mobility. If you want to add your protocol or a protocol adapter feel free to read the contributor license agreement and to send us a pull request.
- Chargy is white label. If you are a supporter of the Chargy project you can even use the entire software project under the free Apache 2.0 license. This allows you to create proprietary forks implementing your own corporate design or to include Chargy as a library within your existing application (This limitation was introduced to avoid discussions with too many black sheeps in the e-mobility market. We are sorry...).
- Chargy is accessible. For public sector bodies Chargy fully supports the EU directive 2016/2102 on the accessibility of websites and mobile applications and provides a context-sensitive feedback-mechanism and methods for dispute resolution.
Compiling from source
This application is based on Electron, a cross platform Open Source framework for creating native applications with web technologies like Java-/TypeScript, HTML, and (S)CSS.
Chargy is developed for and tested on the following operating systems:
- Microsoft Windows 10+
- Apple Mac OS X
- Linux Debian/Ubuntu
- Apple iOS
- Google Android
Install nodejs on your system. For more details please check https://nodejs.org
On Linux and Mac OS X:
sudo curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash - sudo apt install nodejs $ sudo npm install -g electron-forge@latest + firstname.lastname@example.org $ sudo npm install -g typescript@latest + email@example.com $ sudo npm install -g sass@latest + firstname.lastname@example.org
Get the latest version
Clone the github repository for the latest version of chargy and install its nodejs dependencies:
git clone https://github.com/OpenChargingCloud/ChargyDesktopApp.git cd ChargyDesktopApp npm install chmod +x run.sh ./run.sh
Building a Windows Installer
The Windows version can only be build on a Windows machine and uses Squirrel as an installation and update framework.
Building a Linux package
On a Debian GNU/Linux or Ubuntu machine you can run the following commands to create a Debian software package. More information about this process can be found at: https://github.com/electron-userland/electron-installer-debian
sudo apt install debootstrap electron-forge make
Now you can use the normal package management tools of your Linux distribution to install the app:
cd out/make sudo dpkg -i chargyapp_X.Y.Z_amd64.deb
Building a Linux Live ISO Image
For special users like the Physikalisch-Technische Bundesanstalt Chargy is also available as a Linux Live CD/DVD. The creation of the ISO image is described in the following document linux-live-image.