Skip to content

mbillow/ha-chargepoint

Repository files navigation

ChargePoint for Home Assistant

A cloud-polling Home Assistant component to expose ChargePoint Home Charger and Account information.

home assistant entities

Installation

While we are waiting to get included in the default HACS repositories, you can manually include this repository in HACS:

  1. If you haven't already installed HACS, follow their instructions.
  2. Navigate to HACS.
  3. Choose "Integrations"
  4. Add this repository to your configuration.
    1. Click the three dots in the upper right-hand corner.
    2. Select "Custom repositories"
    3. Enter mbillow/ha-chargepoint into the repository box.
    4. Select the "Integration" type.
    5. Click Add.
  5. Install the integration like you would any other HACS addon.

Usage

Once you have installed the component, you'll need to add and configure it. From the Configuration > Devices & Services page, click + Add Integration in the bottom right.

Search for ChargePoint and select the integration. You will be prompted for your ChargePoint credentials.

Once you are logged in, if you have any home chargers, you will be asked which zones/rooms to assign each device to. Otherwise, you will just see a sensor exposing your account balance.

Energy Tracking

Must be using v0.1.2 or higher for proper sensor classification.

For users that have one or more ChargePoint Home Flex(es), you can add your chargers as sources of grid consumption in Home Assistant's energy tracking system. Simply add the Energy Output output sensor of your device and add the Charge Cost sensor an "entity tracking the total costs."

Using with Third-Party Cards

The sensors created by this component can be used with third-party EV charging cards like tmjo/charger-card.

Feel free to create Pull Requests adding demo configurations to this section of the README if you end up building something you'd like to share.

Development and Contributing

If you notice any issues, please create a GitHub issue describing the error and include any error messages or stack traces.

Running the Integration

I've included a simple Docker Compose file that will launch a new Home Assistant instance with the integration and its dependencies pre-installed. Simply run:

docker-compose up -d

Then navigate to http://127.0.0.1:8123 in your browser.