zr-v4/libraries/AP_OpticalFlow/AP_OpticalFlow_ADNS3080.h

#ifndef __AP_OPTICALFLOW_ADNS3080_H__
#define __AP_OPTICALFLOW_ADNS3080_H__

#include <AP_HAL.h>
#include "AP_OpticalFlow.h"

// orientations for ADNS3080 sensor
#define AP_OPTICALFLOW_ADNS3080_PINS_FORWARD ROTATION_YAW_180
#define AP_OPTICALFLOW_ADNS3080_PINS_FORWARD_RIGHT ROTATION_YAW_135
#define AP_OPTICALFLOW_ADNS3080_PINS_RIGHT ROTATION_YAW_90
#define AP_OPTICALFLOW_ADNS3080_PINS_BACK_RIGHT ROTATION_YAW_45
#define AP_OPTICALFLOW_ADNS3080_PINS_BACK ROTATION_NONE
#define AP_OPTICALFLOW_ADNS3080_PINS_BACK_LEFT ROTATION_YAW_315
#define AP_OPTICALFLOW_ADNS3080_PINS_LEFT ROTATION_YAW_270
#define AP_OPTICALFLOW_ADNS3080_PINS_FORWARD_LEFT ROTATION_YAW_225

// field of view of ADNS3080 sensor lenses
#define AP_OPTICALFLOW_ADNS3080_08_FOV 0.202458  // 11.6 degrees

// scaler - value returned when sensor is moved equivalent of 1 pixel
#define AP_OPTICALFLOW_ADNS3080_SCALER  1.1

// ADNS3080 hardware config
#define ADNS3080_PIXELS_X                 30
#define ADNS3080_PIXELS_Y                 30
#define ADNS3080_CLOCK_SPEED                      24000000

// Register Map for the ADNS3080 Optical OpticalFlow Sensor
#define ADNS3080_PRODUCT_ID            0x00
#define ADNS3080_REVISION_ID           0x01
#define ADNS3080_MOTION                0x02
#define ADNS3080_DELTA_X               0x03
#define ADNS3080_DELTA_Y               0x04
#define ADNS3080_SQUAL                 0x05
#define ADNS3080_PIXEL_SUM             0x06
#define ADNS3080_MAXIMUM_PIXEL         0x07
#define ADNS3080_CONFIGURATION_BITS    0x0a
#define ADNS3080_EXTENDED_CONFIG       0x0b
#define ADNS3080_DATA_OUT_LOWER        0x0c
#define ADNS3080_DATA_OUT_UPPER        0x0d
#define ADNS3080_SHUTTER_LOWER         0x0e
#define ADNS3080_SHUTTER_UPPER         0x0f
#define ADNS3080_FRAME_PERIOD_LOWER    0x10
#define ADNS3080_FRAME_PERIOD_UPPER    0x11
#define ADNS3080_MOTION_CLEAR          0x12
#define ADNS3080_FRAME_CAPTURE         0x13
#define ADNS3080_SROM_ENABLE           0x14
#define ADNS3080_FRAME_PERIOD_MAX_BOUND_LOWER      0x19
#define ADNS3080_FRAME_PERIOD_MAX_BOUND_UPPER      0x1a
#define ADNS3080_FRAME_PERIOD_MIN_BOUND_LOWER      0x1b
#define ADNS3080_FRAME_PERIOD_MIN_BOUND_UPPER      0x1c
#define ADNS3080_SHUTTER_MAX_BOUND_LOWER           0x1e
#define ADNS3080_SHUTTER_MAX_BOUND_UPPER           0x1e
#define ADNS3080_SROM_ID               0x1f
#define ADNS3080_OBSERVATION           0x3d
#define ADNS3080_INVERSE_PRODUCT_ID    0x3f
#define ADNS3080_PIXEL_BURST           0x40
#define ADNS3080_MOTION_BURST          0x50
#define ADNS3080_SROM_LOAD             0x60

// Configuration Bits
#define ADNS3080_LED_MODE_ALWAYS_ON        0x00
#define ADNS3080_LED_MODE_WHEN_REQUIRED    0x01

#define ADNS3080_RESOLUTION_400                 400
#define ADNS3080_RESOLUTION_1600                1600

// Extended Configuration bits
#define ADNS3080_SERIALNPU_OFF  0x02

#define ADNS3080_FRAME_RATE_MAX         6469
#define ADNS3080_FRAME_RATE_MIN         2000

// SPI bus definitions
#define ADNS3080_SPI_UNKNOWN         0
#define ADNS3080_SPIBUS_1            1  // standard SPI bus
#define ADNS3080_SPIBUS_3            3  // SPI3

class AP_OpticalFlow_ADNS3080 : public AP_OpticalFlow
{
public:

    // constructor
    AP_OpticalFlow_ADNS3080(uint8_t reset_pin = 0);

    // initialise the sensor
    bool    init();

    uint8_t read_register(uint8_t address);
    void    write_register(uint8_t address, uint8_t value);

    // reset sensor by holding a pin high (or is it low?) for 10us.
    void    reset();

    // read latest values from sensor and fill in x,y and totals,
    // returns true on successful read
    void    update(uint32_t now);

    // ADNS3080 specific features

    // return true if there has been motion since the last time this was called
    bool motion() { 
        if( _motion ) {
            _motion = false;
            return true;
        } else {
            return false;
        }
    }                                                                       

    // true if there has been an overflow
    bool overflow() { return _overflow; }

    void disable_serial_pullup();

    // returns true if LED is always on, false if only on when required
    bool get_led_always_on();
    // set parameter to true if you want LED always on, otherwise false
    // for only when required
    void set_led_always_on( bool alwaysOn );

    // returns resolution (either 400 or 1600 counts per inch)
    int16_t get_resolution();
    // set parameter to 400 or 1600 counts per inch
    void set_resolution(uint16_t resolution);

    // get_frame_rate_auto - return true if frame rate is set to "auto",
    // false if manual
    bool get_frame_rate_auto();
    // set_frame_rate_auto(bool) - set frame rate to auto (true),
    // or manual (false)
    void set_frame_rate_auto(bool auto_frame_rate); 

    // get_frame_period
    uint16_t get_frame_period();
    void     set_frame_period(uint16_t period);

    uint16_t get_frame_rate();
    void     set_frame_rate(uint16_t rate);

    // get_shutter_speed_auto - returns true if shutter speed is adjusted
    // automatically, false if manual
    bool     get_shutter_speed_auto();
    // set_shutter_speed_auto - set shutter speed to auto (true),
    // or manual (false)
    void     set_shutter_speed_auto(bool auto_shutter_speed);

    uint16_t get_shutter_speed();
    void     set_shutter_speed(uint16_t shutter_speed);

    // will cause the x,y, dx, dy, and the sensor's motion registers to
    // be cleared
    void     clear_motion();

    // dumps a 30x30 image to the Serial port
    void     print_pixel_data();

private:
    // pin used for chip reset
    uint8_t _reset_pin;
    // true if there has been motion
    bool    _motion;
    // true if the x or y data buffers overflowed
    bool    _overflow;

    // SPI device
    AP_HAL::SPIDeviceDriver *_spi;
};

#endif