0d126e1e9e
* segment range reader * rename that * revert that * cleanup * revert this for now * revert this for now * Fix + test * rm that * rm that * use for auto_fingerprint * simpler * for notebook too * match numpy indexing * just use numpy directly * remove that * spacing * spacing * use qlog for auto fingerprint * add 'read mode' * pass in read mode * add test for modes * numpy indexing * fix that case * more examples * fix the notebook * cleanup the notebook * cleaner * fix those
tools/car_porting
Check out this blog post for a high-level overview of porting a car.
Useful car porting utilities
Testing car ports in your car is very time-consuming. Check out these utilities to do basic checks on your work before running it in your car.
Cabana
View your car's CAN signals through DBC files, which openpilot uses to parse and create messages that talk to the car.
Example:
> tools/cabana/cabana '1bbe6bf2d62f58a8|2022-07-14--17-11-43'
tools/car_porting/auto_fingerprint.py
Given a route and platform, automatically inserts FW fingerprints from the platform into the correct place in fingerprints.py
Example:
> python tools/car_porting/auto_fingerprint.py '1bbe6bf2d62f58a8|2022-07-14--17-11-43' 'SUBARU OUTBACK 6TH GEN'
Attempting to add fw version for: SUBARU OUTBACK 6TH GEN
selfdrive/car/tests/test_car_interfaces.py
Finds common bugs for car interfaces, without even requiring a route.
Example: Typo in signal name
> pytest selfdrive/car/tests/test_car_interfaces.py -k subaru # replace with the brand you are working on
=====================================================================
FAILED selfdrive/car/tests/test_car_interfaces.py::TestCarInterfaces::test_car_interfaces_165_SUBARU_LEGACY_7TH_GEN - KeyError: 'CruiseControlOOPS'
tools/car_porting/test_car_model.py
Given a route, runs most of the car interface to check for common errors like missing signals, blocked panda messages, and safety mismatches.
Example: panda safety mismatch for gasPressed
> python tools/car_porting/test_car_model.py '4822a427b188122a|2023-08-14--16-22-21'
=====================================================================
FAIL: test_panda_safety_carstate (__main__.CarModelTestCase.test_panda_safety_carstate)
Assert that panda safety matches openpilot's carState
----------------------------------------------------------------------
Traceback (most recent call last):
File "/home/batman/xx/openpilot/openpilot/selfdrive/car/tests/test_models.py", line 380, in test_panda_safety_carstate
self.assertFalse(len(failed_checks), f"panda safety doesn't agree with openpilot: {failed_checks}")
AssertionError: 1 is not false : panda safety doesn't agree with openpilot: {'gasPressed': 116}
tools/car_porting/examples/subaru_steer_temp_fault.ipynb
An example of searching through a database of segments for a specific condition, and plotting the results.
a plot of the steer_warning vs steering angle, where we can see it is clearly caused by a large steering angle change