qmk-keychron-q3-colemak-dh/drivers/sensors/pmw3389.h

// Copyright 2022 Stefan Kerkmann (KarlK90)
// Copyright 2021 Alabastard (@Alabastard-64)
// Copyright 2020 Christopher Courtney, aka Drashna Jael're  (@drashna) <drashna@live.com>
// Copyright 2019 Sunjun Kim
// Copyright 2020 Ploopy Corporation
// SPDX-License-Identifier: GPL-2.0-or-later

#pragma once

#include <stdint.h>

#if !defined(PMW33XX_CPI)
#    define PMW33XX_CPI 2000
#endif

#define PMW33XX_CPI_STEP 50
#define PMW33XX_CPI_MIN 50
#define PMW33XX_CPI_MAX 16000

#define PMW33XX_FIRMWARE_LENGTH 4094

// PMW3389 register addresses
// clang-format off
#define REG_Product_ID                 0x00
#define REG_Revision_ID                0x01
#define REG_Motion                     0x02
#define REG_Delta_X_L                  0x03
#define REG_Delta_X_H                  0x04
#define REG_Delta_Y_L                  0x05
#define REG_Delta_Y_H                  0x06
#define REG_SQUAL                      0x07
#define REG_RawData_Sum                0x08
#define REG_Maximum_RawData            0x09
#define REG_Minimum_RawData            0x0a
#define REG_Shutter_Lower              0x0b
#define REG_Shutter_Upper              0x0c
#define REG_Ripple_Control             0x0d
#define REG_Resolution_L               0x0e
#define REG_Resolution_H               0x0f
#define REG_Config2                    0x10
#define REG_Angle_Tune                 0x11
#define REG_Frame_Capture              0x12
#define REG_SROM_Enable                0x13
#define REG_Run_Downshift              0x14
#define REG_Rest1_Rate_Lower           0x15
#define REG_Rest1_Rate_Upper           0x16
#define REG_Rest1_Downshift            0x17
#define REG_Rest2_Rate_Lower           0x18
#define REG_Rest2_Rate_Upper           0x19
#define REG_Rest2_Downshift            0x1a
#define REG_Rest3_Rate_Lower           0x1b
#define REG_Rest3_Rate_Upper           0x1c
#define REG_Observation                0x24
#define REG_Data_Out_Lower             0x25
#define REG_Data_Out_Upper             0x26
#define REG_SROM_ID                    0x2a
#define REG_Min_SQ_Run                 0x2b
#define REG_RawData_Threshold          0x2c
#define REG_Control2                   0x2d
#define REG_Config5_L                  0x2e
#define REG_Config5_H                  0x2f
#define REG_Power_Up_Reset             0X3a
#define REG_Shutdown                   0x3b
#define REG_Inverse_Product_ID         0x3f
#define REG_LiftCutoff_Cal3            0x41
#define REG_Angle_Snap                 0x42
#define REG_LiftCutoff_Cal1            0x4a
#define REG_Motion_Burst               0x50
#define REG_SROM_Load_Burst            0x62
#define REG_Lift_Config                0x63
#define REG_RawData_Burst              0x64
#define REG_LiftCutoff_Cal2            0x65
#define REG_LiftCutoff_Cal_Timeout     0x71
#define REG_LiftCutoff_Cal_Min_Length  0x72
#define REG_PWM_Period_Cnt             0x73
#define REG_PWM_Width_Cnt              0x74
// clang-format on
[Core] PMW33XX drivers overhaul (#17613) * PMW33XX drivers overhaul This combines the PMW3389 and PM3360 drivers as they only differ in the firmware blobs and CPI get and set functions. The following changes have been made: * PMW3389 now gets the same multi-sensor feature that is already available on the PMW3360. * Introduced a shared pmw33xx_report_t struct is now directly readable via SPI transactions instead of individual byte-sized reads, saving multiple copies and bitshift operations. * pmw33(89/60)_get_report functions had unreachable branches in their motion detection logic these have been simplied as much as possible. * The fast firmware upload option has been removed as this becomes obsolete by the newly introduced polled waiting functions for ChibiOS polled waiting * PMW33(60/89)_SPI_LSBFIRST and PMW33(60/89)_SPI_MODE config options have been removed as they don't need to be configurable. * All PMW3389 and PMW3360 defines have been unified to a PMW33XX prefix to reduce code duplication and make the defines interchangeable * Adjust keyboards to PMW33XX naming scheme 2022-07-14 11:50:00 +02:00			`// Copyright 2022 Stefan Kerkmann (KarlK90)`
			`// Copyright 2021 Alabastard (@Alabastard-64)`
			`// Copyright 2020 Christopher Courtney, aka Drashna Jael're (@drashna) <drashna@live.com>`
			`// Copyright 2019 Sunjun Kim`
			`// Copyright 2020 Ploopy Corporation`
			`// SPDX-License-Identifier: GPL-2.0-or-later`
Add PMW3389 optical sensor Support (Updated) (#15740) Co-authored-by: Drashna Jaelre <drashna@live.com> 2022-01-11 23:33:13 +01:00
			`#pragma once`

			`#include <stdint.h>`

[Core] PMW33XX drivers overhaul (#17613) * PMW33XX drivers overhaul This combines the PMW3389 and PM3360 drivers as they only differ in the firmware blobs and CPI get and set functions. The following changes have been made: * PMW3389 now gets the same multi-sensor feature that is already available on the PMW3360. * Introduced a shared pmw33xx_report_t struct is now directly readable via SPI transactions instead of individual byte-sized reads, saving multiple copies and bitshift operations. * pmw33(89/60)_get_report functions had unreachable branches in their motion detection logic these have been simplied as much as possible. * The fast firmware upload option has been removed as this becomes obsolete by the newly introduced polled waiting functions for ChibiOS polled waiting * PMW33(60/89)_SPI_LSBFIRST and PMW33(60/89)_SPI_MODE config options have been removed as they don't need to be configurable. * All PMW3389 and PMW3360 defines have been unified to a PMW33XX prefix to reduce code duplication and make the defines interchangeable * Adjust keyboards to PMW33XX naming scheme 2022-07-14 11:50:00 +02:00			`#if !defined(PMW33XX_CPI)`
			`# define PMW33XX_CPI 2000`
Add PMW3389 optical sensor Support (Updated) (#15740) Co-authored-by: Drashna Jaelre <drashna@live.com> 2022-01-11 23:33:13 +01:00			`#endif`

[Core] PMW33XX drivers overhaul (#17613) * PMW33XX drivers overhaul This combines the PMW3389 and PM3360 drivers as they only differ in the firmware blobs and CPI get and set functions. The following changes have been made: * PMW3389 now gets the same multi-sensor feature that is already available on the PMW3360. * Introduced a shared pmw33xx_report_t struct is now directly readable via SPI transactions instead of individual byte-sized reads, saving multiple copies and bitshift operations. * pmw33(89/60)_get_report functions had unreachable branches in their motion detection logic these have been simplied as much as possible. * The fast firmware upload option has been removed as this becomes obsolete by the newly introduced polled waiting functions for ChibiOS polled waiting * PMW33(60/89)_SPI_LSBFIRST and PMW33(60/89)_SPI_MODE config options have been removed as they don't need to be configurable. * All PMW3389 and PMW3360 defines have been unified to a PMW33XX prefix to reduce code duplication and make the defines interchangeable * Adjust keyboards to PMW33XX naming scheme 2022-07-14 11:50:00 +02:00			`#define PMW33XX_CPI_STEP 50`
			`#define PMW33XX_CPI_MIN 50`
			`#define PMW33XX_CPI_MAX 16000`
Add PMW3389 optical sensor Support (Updated) (#15740) Co-authored-by: Drashna Jaelre <drashna@live.com> 2022-01-11 23:33:13 +01:00
[Core] PMW33XX drivers overhaul (#17613) * PMW33XX drivers overhaul This combines the PMW3389 and PM3360 drivers as they only differ in the firmware blobs and CPI get and set functions. The following changes have been made: * PMW3389 now gets the same multi-sensor feature that is already available on the PMW3360. * Introduced a shared pmw33xx_report_t struct is now directly readable via SPI transactions instead of individual byte-sized reads, saving multiple copies and bitshift operations. * pmw33(89/60)_get_report functions had unreachable branches in their motion detection logic these have been simplied as much as possible. * The fast firmware upload option has been removed as this becomes obsolete by the newly introduced polled waiting functions for ChibiOS polled waiting * PMW33(60/89)_SPI_LSBFIRST and PMW33(60/89)_SPI_MODE config options have been removed as they don't need to be configurable. * All PMW3389 and PMW3360 defines have been unified to a PMW33XX prefix to reduce code duplication and make the defines interchangeable * Adjust keyboards to PMW33XX naming scheme 2022-07-14 11:50:00 +02:00			`#define PMW33XX_FIRMWARE_LENGTH 4094`
Add PMW3389 optical sensor Support (Updated) (#15740) Co-authored-by: Drashna Jaelre <drashna@live.com> 2022-01-11 23:33:13 +01:00
[Core] PMW33XX drivers overhaul (#17613) * PMW33XX drivers overhaul This combines the PMW3389 and PM3360 drivers as they only differ in the firmware blobs and CPI get and set functions. The following changes have been made: * PMW3389 now gets the same multi-sensor feature that is already available on the PMW3360. * Introduced a shared pmw33xx_report_t struct is now directly readable via SPI transactions instead of individual byte-sized reads, saving multiple copies and bitshift operations. * pmw33(89/60)_get_report functions had unreachable branches in their motion detection logic these have been simplied as much as possible. * The fast firmware upload option has been removed as this becomes obsolete by the newly introduced polled waiting functions for ChibiOS polled waiting * PMW33(60/89)_SPI_LSBFIRST and PMW33(60/89)_SPI_MODE config options have been removed as they don't need to be configurable. * All PMW3389 and PMW3360 defines have been unified to a PMW33XX prefix to reduce code duplication and make the defines interchangeable * Adjust keyboards to PMW33XX naming scheme 2022-07-14 11:50:00 +02:00			`// PMW3389 register addresses`
			`// clang-format off`
			`#define REG_Product_ID 0x00`
			`#define REG_Revision_ID 0x01`
			`#define REG_Motion 0x02`
			`#define REG_Delta_X_L 0x03`
			`#define REG_Delta_X_H 0x04`
			`#define REG_Delta_Y_L 0x05`
			`#define REG_Delta_Y_H 0x06`
			`#define REG_SQUAL 0x07`
			`#define REG_RawData_Sum 0x08`
			`#define REG_Maximum_RawData 0x09`
			`#define REG_Minimum_RawData 0x0a`
			`#define REG_Shutter_Lower 0x0b`
			`#define REG_Shutter_Upper 0x0c`
			`#define REG_Ripple_Control 0x0d`
			`#define REG_Resolution_L 0x0e`
			`#define REG_Resolution_H 0x0f`
			`#define REG_Config2 0x10`
			`#define REG_Angle_Tune 0x11`
			`#define REG_Frame_Capture 0x12`
			`#define REG_SROM_Enable 0x13`
			`#define REG_Run_Downshift 0x14`
			`#define REG_Rest1_Rate_Lower 0x15`
			`#define REG_Rest1_Rate_Upper 0x16`
			`#define REG_Rest1_Downshift 0x17`
			`#define REG_Rest2_Rate_Lower 0x18`
			`#define REG_Rest2_Rate_Upper 0x19`
			`#define REG_Rest2_Downshift 0x1a`
			`#define REG_Rest3_Rate_Lower 0x1b`
			`#define REG_Rest3_Rate_Upper 0x1c`
			`#define REG_Observation 0x24`
			`#define REG_Data_Out_Lower 0x25`
			`#define REG_Data_Out_Upper 0x26`
			`#define REG_SROM_ID 0x2a`
			`#define REG_Min_SQ_Run 0x2b`
			`#define REG_RawData_Threshold 0x2c`
			`#define REG_Control2 0x2d`
			`#define REG_Config5_L 0x2e`
			`#define REG_Config5_H 0x2f`
			`#define REG_Power_Up_Reset 0X3a`
			`#define REG_Shutdown 0x3b`
			`#define REG_Inverse_Product_ID 0x3f`
			`#define REG_LiftCutoff_Cal3 0x41`
			`#define REG_Angle_Snap 0x42`
			`#define REG_LiftCutoff_Cal1 0x4a`
			`#define REG_Motion_Burst 0x50`
			`#define REG_SROM_Load_Burst 0x62`
			`#define REG_Lift_Config 0x63`
			`#define REG_RawData_Burst 0x64`
			`#define REG_LiftCutoff_Cal2 0x65`
			`#define REG_LiftCutoff_Cal_Timeout 0x71`
			`#define REG_LiftCutoff_Cal_Min_Length 0x72`
			`#define REG_PWM_Period_Cnt 0x73`
			`#define REG_PWM_Width_Cnt 0x74`
			`// clang-format on`