Skip to content

Latest commit

 

History

History
39 lines (30 loc) · 2.12 KB

README.md

File metadata and controls

39 lines (30 loc) · 2.12 KB

TinyEKF: Lightweight C/C++ Extended Kalman Filter with Arduino Sensor Fusion Example and Python prototyping

TinyEKF is a simple C/C++ implementation of the Extended Kalman filter that is general enough to use on different projects. In order to make it practical for running on Arduino, STM32, and other microcontrollers, it uses static (compile-time) memory allocation (no "new" or "malloc"). The examples folder includes both a "pure C" example from the literature, as well as an Arduino example of sensor fusion. The python folder includes an abstract Python class that you can use to prototype your EKF before implementing it in C/C++.

Arduino users can simply install or drag the whole TinyEKF folder into their Arduino libraries folder. The TinyEKF folder contains a little sensor fusion example using a BMP180 barometer and LM35 temperature sensor. I have run this example on an Arduino Uno and a Teensy 3.2. The BMP180, being an I^2C sensor, should be connected to pins 4 (SDA) and 5 (SCL) of the Uno, or pins 18 (SDA) and 19 (SCL) of the Teensy. For other Arduino boards, consult the documentation on the Wire library. The analog output from the LM35 should go to the A0 pin of your Arduino or Teensy.

In addition to the class definition, the python folder has an example of mouse tracking, using OpenCV. So you will have to install OpenCV to run this example. There is also a sensor-fusion example in this folder, which uses the RealtimePlotter package, requiring Matplotlib.

To learn about the Extended Kalman Filter and why it is so useful, try this interactive tutorial.

Fork

Changes

  • Make State transition and State-Msmt transition functions explicit
  • Some changes to integrate into ROS c++ systems for testing with other EKF implementations
  • Some cleanup, variable name changes

Build

  • cd native
  • make clean
  • make compile
  • lib is created in build folder