====================================================================

Copyright (c) 2017-2022 ADVANCED MICRO DEVICES, INC. All Rights Reserved.
====================================================================
AMD Sensor Fusion Hub
---------------------
AMD Sensor Fusion Hub (will be referred as SFH device) is a PCI Express Endpoint
and Sensor UMDF driver.
++++++++++++++++++++++++++
Important notes
++++++++++++++++++++++++++
1) The driver (version 216) is not compatible with firmware’s prior to 1.0.23
firmware. Please UPDATE firmware/BIOS before using AMD SFH drivers 216 and above
driver.
2) New dynamic discovery functionality has been added to the AMD SFH driver version
216 and above, so this functionality is not compatible/available with the older AMD
SFH driver. If the different combination of driver’s version is used (example older
KMDF driver and new UMDF driver and) or Rollbacking the KMDF or UMDF drivers may
cause system BSOD. So please use the same version of the UMDF and KMDF drivers or
there is need for the Rollback, please uninstall the both the drivers, and install
the required drivers.

Revision History
----------------
1.0.0.329 14/June/2022
Change Log -> Added below list of features
* Added support for 360 bytes recorder data in driver and application.
* Added support to dump raw data for color sensor.
* Added Inbag actual for accel.

1.0.0.328 08/April/2022
Change Log -> Added below list of features
* Added support to log color sensor data to a file.
* Added support to retrieve GPIO status, Fw version from Application.
* Added support of User presence state to default custom sensor.
* Added support to configure distance, motion and Airplane mode from
application.

1.0.0.327 24/Feb/2022
Change Log -> Added below list of features
* Display On/Off notification to firmware.
* Airplane mode.

1.0.0.326 24/JAN/2022
Change Log -> Added below list of features
* Fixed MMX WHQL issues
* Modified KMDF-UMDF data interface for proximity sensor and related custom
sensors
* Fixed KMDF driver BSOD issue during calibration using ALS Application

1.0.0.325 04/JAN/2022
Change Log -> Added below list of features
* Re-implemented FW command queuing mechanisam
* Included proximity sensor FW commands under command queuing mechanisam
* Fixed distance threshold and motion threshold values not updating
properly if both are modified at same time issue
* Updated default motion threshold value to 100

1.0.0.324 17/DEC/2021
Change Log -> Added below list of features
 * Added color sensor support.
* Separated stability classifier detection from Inbag detection.
* Added VL53L5 sensor support.
* Disabled proximity sensor stop to keep sensor active during s0i3.
* Fixed proximity sensor threshold values not updating properly in KMDF
driver issue.
* Update threshold values immediately instead of updating during first get
call.
* Removed default proximity sensor support for Lenovo.

1.0.0.323 12/NOV/2021
Change Log -> Added below list of features
* Removed support of HPD mode change based on Display ON/OFF.

1.0.0.322 29/OCT/2021
Change Log -> Added below list of features
* Added support to enable Distance Threshold for MMX sensor.
* Added Camera Custom Sensor for facial subtype.
* Support for Display rotation lock at book mode on Dell Antman.
* Added FW version parameter to MFG offset structure.
* Approach custom sensor for Recorder.
* Ported MFG test with offset support App to Cpp.
* HPD Mode change based on Display ON/OFF.
* Enabled wait and lock for facial sensor subtype.
* Added support for Device state logging from SFH UI App.
* Set the internal state for the HPD sensor and enable the recorder before
start.
* New App interface IOCTL updated to support MFG test.

1.0.0.321 13/SEPT/2021
Change Log -> Added below list of features
* Removed hardcoding of SensorIndex in C2P command structure.
* Set the recorder start/stop before reading the data.
* Return the proper SensorState for default custom sensor.
* Added ALS Get calibration support in Driver for Application.
* HPD MFG App Offset read driver support.
* Added driver support for new MFG test features.
* Added code in SFH App to return Error code from HPD MFG test.
* Fixed Novelda recorder stop command issue.
* Fix for Recorder sample data to application.

1.0.0.320 04/AUG/2021
Change Log -> Added below list of features
* Fix HLK Issue related to Proximity and HSP for UMDF and KMDF.
* Custom sensor for HPD Recorder enable and disable feature.
* Recorder support added to SFH Application.
* Support to send recorder data size to Application from UMDF driver.
* Added HUMAN_PRESENCE_DETECTION_TYPE enumeration properties for Proximity.

1.0.0.319 08/JUL/2021
Change Log -> Added below list of features
* Set and Get of Motion Threshold, Distance threshold and HPD Mode.
* IOCTL for "Manufacturing test" commands received from application.
* HPD "manufactoring test" added to SFH Application (amdSfhApp).
* Manufacturing test supports start, stop and setmode commands from the
application

1.0.0.318 09/JUN/2021
Change Log -> Added below list of features
 * Support for camera based custom sensor
* Support to change mode setting for Human presence detection
* Set HOD config data for VL53L5

1.0.0.317 21/MAY/2021
Change Log -> OEM specific autorotation feature enablement.

1.0.0.316 16/APR/2021
Change Log -> Added support for OEM specific ALR curve settings
Change Log -> Bug Fix:Disabling the device pooling
Change Log -> Update RMB FW version and Live Counter
Change Log -> Bug Fix: Not reporting Book Mode on portrait +/- 90 degree

1.0.0.315 09/FEB/2021
Change Log -> Auto Screen Rotation Issue
Change Log -> Rollback the timeout value

1.0.0.314 15/JAN/2021
Change Log -> Updated the copyrights date and revision history
Change Log -> Check Light Level using Target Lux instead of sensor output
Change Log -> Increase timeout value and disable the process sharing
Change Log -> Dump ALS Gain in WPP trace
Change Log -> Update ALS Lux range from 100 to 2000 Lux

1.0.0.313 11/NOV/2020
Change Log -> Read HOD Output from C2P Reg 5
Change Log -> Add support for Stability Classifier
Change Log -> Added ALS sensor support to amdsfhUI App
Change Log -> Added ALS Calibration support to amdSfhApp

1.0.0.310 28/SEP/2020
Change Log -> Updated ALS Calibration and AmdSfhUI App.

1.0.0.308 29/JUN/2020
Change Log -> Fix Division by Zero in Fusion Sensor TimerExpire.

1.0.0.305 05/MAY/2020
Change Log -> Clear P2C Reg Status bit before clearing P2C Reg0.

1.0.0.303 20/MAR/2020
Change Log -> WA for forced shutdown in Tablet Mode.

1.0.0.297 23/DEC/2019
Change Log -> Restore DCD on D0Entry.