Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Unknown keys #130

Open
zulufoxtrot opened this issue Nov 16, 2022 · 4 comments
Open

Unknown keys #130

zulufoxtrot opened this issue Nov 16, 2022 · 4 comments

Comments

@zulufoxtrot
Copy link
Collaborator

zulufoxtrot commented Nov 16, 2022

I am using the Kia EU API (e-niro 2020)
Wondering what these keys represent in the response to /status/latest:

  • ign3 (bool)
  • sleepModeCheck (bool)
  • tailLampStatus (int)
  • systemCutOffAlert (int)
  • hazardStatus (int)
  • remoteWaitingTimeAlert (dict)
  • battery.batState (int)
  • airTemp.hvacTempType (int)
  • acc (bool)
  • transCond (bool)

If I can be of any help to investigate, let me know.

Full response:

  'vehicleLocation': {
    'coord': {
      'lat': 43.422603,
      'lon': 5.288278,
      'alt': 0,
      'type': 0
    },
    'head': 40,
    'speed': {
      'value': 0,
      'unit': 1
    },
    'accuracy': {
      'hdop': 0,
      'pdop': 0
    },
    'time': '20221116143811'
  },
  'vehicleStatus': {
    'airCtrlOn': False,
    'engine': False,
    'doorLock': False,
    'doorOpen': {
      'frontLeft': 0,
      'frontRight': 0,
      'backLeft': 0,
      'backRight': 0
    },
    'trunkOpen': False,
    'airTemp': {
      'value': '02H',
      'unit': 0,
      'hvacTempType': 1
    },
    'defrost': False,
    'acc': False,
    'evStatus': {
      'batteryCharge': False,
      'batteryStatus': 62,
      'batteryPlugin': 0,
      'remainTime2': {
        'etc1': {
          'value': 21,
          'unit': 1
        },
        'etc2': {
          'value': 630,
          'unit': 1
        },
        'etc3': {
          'value': 205,
          'unit': 1
        },
        'atc': {
          'value': 630,
          'unit': 1
        }
      },
      'drvDistance': [
        {
          'rangeByFuel': {
            'evModeRange': {
              'value': 271,
              'unit': 1
            },
            'totalAvailableRange': {
              'value': 271,
              'unit': 1
            }
          },
          'type': 2
        }
      ],
      'reservChargeInfos': {
        'reservChargeInfo': {
          'reservChargeInfoDetail': {
            'reservInfo': {
              'day': [
                9
              ],
              'time': {
                'time': '1200',
                'timeSection': 0
              }
            },
            'reservChargeSet': False,
            'reservFatcSet': {
              'defrost': False,
              'airTemp': {
                'value': '00H',
                'unit': 0,
                'hvacTempType': 1
              },
              'airCtrl': 0,
              'heating1': 0
            }
          }
        },
        'offpeakPowerInfo': {
          'offPeakPowerTime1': {
            'starttime': {
              'time': '1200',
              'timeSection': 0
            },
            'endtime': {
              'time': '1200',
              'timeSection': 0
            }
          },
          'offPeakPowerFlag': 0
        },
        'reserveChargeInfo2': {
          'reservChargeInfoDetail': {
            'reservInfo': {
              'day': [
                9
              ],
              'time': {
                'time': '1200',
                'timeSection': 0
              }
            },
            'reservChargeSet': False,
            'reservFatcSet': {
              'defrost': False,
              'airTemp': {
                'value': '00H',
                'unit': 0,
                'hvacTempType': 1
              },
              'airCtrl': 0,
              'heating1': 0
            }
          }
        },
        'reservFlag': 0,
        'ect': {
          'start': {
            'day': 9,
            'time': {
              'time': '1200',
              'timeSection': 0
            }
          },
          'end': {
            'day': 9,
            'time': {
              'time': '1200',
              'timeSection': 0
            }
          }
        },
        'targetSOClist': [
          {
            'targetSOClevel': 80,
            'plugType': 0
          },
          {
            'targetSOClevel': 90,
            'plugType': 1
          }
        ]
      }
    },
    'ign3': False,
    'hoodOpen': False,
    'transCond': True,
    'steerWheelHeat': 2,
    'sideBackWindowHeat': 0,
    'tirePressureLamp': {
      'tirePressureLampAll': 0,
      'tirePressureLampFL': 0,
      'tirePressureLampFR': 0,
      'tirePressureLampRL': 0,
      'tirePressureLampRR': 0
    },
    'battery': {
      'batSoc': 75,
      'batState': 0
    },
    'sleepModeCheck': True,
    'time': '20221116143814',
    'remoteWaitingTimeAlert': {
      'remoteControlAvailable': 1,
      'remoteControlWaitingTime': 168,
      'elapsedTime': '00:03:40'
    },
    'systemCutOffAlert': 0,
    'tailLampStatus': 0,
    'hazardStatus': 0
  },
  'odometer': {
    'value': 33724,
    'unit': 1
  }
}
@cdnninja
Copy link
Collaborator

My guess on these:

sleepModeCheck (bool) - I think some cars go into sleep for checking in with the API?
hazardStatus (int) - I assume this is 4 way hazard button status

Really only way to figure this out is try find the item in the mobile app. If you find it and its a bool should have the answer. If not may need to test with the car.

Unfortunately since I am a different region I can't help much. If you figure out what they are feel free to create a PR to add the item to vehicle and map it for the EU. This whole project has been created via feedback and tinkering to understand the API for each region. We haven't captured every metric, mostly the ones useful for home assistant.

@zulufoxtrot
Copy link
Collaborator Author

Thanks for your input. I couldn't find any obvious matches in the mobile app.
I'll drop a PR if I find something.

In the meantime here are screenshots of the more "obscure" parts of the app, if it's any inspiration...

IMG_1803
IMG_1804
IMG_1805
IMG_1806
IMG_1807
IMG_1808

@zulufoxtrot
Copy link
Collaborator Author

zulufoxtrot commented Nov 17, 2022

Investigated a bit today - here's what I found:

Field acc ign3 sleepmodecheck
state when engine running true true false
state when ignition on true true false
state when in utility mode true true false
state when ignition off false true false

That's about it... still can't deduce what it's for.
Don't know about the other fields.

@chrisglencross
Copy link

chrisglencross commented May 5, 2023

My car's 12V battery went completely flat for some reason overnight and now battery.batState is returning 1 instead of 0 and the battery.batSoc value is no longer present, even after the 12V battery has been recharged with jump cables.

I guess batState is some kind of error flag, with 0 meaning okay and 1 meaning something bad? Found this issue trying to find some documentation for the field.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants