Carwings protocol

:Nissan Leaf
Carwings is the telematics system installed in the Leaf. It has four endpoints, apparently:

  1. The cellular modem in your car
  2. The data center, operated by Airbiquity
  3. The web-based Carwings interface
  4. An XML-RPC-like proxy used by the iOS and Android applications

Mobile app proxy

The mobile app proxy is located at https://nissan-na-smartphone-biz.viaaq.com and allows iOS and Android apps to interact with your car’s telematics.
There are at least two endpoints

User Service

Located at https://nissan-na-smartphone-biz.viaaq.com/aqPortal/smartphoneProxy/userService
This is used during initial sign-in, as well as later to retrieve vehicle status. When logging in, the application POSTs the following:

YOUR_CARWINGS_USERNAMEYOUR_CARWINGS_PASSWORDDUMMY1313820504.22296500YOUR_DEVICE_UNIQUE_IDUS1.40IPHONESmartphoneGetPreferencesRequestSmartphoneLatestBatteryStatusRequestSmartphoneLatestACStatusRequestSmartphoneGetScheduledACRemoteRequest

If the user is authenticated, the system will return two cookies (a JSESSIONID, and a BIGipServernissan-na-smartphone-biz-POOL). These cookies are submitted for each subsequent request to the server.

*REDACTED*VEHICLE_VIN_VALUEleafSTART2011-08-20T04:20:59.0NORMAL_CHARGING128CONNECTED90624104448602011-08-20T04:21:15.0*REDACTED*VEHICLE_VIN_VALUE2011-08-20T04:20:59.000ZFINISH2011-08-18T16:45:32.0START2011-08-18T16:45:32.0139608166200NOT_CONNECTED7200900*REDACTED*VEHICLE_VIN_VALUE*REDACTED*VEHICLE_VIN_VALUEfalsefalsefalsefalsefalsefalsefalsefalsefalsefalsefalsefalsefalsefalsefalse*REDACTED*VEHICLE_VIN_VALUE

Some notes on the above:

  • BatteryStatus
  • BatteryChargingStatus is showing a car plugged into a trickle charger
  • BatteryRemainingAmount is the number of SOC bars
  • CruisingRangeAcOn and ..AcOff
  • This value is in meters
  • All times are in UTC

Vehicle Service

Located at https://nissan-na-smartphone-biz.viaaq.com/aqPortal/smartphoneProxy/vehicleService

Updated on October 12, 2018

Related Articles

Contribute to this EV Wiki: