Chargepoint Driver Configuration

The chargepoint driver requires at least one additional python library and has its own requirements.txt. Make sure to run pip install -r <chargepoint driver path>/requirements.txt before using this driver.

driver_config

There are three arguments for the driver_config section of the device configuration file:

• stationID - Chargepoint ID of the station. This format is ususally ‘1:00001’
• username - Login credentials for the Chargepoint API
• password - Login credentials for the Chargepoint API

The Chargepoint login credentials are generated in the Chargepoint web portal and require a chargepoint account with sufficient privileges. Station IDs are also available on the web portal.

Here is an example device configuration file:

{
    "driver_config": {"stationID": "3:12345",
                      "username": "4b90fc0ae5fe8b6628e50af1215d4fcf5743a6f3c63ee1464012875",
                      "password": "ebaf1a3cdfb80baf5b274bdf831e2648"},
    "driver_type": "chargepoint",
    "registry_config":"config://chargepoint.csv",
    "interval": 60,
    "timezone": "UTC",
    "heart_beat_point": "heartbeat"
}

A sample Chargepoint configuration file can be found in the VOLTTRON repository in examples/configurations/drivers/chargepoint1.config

Chargepoint Registry Configuration File

The registry configuration file is a CSV file. Each row configures a point on the device.

The following columns are required for each row:

• Volttron Point Name - The name by which the platform and agents running on the platform will refer to this point.
• Attribute Name - Chargepoint API attribute name. This determines the field that will be read from the API response and must be one of the allowed values.
• Port # - If the point describes a specific port on the Chargestation, it is defined here. (Note 0 and an empty value are equivalent.)
• Type - Python type of the point value.
• Units - Used for meta data when creating point information on the historian.
• Writable - Either “TRUE” or “FALSE”. Determines if the point can be written to. Only points labeled TRUE can be written.
• Notes - Miscellaneous notes field.

• Register Name - A string representing how to interpret the data register. Acceptable values are:

  • StationRegister
  • StationStatusRegister
  • LoadRegister
  • AlarmRegister
  • StationRightsRegister

• Starting Value - Default value for writeable points. Read-only points should not have a value in this column.

Detailed descriptions for all available chargepoint registers may be found in the README.rst in the chargepoint driver directory.

A sample Chargepoint registry file can be found in the VOLTTRON repository in examples/configurations/drivers/chargepoint.csv