Go to file
Nigel Armstrong 1d2f8f0abf
Jenkins (#179)
* Improve panda automated testing

 * begin testing both white and grey panda
 * Improve wifi reliability

* First commit for docker

* Fix usb devices not showing up on reconnect

* Add tests for two pandas, latency and throughput

* Add Jenkinsfile

* Allow flashing release on wifi

* Fix Jenkins stuck in DFU mode and docker container running

* Add pandaextra from xx to docker

* Need more time for ST to restart, sometimes

* Add xml output to tests

* Try making wifi more reliable

* Fix infinite loop in ping

* Check connected after flash

* Cleanup two panda tests

* Try fixing failing test with check after udp

* Try to fix with sleep

* Temporarily run just 5 and 6

* Cleanup

* Desperate times call for desperate measurse

* BUGFIX: power saving when rx only

* Fix failing when white panda is first after udp

* Test both Dev and EON build

* Jenkins test results for both builds

* Better test case naming
2019-04-09 14:09:18 -07:00
.circleci CircleCI needs to check bootstub doesn't break too 2019-03-22 20:42:23 -07:00
board Power saving: wake on RX and don't print durint IRQ 2019-04-08 19:21:37 -07:00
boardesp Jenkins (#179) 2019-04-09 14:09: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 Fixed undefined reference error when "make recover" in EON 2019-02-13 00:43:30 -08:00
docs move the guide to docs 2017-04-06 18:15:13 -07:00
drivers update J2534 install instructions 2018-07-12 10:08:34 -07:00
examples Example to get wifi password from panda over USB using python library 2018-08-06 16:02:17 -04:00
python Jenkins (#179) 2019-04-09 14:09:18 -07:00
release more noob friendly release flashing 2017-08-23 20:46:34 -07:00
tests Jenkins (#179) 2019-04-09 14:09:18 -07:00
.dockerignore Jenkins (#179) 2019-04-09 14:09:18 -07:00
.gitignore Safety code testing (#104) 2018-04-02 20:41:52 +02:00
Dockerfile Jenkins (#179) 2019-04-09 14:09:18 -07:00
Jenkinsfile Jenkins (#179) 2019-04-09 14:09:18 -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 bump VERSION 2019-02-13 00:46:34 -08:00
__init__.py add PandaSerial and location panda (aka pigeon) test 2018-01-07 11:31:54 -08:00
buy.png make it smaller 2019-01-12 15:47:11 -08: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 Jenkins (#179) 2019-04-09 14:09:18 -07:00
setup.cfg Created python package and implemented industry best practices. 2017-06-14 12:00:04 -07:00
setup.py fix setup.py for new dir structure 2017-12-06 16:23:25 -08: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.