OBD scanners

Electric Sidecar Shortcuts

A technical guide to building workflows with Apple's Shortcuts app

Overview

Electric Sidecar makes it possible to build workflows that react to, and in some cases change, the state of your vehicle. If you're new to Shortcuts, Apple's introductory article for iPhone and iPad is a good place to learn the basics.

Vehicles

Every action provided by Electric Sidecar requires a Vehicle. This custom type represents one of the vehicles in your garage.

An example of selecting a vehicle in a Shortcut workflow

Tip: it's common to need to refer to the same Vehicle several times in a workflow. The Get Vehicle action lets you do this once and then reuse the same vehicle variable throughout your workflow.

Actions

Electric Sidecar's actions come in two flavors: Commands and Parameters. Commands require a Connected Account (Beta) and tell your vehicle to perform some kind of action. Parameters allow you to read information from your vehicle. Parameters are typically read by Electric Sidecar from a Connected Account (Beta) or from an OBD-II scanner.

Commands

Climate Control

Navigation

Vehicle Control

Parameters

Vehicles


Turn Climatization Off — Command

Requires a Connected Account (Beta). Requires vehicle support for auto-climatization.

Supported accounts

Porsche, Tesla, Toyota.

Description

Running this command will disable climatization if it is currently active.

Parameters

Vehicle The vehicle this command should be performed on.


Turn Climatization On — Command

Requires a Connected Account (Beta). Requires vehicle support for auto-climatization.

Supported accounts

Porsche, Tesla, Toyota.

Description

Running this command will enable climatization if it is not currently active.

Parameters

Vehicle The vehicle this command should be performed on.


Send Destination — Command

Requires a Connected Account (Beta). Requires vehicle support for sending remote destinations.

Supported accounts

Porsche.

Description

Running this command will send the given destination to your vehicle's primary navigation system. You'll then be able to initiate navigation to the destination from your vehicle's console.

Parameters


Lock — Command

Requires a Connected Account (Beta). Requires vehicle support for remote locking.

Supported accounts

Porsche, Tesla, Toyota.

Description

Running this command will lock your vehicle if it is not currently locked. This may cause the vehicle to make an audible chirp once complete.

Parameters

Vehicle The vehicle this command should be performed on.


Get Vehicle — Parameter

Works with all vehicles.

An example of a vehicle action

Description

Running this action will return a Vehicle instance that can be used as a variable in subsequent actions.

Parameters

Vehicle The vehicle to return.


Get Vehicle Bool — Parameter

Some parameters require a Connected Account (Beta) or OBD-II scanner. Parameter support varies by vehicle.

An example of a bool action

Description

Running this action will return the value of true or false for a given vehicle's parameter.

Parameters

Available Boolean Parameters

Charging

Climate Control

Locked

Open

Parking

State


Get Vehicle Date — Parameter

Some parameters require a Connected Account (Beta) or OBD-II scanner. Parameter support varies by vehicle.

An example of a date action

Description

Running this action will return a date value for a given vehicle's parameter.

Parameters

Available Date Parameters

Climate Control

Parking


Get Vehicle Measure — Parameter

Some parameters require a Connected Account (Beta) or OBD-II scanner. Parameter support varies by vehicle.

An example of a measure action

Description

Running this action will return a measured value for a given vehicle's parameter in the specified units.

Measures must be converted to the same unit type. For example, Vehicle speed can only be converted to units of type Speed.

Parameters

Available Measure Parameters

Charging

Health

Navigation

Range

Tire Pressure

Trips


Get Vehicle Position — Parameter

Some parameters require a Connected Account (Beta) or OBD-II scanner. Parameter support varies by vehicle.

An example of a position action

Description

Running this action will return a position value for a given vehicle's parameter.

Parameters

Available Position Parameters

Navigation