Amina S EV Charger – SmartThings Edge Driver

Overview

This Edge driver integrates the Amina S EV charger with SmartThings, providing control and monitoring directly within the SmartThings app.

The driver enables you to:

• Control the maximum charging current (A).
• Turn charging on and off.
• Read power consumption data (A, W, V).

Note: I have not been successful in implementing the Amina S Control cluster (0xFEE7). Community contributions to address this are highly welcome. Some labels in the SmartThings interface are platform standards (e.g., "Dimmer" for the current slider), but the underlying functionality is correct.

---

Key Features

Current Management (Slider Control)

• Adjust Charging Current: Use the slider (labeled "Dimmer" in the SmartThings UI) to set the desired charging current.
• Range: Supports whole Ampere values from 6 A up to the chargers configured maximum limit (default 32 A).
• Accurate Feedback: The driver ensures the slider position and current measurement update to reflect the actual charging current confirmed by the charger. For example, if you request 17 A, but the charger internally limits to 10 A, the UI will display 10 A (or ~15% on the slider).

Basic Control and Measurements

• On/Off Control: Start or stop charging directly from the app. When turning on, the charger restores the last used current value.
• Measurements:
  • Current (A): Actual charging current.
  • Power (W): Active power consumption.
  • Voltage (V): Supply voltage.
• Presence Sensor: Indicates "Car present" when charging power exceeds approximately 10 W (signaling active charging).
• Manual Refresh: Press the Refresh button to update all values (current, power, voltage) from the charger.

---

Installation and Usage

1. Installation: Deploying the Edge Driver

This driver must be installed onto your SmartThings Hub using the SmartThings CLI (Command Line Interface). This process requires you to deploy the driver to your own Channel.

Prerequisites:

• You must have the SmartThings CLI installed and configured on your computer.
• You must be logged into the CLI with your developer account.

A. Download the Code

Clone this repository or download the driver code files to your local machine.

B. Create or Select a Channel

If you do not already have an Edge Channel, create one using the CLI:

smartthings edge:channels:create

Note the Channel ID that is returned by the CLI for the next step.

C. Upload the Driver

Use the CLI to pack and upload the driver files to your Channel. Run this command from the directory containing the driver's source code:

smartthings edge:drivers:package [DRIVER_DIRECTORY] [CHANNEL_ID]

Replace [DRIVER_DIRECTORY] with the path to the driver source folder and [CHANNEL_ID] with the ID from step B. The driver will now be downloaded to your SmartThings Hub.

2. Pairing the Device

After the driver is installed on your Hub, you can pair the charger.

1. Start Pairing: In the SmartThings app, go to Add Device (+), select Scan nearby or choose "Device Type" (like Wi-Fi/Zigbee/Z-Wave).
2. Activate Charger Pairing Mode: Put your Amina S charger into its pairing/inclusion mode (consult the Amina S manual for the exact procedure).
3. Automatic Discovery: Your SmartThings Hub will automatically discover the device and assign this driver.

3. Usage Instructions

1. Set Maximum Current: If you need to restrict the upper limit of the current slider, set your preferred maximum current (A) in the device settings within the SmartThings app.
2. Adjust Current: Use the slider to set the desired charging current.
3. Monitor Status: The app will always confirm the final charging current reported by the charger.

4. Automations (Routines)

• Use percentage values in Routines for load balancing and smart management.
• Example: "If total household consumption exceeds 10 kW, set charger to 50%."