This library allows an Arduino board to easily communicate with PMW3389 Module. This library is a copy version of Sunjun Kim's pwm3360-master, which is made to correspond to the 3389. This library is designed for https://www.tindie.com/products/jkicklighter/pmw3389-motion-sensor/ However, other setup will also work (e.g., https://easyeda.com/Justice/New_Project-cc5450b338fd4d55bef91ec37025ab6a).
For the most basic example, please take look at [basic_polling] example. [basic_interrupt] example is using movement interrupt pin (MT) on the module. It does SPI transmission only if any movement is detects. [HID_mouse] example will work as a regular mouse with left/right buttons.
- void begin(unsigned int ss_pin, unsigned int CPI = 800)
- Initialize the sensor. ss_pin is Slave Select pin on the module. Optionally CPI value can be set.
- void setCPI(unsigned int newCPI); / unsigned int getCPI();
- Set/get CPI (Count per Inch).
- PMW3389_DATA readBurst();
- Read sensor motion data using burst mode operation.
- PMW3389_DATA is a struct that contains various information about a motion.
- PMW3389_DATA.isMotion : bool, True if a motion is detected.
- PMW3389_DATA.isOnSurface : bool, True when a chip is on a surface
- PMW3389_DATA.dx, data.dy : integer, displacement on x/y directions.
- PMW3389_DATA.SQUAL : byte, Surface Quality register, max 0x80 * Number of features on the surface = SQUAL * 8
- PMW3389_DATA.rawDataSum : byte, It reports the upper byte of an 18‐bit counter which sums all 1296 raw data in the current frame; * Avg value = Raw_Data_Sum * 1024 / 1296
- PMW3389_DATA.maxRawData : byte, Max/Min raw data value in current frame, max=127 PMW3389_DATA.minRawData
- PMW3389_DATA.shutter : unsigned int, shutter is adjusted to keep the average raw data values within normal operating ranges.
- byte readReg(byte reg_addr);
- Read register value from the module.
- void writeReg(byte reg_addr, byte data);
- Write register value to the module.
Notice: some part of the code is based on https://github.com/mrjohnk/PMW3360DM-T2QU, https://github.com/SunjunKim/PMW3360_Arduino/tree/master/library Disclaimer: This is not a PixArt official library. USE AT YOUR OWN RISK.
Copyright (c) Minhyeok Baek, Sunjun Kim. All right reserved.
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3.0 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
- v1.0.0
- Initial release
- v1.1.0
- Wheel code added