Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hagronnestad/leaf-display
🚗🔋🔌 C# NissanConnect library and ESP8266 code powering a Nextion HMI display used to monitor and control a Nissan Leaf remotely.
https://github.com/hagronnestad/leaf-display
3d-printing csharp esp8266 hmi leaf nextion nextion-hmi nissan nissan-connect nissan-leaf nissanconnect
Last synced: 3 months ago
JSON representation
🚗🔋🔌 C# NissanConnect library and ESP8266 code powering a Nextion HMI display used to monitor and control a Nissan Leaf remotely.
- Host: GitHub
- URL: https://github.com/hagronnestad/leaf-display
- Owner: hagronnestad
- License: mit
- Created: 2018-03-14T01:15:43.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T01:33:01.000Z (about 2 years ago)
- Last Synced: 2024-10-04T12:51:50.743Z (3 months ago)
- Topics: 3d-printing, csharp, esp8266, hmi, leaf, nextion, nextion-hmi, nissan, nissan-connect, nissan-leaf, nissanconnect
- Language: C#
- Homepage:
- Size: 16.6 MB
- Stars: 28
- Watchers: 4
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Nissan Leaf 2017 Dashboard
*Animated preview of dashboard at different states.*
*Images of the 3D-printed case and assembly.*
---
## LeafClient
The LeafClient is a cross platform console application which can authenticate with and query data from Nissan Connect EV.
#### Usage
```
Usage: leafclient username password [-o {filename}] [-p {url}] [-last]
Options:
username Your Nissan Connect username.
password Your blowfish encrypted password.
Encrypt your password at http://sladex.org/blowfish.js/.
Key: 'uyI5Dj9g8VCOFDnBRUbr3g'. Cipher mode: ECB. Output type: BASE64.
-o Outputs the result as JSON to {filename}.
-p Posts the result as JSON to {url}.
-last Don't query live data from car.
```
\* *I intentionally did not add Blowfish encryption to the application because .NET does not have Blowfish encryption integrated in the framework and I did not want to add a dependency. The password needs to be supplied pre encrypted.*
#### Example
`dotnet LeafClient.dll username password -o data.json`
#### Example output file
```json
{
"Timestamp": "2019-03-20T22:00:00",
"NickName": "leaf1",
"Vin": "123456789",
"PluginState": "NOT_CONNECTED",
"CruisingRangeAcOn": 168000,
"CruisingRangeAcOff": 186000,
"MinutesToFull": 240,
"MinutesToFull200": 150,
"MinutesToFull200_6kW": 70,
"BatteryCapacity": 240,
"BatteryRemainingAmount": 240,
"BatteryRemainingAmountWH": 0,
"BatteryRemainingAmountkWH": 0,
"StateOfCharge": 92
}
```
#### Setup/configuration
I use a cron job on a Linux server to periodically run the `LeafClient` console application. I use the `-o` flag which writes the JSON data to a file. This file is served by my web server and consumed by the ESP8266.
---
## IoT parts
### ESP8266 Arduino sketch
The `ESP8266` folder contains an Arduino skecth to retrieve JSON data from a web server and send it to a Nextion display over serial.
### Nextion display
The `Nextion` folder contains the HMI project for the display that shows the data. The Nextion display I used is the `NX4832T035_011` which is the 3.5" version.
*This is the Nextion HMI design. I used the actual Nissan Leaf dashboard as inspiration.*
### Nextion 3D-printable case
STL-files for the Nextion case can be found in the `Nextion Case` folder. The case is designed to be used with one of these [ESP programmers](https://www.ebay.com/itm/ESP-Series-Programmer-for-ESP8285-ESP8266-ESP32-ESP01-adapter-for-arduino/323127795519?hash=item4b3beadf3f:g:AdEAAOSwWmNaoWfZ), which makes it very easy to power and flash the ESP through micro USB. It also provides easy access to power and serial pins for the Nextion display.