d21c6591c1
9ee6285 optimize board build for size to avoid going over the limit. (#150) 20e8fa9 Start introducing Bounties a2046e9 make it smaller 1dfcf2b update panda price 37ee289 chrysler safety: fixed comments c2dfbad tesla safety: return -1 to block forward (#149) 74c0c1b update README be0061d Chrysler: safety now based on motor torque 039d183 Chrysler: fixed regression test 9193eeb Chrysler: safety limits updated 04f1d44 Chrysler safety: 3 sa max rate down for now cf3ecd6 Chrysler safety: re-using hyundai framework 49ed9bc Update CLICKS for longer bootup time of EONS and avoid unwanted fast charge mode git-subtree-dir: panda git-subtree-split: 9ee628557f3f33759c62b567964b918a597d3387
3.2 KiB
Welcome to panda
panda is the nicest universal car interface ever.
It supports 3x CAN, 2x LIN, and 1x GMLAN. It also charges a phone. On the computer side, it has both USB and Wi-Fi.
It uses an STM32F413 for low level stuff and an ESP8266 for Wi-Fi. They are connected over high speed SPI, so the panda is actually capable of dumping the full contents of the busses over Wi-Fi, unlike every other dongle on amazon. ELM327 is weak, panda is strong.
It is 2nd gen hardware, reusing code and parts from the NEO interface board.
Usage (Python)
To install the library:
# pip install pandacan
See this class for how to interact with the panda.
For example, to receive CAN messages:
>>> from panda import Panda
>>> panda = Panda()
>>> panda.can_recv()
And to send one on bus 0:
>>> panda.can_send(0x1aa, "message", 0)
Find user made scripts on the wiki
Usage (JavaScript)
See PandaJS
Software interface support
As a universal car interface, it should support every reasonable software interface.
Directory structure
- board -- Code that runs on the STM32
- boardesp -- Code that runs on the ESP8266
- drivers -- Drivers (not needed for use with python)
- python -- Python userspace library for interfacing with the panda
- tests -- Tests and helper programs for panda
Programming (over USB)
Debugging
To print out the serial console from the STM32, run tests/debug_console.py
To print out the serial console from the ESP8266, run PORT=1 tests/debug_console.py
Safety Model
When a panda powers up, by default it's in "SAFETY_NOOUTPUT" mode. While in no output mode, the buses are also forced to be silent. In order to send messages, you have to select a safety mode. Currently, setting safety modes is only supported over USB.
Safety modes can also optionally support "controls_allowed", which allows or blocks a subset of messages based on a piece of state in the board.
Hardware
Check out the hardware guide
Licensing
panda software is released under the MIT license unless otherwise specified.