92 lines
4.4 KiB
Markdown
92 lines
4.4 KiB
Markdown
# Welcome to panda
|
|
|
|
panda speaks CAN and CAN FD, and it runs on [STM32F413](https://www.st.com/resource/en/reference_manual/rm0430-stm32f413423-advanced-armbased-32bit-mcus-stmicroelectronics.pdf) and [STM32H725](https://www.st.com/resource/en/reference_manual/rm0468-stm32h723733-stm32h725735-and-stm32h730-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf).
|
|
|
|
## Directory structure
|
|
|
|
```
|
|
.
|
|
├── board # Code that runs on the STM32
|
|
├── drivers # Drivers (not needed for use with Python)
|
|
├── python # Python userspace library for interfacing with the panda
|
|
├── tests # Tests for panda
|
|
├── scripts # Miscellaneous used for panda development and debugging
|
|
├── examples # Example scripts for using a panda in a car
|
|
```
|
|
|
|
## Safety Model
|
|
|
|
panda is compiled with safety firmware provided by [opendbc](https://github.com/commaai/opendbc). See details about the car safety models, safety testing, and code rigor in that repository.
|
|
|
|
## Code Rigor
|
|
|
|
The panda firmware is written for its use in conjunction with [openpilot](https://github.com/commaai/openpilot). The panda firmware, through its safety model, provides and enforces the
|
|
[openpilot safety](https://github.com/commaai/openpilot/blob/master/docs/SAFETY.md). Due to its critical function, it's important that the application code rigor within the `board` folder is held to high standards.
|
|
|
|
These are the [CI regression tests](https://github.com/commaai/panda_tici/actions) we have in place:
|
|
* A generic static code analysis is performed by [cppcheck](https://github.com/danmar/cppcheck/).
|
|
* In addition, [cppcheck](https://github.com/danmar/cppcheck/) has a specific addon to check for [MISRA C:2012](https://misra.org.uk/) violations. See [current coverage](https://github.com/commaai/panda_tici/blob/master/tests/misra/coverage_table).
|
|
* Compiler options are relatively strict: the flags `-Wall -Wextra -Wstrict-prototypes -Werror` are enforced.
|
|
* The [safety logic](https://github.com/commaai/panda_tici/tree/master/opendbc/safety) is tested and verified by [unit tests](https://github.com/commaai/panda_tici/tree/master/opendbc/safety/tests) for each supported car variant.
|
|
to ensure that the behavior remains unchanged.
|
|
* A hardware-in-the-loop test verifies panda's functionalities on all active panda variants, including:
|
|
* additional safety model checks
|
|
* compiling and flashing the bootstub and app code
|
|
* receiving, sending, and forwarding CAN messages on all buses
|
|
* CAN loopback and latency tests through USB and SPI
|
|
|
|
The above tests are themselves tested by:
|
|
* a [mutation test](tests/misra/test_mutation.py) on the MISRA coverage
|
|
|
|
In addition, we run the [ruff linter](https://github.com/astral-sh/ruff) and [mypy](https://mypy-lang.org/) on panda's Python library.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
git clone https://github.com/commaai/panda_tici.git
|
|
cd panda
|
|
|
|
# setup your environment
|
|
./setup.sh
|
|
|
|
# build fw + run the tests
|
|
./test.sh
|
|
```
|
|
|
|
See [the Panda class](https://github.com/commaai/panda_tici/blob/master/python/__init__.py) for how to interact with the panda.
|
|
|
|
For example, to receive CAN messages:
|
|
``` python
|
|
>>> from panda_tici import Panda
|
|
>>> panda = Panda()
|
|
>>> panda.can_recv()
|
|
```
|
|
And to send one on bus 0:
|
|
``` python
|
|
>>> from opendbc.car.structs import CarParams
|
|
>>> panda.set_safety_mode(CarParams.SafetyModel.allOutput)
|
|
>>> panda.can_send(0x1aa, b'message', 0)
|
|
```
|
|
Note that you may have to setup [udev rules](https://github.com/commaai/panda_tici/tree/master/drivers/linux) for Linux, such as
|
|
``` bash
|
|
sudo tee /etc/udev/rules.d/11-panda.rules <<EOF
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", MODE="0666"
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="3801", ATTRS{idProduct}=="ddcc", MODE="0666"
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="3801", ATTRS{idProduct}=="ddee", MODE="0666"
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="bbaa", ATTRS{idProduct}=="ddcc", MODE="0666"
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="bbaa", ATTRS{idProduct}=="ddee", MODE="0666"
|
|
EOF
|
|
sudo udevadm control --reload-rules && sudo udevadm trigger
|
|
```
|
|
|
|
The panda jungle uses different udev rules. See [the repo](https://github.com/commaai/panda_jungle#udev-rules) for instructions.
|
|
|
|
## Software interface support
|
|
|
|
- [Python library](https://github.com/commaai/panda_tici/tree/master/python)
|
|
- [C++ library](https://github.com/commaai/openpilot/tree/master/selfdrive/pandad)
|
|
|
|
## Licensing
|
|
|
|
panda software is released under the MIT license unless otherwise specified.
|