Top AC Portable EV Charger

Top AC Portable EV Charger is a Powered By Shelly smart AC charging device designed for electric vehicles. It provides safe and flexible home or on-the-go charging, supporting both single- and three-phase setups. The charger exposes live per-phase telemetry and allows you to start or stop sessions, limit charging current, and enforce global time or energy limits.

For more information about the original Top AC Portable EV Charger consult: Top AC Portable EV Charger.

The following components are available in Top AC Portable EV Charger:

• System
• XMOD service
• WiFi
• Bluetooth Low Energy
• Schedule
• Cloud
• MQTT
• Outbound Websocket
• Webhook
• KVS
• HTTP

Supported virtual components:

• Boolean
• Number
• Enum
• Object

Supported BTHome components:

• BTHomeDevice
• BTHomeSensor

Virtual Component Configuration

The Top AC Portable EV Charger has the following virtual components:

Virtual Component	Type	Access	Description
work_state	enum	read	Reports the charger's state (wait, charging, pause, etc.)
current_limit	number	read/write	Sets the charging current.
phase_info	object	read	Live per-phase electrical telemetry (voltage/current/power) with aggregated total active energy (kWh).
start_charging	boolean	read/write	Starts or stops the charging session.
energy_charge	number	read	Session energy consumption (kWh).
time_charge	number	read	Session duration.

Service Configuration

See the Service Configuration Example section for a full example.

Property	Type	Description
auto_balance	object	Configures load balancing with an external Shelly EM/EM1 device. When enabled, the charger adjusts its current limit to keep total site current under the configured threshold. Property Type Description enable boolean Enables auto balance. When enabled and em_ip is valid, balancing starts automatically with charging. em_ip string IP address of the Shelly EM/EM1 used for load balancing. Must be a valid IPv4 when enable is true; may be null when disabled. max_current number Maximum allowed total current (EV + household), in amperes. exclude_self_current boolean If true, the EV’s measured current is subtracted from the EM reading to avoid double-counting.
auto_charge	boolean	When enabled, charging starts automatically as soon as the connector is plugged into the vehicle.
global_charge_limit	number	Session energy cap (kWh) (0–1000). When reached, charging stops and a status flag is raised.
global_time_limit	number	Session duration cap (minutes) (0–1440). When reached, charging stops and a status flag is raised.
id	number	Service id.

Method Examples

How to check the working state

Enum.GetStatus HTTP GET Request

http://192.168.33.1/rpc/Enum.GetStatus?owner="service:0"&role="work_state"

Enum.GetStatus Curl Request

curl -X POST -d '{"id":1,"method":"Enum.GetStatus","params":{"owner":"service:0","role":"work_state"}}' http://${SHELLY}/rpc

Enum.GetStatus Mos Request

mos --port ${PORT} call Enum.GetStatus '{"owner":"service:0","role":"work_state"}'

Response

Enum.GetStatus HTTP GET Response

{
  "value": "charger_free",
  "source": "",
  "last_update_ts": 0
}

Enum.GetStatus Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": {
    "value": "charger_free",
    "source": "",
    "last_update_ts": 0
  }
}

Enum.GetStatus Mos Response

{
  "value": "charger_free",
  "source": "",
  "last_update_ts": 0
}

How to set the current charging limit (to 10 A)

Number.Set HTTP GET Request

http://192.168.33.1/rpc/Number.Set?owner="service:0"&role="current_limit"&value=10

Number.Set Curl Request

curl -X POST -d '{"id":1,"method":"Number.Set","params":{"owner":"service:0","role":"current_limit","value":10}}' http://${SHELLY}/rpc

Number.Set Mos Request

mos --port ${PORT} call Number.Set '{"owner":"service:0","role":"current_limit","value":10}'

Response

Number.Set HTTP GET Response

null

Number.Set Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": null
}

Number.Set Mos Response

null

How to check the phase info

Object.GetStatus HTTP GET Request

http://192.168.33.1/rpc/Object.GetStatus?owner="service:0"&role="phase_info"

Object.GetStatus Curl Request

curl -X POST -d '{"id":1,"method":"Object.GetStatus","params":{"owner":"service:0","role":"phase_info"}}' http://${SHELLY}/rpc

Object.GetStatus Mos Request

mos --port ${PORT} call Object.GetStatus '{"owner":"service:0","role":"phase_info"}'

Response

Object.GetStatus HTTP GET Response

{
  "value": {
    "counter": {
      "total": 0,
      "minute_ts": 1761642960,
      "by_minute": [
        0,
        0,
        0
      ]
    },
    "total_current": 0,
    "total_power": 0,
    "total_act_energy": 0,
    "phase_a": {
      "voltage": 0,
      "current": 0,
      "power": 0
    },
    "phase_b": {
      "voltage": 0,
      "current": 0,
      "power": 0
    },
    "phase_c": {
      "voltage": 0,
      "current": 0,
      "power": 0
    }
  },
  "source": "sys",
  "last_update_ts": 1761643021
}

Object.GetStatus Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": {
    "value": {
      "counter": {
        "total": 0,
        "minute_ts": 1761642960,
        "by_minute": [
          0,
          0,
          0
        ]
      },
      "total_current": 0,
      "total_power": 0,
      "total_act_energy": 0,
      "phase_a": {
        "voltage": 0,
        "current": 0,
        "power": 0
      },
      "phase_b": {
        "voltage": 0,
        "current": 0,
        "power": 0
      },
      "phase_c": {
        "voltage": 0,
        "current": 0,
        "power": 0
      }
    },
    "source": "sys",
    "last_update_ts": 1761643021
  }
}

Object.GetStatus Mos Response

{
  "value": {
    "counter": {
      "total": 0,
      "minute_ts": 1761642960,
      "by_minute": [
        0,
        0,
        0
      ]
    },
    "total_current": 0,
    "total_power": 0,
    "total_act_energy": 0,
    "phase_a": {
      "voltage": 0,
      "current": 0,
      "power": 0
    },
    "phase_b": {
      "voltage": 0,
      "current": 0,
      "power": 0
    },
    "phase_c": {
      "voltage": 0,
      "current": 0,
      "power": 0
    }
  },
  "source": "sys",
  "last_update_ts": 1761643021
}

How to start a charging session

Boolean.Set HTTP GET Request

http://192.168.33.1/rpc/Boolean.Set?owner="service:0"&role="start_charging"&value=true

Boolean.Set Curl Request

curl -X POST -d '{"id":1,"method":"Boolean.Set","params":{"owner":"service:0","role":"start_charging","value":true}}' http://${SHELLY}/rpc

Boolean.Set Mos Request

mos --port ${PORT} call Boolean.Set '{"owner":"service:0","role":"start_charging","value":true}'

Response

Boolean.Set HTTP GET Response

null

Boolean.Set Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": null
}

Boolean.Set Mos Response

null

How to check the session energy consumption

Number.GetStatus HTTP GET Request

http://192.168.33.1/rpc/Number.GetStatus?owner="service:0"&role="energy_charge"

Number.GetStatus Curl Request

curl -X POST -d '{"id":1,"method":"Number.GetStatus","params":{"owner":"service:0","role":"energy_charge"}}' http://${SHELLY}/rpc

Number.GetStatus Mos Request

mos --port ${PORT} call Number.GetStatus '{"owner":"service:0","role":"energy_charge"}'

Response

Number.GetStatus HTTP GET Response

{
  "value": 5.37,
  "source": "sys",
  "last_update_ts": 1761637872
}

Number.GetStatus Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": {
    "value": 5.37,
    "source": "sys",
    "last_update_ts": 1761637872
  }
}

Number.GetStatus Mos Response

{
  "value": 5.37,
  "source": "sys",
  "last_update_ts": 1761637872
}

How to check the session duration

Number.GetStatus HTTP GET Request

http://192.168.33.1/rpc/Number.GetStatus?owner="service:0"&role="time_charge"

Number.GetStatus Curl Request

curl -X POST -d '{"id":1,"method":"Number.GetStatus","params":{"owner":"service:0","role":"time_charge"}}' http://${SHELLY}/rpc

Number.GetStatus Mos Request

mos --port ${PORT} call Number.GetStatus '{"owner":"service:0","role":"time_charge"}'

Response

Number.GetStatus HTTP GET Response

{
  "value": 128,
  "source": "sys",
  "last_update_ts": 1761643238
}

Number.GetStatus Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": {
    "value": 128,
    "source": "sys",
    "last_update_ts": 1761643238
  }
}

Number.GetStatus Mos Response

{
  "value": 128,
  "source": "sys",
  "last_update_ts": 1761643238
}

Service Configuration Example

Service.GetConfig HTTP GET Request

http://192.168.33.1/rpc/Service.GetConfig?id=0

Service.GetConfig Curl Request

curl -X POST -d '{"id":1,"method":"Service.GetConfig","params":{"id":0}}' http://${SHELLY}/rpc

Service.GetConfig Mos Request

mos --port ${PORT} call Service.GetConfig '{"id":0}'

Response

Service.GetConfig HTTP GET Response

{
  "auto_balance": {
    "enable": false,
    "em_ip": null,
    "max_current": 24,
    "exclude_self_current": true
  },
  "auto_charge": true,
  "global_charge_limit": null,
  "global_time_limit": null,
  "id": 0
}

Service.GetConfig Curl Response

{
  "id": 1,
  "src": "evcharger-543204516524",
  "params": {
    "auto_balance": {
      "enable": false,
      "em_ip": null,
      "max_current": 24,
      "exclude_self_current": true
    },
    "auto_charge": true,
    "global_charge_limit": null,
    "global_time_limit": null,
    "id": 0
  }
}

Service.GetConfig Mos Response

{
  "auto_balance": {
    "enable": false,
    "em_ip": null,
    "max_current": 24,
    "exclude_self_current": true
  },
  "auto_charge": true,
  "global_charge_limit": null,
  "global_time_limit": null,
  "id": 0
}