Go to file
robbederks 6f532c6d51 Black panda Jenkins (#256)
* Jenkins test refactor and black panda addition

* Added HW types needed by previous commit

* Fixed ignition interrupts when not on EON build

* Added functions for load switches

* More test scripts for black panda

* Added NONE power mode to the code

* Fixed race condition when setting GPIO pins was interrupted.

* Added relay test script

* Fixed flashing with critical sections and GPS load switch

* Fixing critical depth after reboot

* Made the loopback test asserting

* Made critical depth a local variable to avoid race conditions

* Added GPS to power savings mode

* Fixed DFU mode on white panda and bumped version

* Fixed PEDAL_USB compilation error

* Fixed misra compliance of new critical depth code

* Cleaned up heartbeat logic in the testing code. Re-added ALL_CAN_BUT_MAIN_SILENT. Bumped version. Improved critical section code.

* Fixed DFU flashing (once again)

* Fixed VERSION

* Added relay endurance test

* Changed to alloutput on ELM mode for fingerprinting.

* Fixed minor remarks
2019-08-28 12:57:42 -07:00
.circleci no need to store safety only misra output anymore 2019-07-23 14:40:15 -07:00
board Black panda Jenkins (#256) 2019-08-28 12:57:42 -07:00
boardesp remove chffr link 2019-08-02 18:25:18 -07:00
certs add crypto stuff to ESP as well 2017-04-27 22:06:31 -07:00
common Fix Pedal bootstub version 2019-03-22 21:06:47 -07:00
crypto remove whitespace (#255) 2019-07-19 19:35:50 -07:00
docs move the guide to docs 2017-04-06 18:15:13 -07:00
drivers remove whitespace (#255) 2019-07-19 19:35:50 -07:00
examples remove whitespace (#255) 2019-07-19 19:35:50 -07:00
python Black panda Jenkins (#256) 2019-08-28 12:57:42 -07:00
release more noob friendly release flashing 2017-08-23 20:46:34 -07:00
tests Black panda Jenkins (#256) 2019-08-28 12:57:42 -07:00
.dockerignore Jenkins (#179) 2019-04-09 14:09:18 -07:00
.gitignore Black panda Jenkins (#256) 2019-08-28 12:57:42 -07:00
Dockerfile Update jenkinsfile (#193) 2019-05-21 09:09:30 -07:00
Jenkinsfile cleanup docker container on failure 2019-07-10 10:19:44 -07:00
LICENSE initial commit 2017-04-06 18:11:36 -07:00
README.md update README 2019-01-02 22:00:21 -08:00
TODO update TODO 2017-05-29 11:38:49 -07:00
UPDATING.md Add a small UPDATING.md 2017-08-25 14:06:02 -04:00
VERSION Black panda Jenkins (#256) 2019-08-28 12:57:42 -07:00
__init__.py add PandaSerial and location panda (aka pigeon) test 2018-01-07 11:31:54 -08:00
buy.png update price 2019-05-22 08:32:56 -07:00
panda.png update readme graphics 2018-05-10 00:01:08 -07:00
requirements.txt Jenkins (#179) 2019-04-09 14:09:18 -07:00
run_automated_tests.sh remove esp flash from run_automated_tests.sh 2019-07-08 15:17:45 -07:00
setup.cfg Created python package and implemented industry best practices. 2017-06-14 12:00:04 -07:00
setup.py cap libusb1 version in setup (#183) 2019-04-18 12:07:34 -07:00

README.md

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.

CircleCI

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)

Programming the Board (STM32)

Programming the ESP

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.