Skip to content

Commit

Permalink
Add output interpretation section to Readme.md
Browse files Browse the repository at this point in the history
Closes #2.
  • Loading branch information
ataffanel authored Aug 1, 2018
1 parent 6993ac2 commit 00bdb17
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,3 +34,9 @@ As soon as it is initialized, the sensor will start accumulating motion count. C
// Get motion count since last call
flow.readMotionCount(&deltaX, &deltaY);
```

## Output interpretation

The sensor outputs unitless ticks that corresponds to the amount of movement that has been observed in front of the sensor. These ticks can be converted to a distance if we know the distance to the tracked surface and we assume the tracked surface is flat.

Parameters of the PMW3901 sensor have been devised experimentally in order to implement it in the Crazyflie firmware. The measurement equation are described in [Marcus Greiff's Master thesis](http://lup.lub.lu.se/luur/download?func=downloadFile&recordOId=8905295&fileOId=8905299) section 6.5. The implementation is part or the [Crazyflie kalman filter](https://github.com/bitcraze/crazyflie-firmware/blob/6308ff47ff4d4691f9b7f6f991564244c76d7910/src/modules/src/estimator_kalman.c#L1034-L1098).

0 comments on commit 00bdb17

Please sign in to comment.