search

node-red-contrib / node-red-contrib-renault-ze

node-red extension to fetch the status from your renault connected car
Apache License 2.0
19 stars 6 forks source link
node-red node-red-contrib renault-ze-service

readme

CLA assistant compile CodeFactor npm version

Renault ZE Services node

Provides functionality to retrieve data from the Renault ZE Services API. Thanks to Muscat's OxBlog for the documentation of the new API. Designed to be installed into Node Red.

Supported Cars:

When triggered, the node will login and retrieve the status of the vehicles. It will output multiple messages for battery, cockpit,... payload see the following example:

{
    "data": {
        "type": "Car",
        "id": "VF1XX000000000000",
        "attributes": {
            "timestamp": "2020-11-15T14:02:00Z",
            "batteryLevel": 86,
            "batteryTemperature": 20,
            "batteryAutonomy": 310,
            "batteryCapacity": 0,
            "batteryAvailableEnergy": 44,
            "plugStatus": 0,
            "chargingStatus": 0,
            "chargingRemainingTime": 30,
            "chargingInstantaneousPower": 11.9
        }
    }
}

Install

Install via the palette manage in the Node-RED admin ui (no restart needed).

Alternatively run the following command in your Node-RED user directory (typically ~/.node-red):

npm install node-red-contrib-renault-ze

then restart Node-RED and add an instance of the renault-ze node.

Usage

Just send a messages to the node and you will receive a lot of status messages. For details read the following here.

You can simple start with the following flow to fetch some data from your cars:

simple Flow

Click to expand the flow! 
[
    {
        "id": "8d884832.0b75d8",
        "type": "renault-ze",
        "z": "35cd1e62.3f2ff2",
        "name": "",
        "x": 480,
        "y": 300,
        "wires": [
            [
                "22f4a942.cea996"
            ]
        ]
    },
    {
        "id": "b923017a.ce46",
        "type": "inject",
        "z": "35cd1e62.3f2ff2",
        "name": "no topic -> charge / cockpit & location",
        "props": [],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "x": 190,
        "y": 220,
        "wires": [
            [
                "8d884832.0b75d8"
            ]
        ]
    },
    {
        "id": "22f4a942.cea996",
        "type": "debug",
        "z": "35cd1e62.3f2ff2",
        "name": "",
        "active": true,
        "tosidebar": true,
        "console": false,
        "tostatus": false,
        "complete": "true",
        "targetType": "full",
        "statusVal": "",
        "statusType": "auto",
        "x": 630,
        "y": 300,
        "wires": []
    },
    {
        "id": "ba475199.d46a9",
        "type": "inject",
        "z": "35cd1e62.3f2ff2",
        "name": "",
        "props": [
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "charge-mode",
        "x": 270,
        "y": 280,
        "wires": [
            [
                "8d884832.0b75d8"
            ]
        ]
    },
    {
        "id": "9282bcf2.18602",
        "type": "inject",
        "z": "35cd1e62.3f2ff2",
        "name": "",
        "props": [
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "hvac-schedule",
        "x": 260,
        "y": 340,
        "wires": [
            [
                "8d884832.0b75d8"
            ]
        ]
    },
    {
        "id": "931c1bd0.7fa698",
        "type": "inject",
        "z": "35cd1e62.3f2ff2",
        "name": "",
        "props": [
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "charge-schedule",
        "x": 260,
        "y": 400,
        "wires": [
            [
                "8d884832.0b75d8"
            ]
        ]
    }
]