An unofficial NodeJS library to make OnStar requests.
Use at your own risk. This is an unofficial library.
Use the Get Account Vehicles request to see which requests your vehicle supports.
Use a random version 4 uuid (there are online generators) as a deviceId.
import OnStar from "onstarjs";
const config = {
deviceId: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
vin: "1G2ZF58B774109863",
username: "foo@bar.com",
password: "p@ssw0rd",
onStarPin: "1234",
checkRequestStatus: true, // When false, requests are complete when 'In Progress' (Much faster).
};
const onStar = OnStar.create(config);
onStar
.alert({
action: ["Flash"],
})
.then(() => {
onStar.start();
})
.catch(e => console.log(e));
onStar.getAccountVehicles();
onStar.start();
onStar.cancelStart();
onStar.alert([options]);
Option | Default | Valid Values |
---|---|---|
action | ["Flash", "Honk"] | ["Flash", "Honk"] |
delay | 0 | Any integer (minutes) |
duration | 1 | Any integer (minutes) |
override | ["DoorOpen", "IgnitionOn"] | ["DoorOpen", "IgnitionOn"] |
onStar.cancelAlert();
onStar.lockDoor([options]);
Option | Default | Valid Values |
---|---|---|
delay | 0 | Any integer (minutes) |
onStar.unlockDoor([options]);
Option | Default | Valid Values |
---|---|---|
delay | 0 | Any integer (minutes) |
onStar.chargeOverride([options]);
Option | Default | Valid Values |
---|---|---|
mode | "CHARGE_NOW" | "CHARGE_NOW", "CANCEL_OVERRIDE" |
onStar.getChargingProfile();
onStar.setChargingProfile([options]);
Option | Default | Valid Values |
---|---|---|
chargeMode | "IMMEDIATE" | "DEFAULT_IMMEDIATE", "IMMEDIATE", "DEPARTURE_BASED", "RATE_BASED", "PHEV_AFTER_MIDNIGHT" |
rateType | "MIDPEAK" | "OFFPEAK", "MIDPEAK", "PEAK" |
onStar.diagnostics([options]);
Option | Default | Valid Values |
---|---|---|
diagnosticItem | ["ODOMETER", "TIRE PRESSURE", "AMBIENT AIR TEMPERATURE", "LAST TRIP DISTANCE"] | ["ENGINE COOLANT TEMP", "ENGINE RPM", "LAST TRIP FUEL ECONOMY", "EV ESTIMATED CHARGE END", "EV BATTERY LEVEL", "OIL LIFE", "EV PLUG VOLTAGE", "LIFETIME FUEL ECON", "HOTSPOT CONFIG", "LIFETIME FUEL USED", "ODOMETER", "HOTSPOT STATUS", "LIFETIME EV ODOMETER", "EV PLUG STATE", "EV CHARGE STATE", "TIRE PRESSURE", "AMBIENT AIR TEMPERATURE", "LAST TRIP DISTANCE", "INTERM VOLT BATT VOLT", "GET COMMUTE SCHEDULE", "GET CHARGE MODE", "EV SCHEDULED CHARGE START", "FUEL TANK INFO", "HANDS FREE CALLING", "ENERGY EFFICIENCY", "VEHICLE RANGE"] |
yarn test:unit
These tests will execute actual requests to the OnStar API. They will perform a Get Account Vehicles request followed by a Cancel Alert request.
Because of this, the test will require actual OnStar credentials to run. To provide them, copy .env.example
to .env
and replace the placeholder values inside.
yarn test:functional
Run both unit and functional tests
yarn test
Made possible by mikenemat's work in gm-onstar-probe. Their work describing the process for remote start enabled the rest of the methods implemented here.