The Angular dashboard connects to the EVSE Server to display the charging stations in real time.
The application features:
- Displays of the charging stations, their status and their delivered power in real time.
- User management (create, update, delete, authorize, change role...)
- Charging station charging curves in real time
- Actions on charging stations: Reboot, Clear Cache, Stop Transaction, Unlock Connector...
- Energy control: set the maximum energy delivered by the charging station
Live demo here e-Mobility
- Install NodeJS: https://nodejs.org/ (install the LTS version)
- Clone this GitHub project
- Go into the ev-dashboard directory and run npm install or yarn install (use sudo in Linux)
NOTE:
- On Windows with chocolatey (https://chocolatey.org/), do as an administrator:
choco install -y nodejs-lts
- On Mac OSX with Homebrew (https://brew.sh/), do:
brew install node
- Follow the rest of the setup below
There is one template provided: src/assets/config-template.json.
Rename it to config.json.
Move this configuration file into the src/assets directory.
Edit this file, you will set relevant config data in it.
The dashboard is served by a web server, downloaded into the browser and will call the REST Server to retrieve and display the data.
Set the REST Server URL:
"CentralSystemServer": {
"protocol": "http",
"host": "localhost",
"port": 80
},
Ev-dashboard requires you to setup a Google API key: https://developers.google.com/maps/documentation/javascript/get-api-key#restrict_key. Once the key is created it must be enabled (from the Google Console) and the value must replace the one present in /src/index.html, in Google Maps section:
src="https://maps.googleapis.com/maps/api/js?key=<YOUR_KEY_HERE>&libraries=places&language=en"></script>
In order to call REST endpoints of ev-server, a reCaptcha key is required. Refers to this link https://www.google.com/recaptcha/admin/create to create one then copy the client key in config.json, in User section:
"User": {
"maxPictureKb": 150,
"captchaSiteKey": "<GOOGLE_RECAPTCHA_KEY_CLIENT>"
},
npm start
First build the sources with:
npm run build:prod
Next, start the server with:
npm run start:prod
Build the sources as above and run it with:
npm run start:prod:ssl
To run e2e tests, you first need to have a server and UI up and running. Then start the e2e suite with:
npm run e2e
That's it!
This file and all other files in this repository are licensed under the Apache Software License, v.2 and copyrighted under the copyright in NOTICE file, except as noted otherwise in the LICENSE file.
Please note that Docker images can contain other software which may be licensed under different licenses. This LICENSE and NOTICE files are also included in the Docker image. For any usage of built Docker images please make sure to check the licenses of the artifacts contained in the images.