TMF882x driver linux source v3.56

Author: ptr814

Doxyfile

@@ -0,0 +1,5 @@
+EXTRA_CFLAGS := -I$(src)/include
+ccflags-y += -Wno-declaration-after-statement
+ccflags-$(CONFIG_TMF882X_QCOM_AP) += -DCONFIG_TMF882X_QCOM_AP
+obj-$(CONFIG_SENSORS_TMF882X) += tmf882x.o
+tmf882x-y += tmf882x_driver.o tmf882x_clock_correction.o tmf882x_mode.o tmf882x_mode_app.o tmf882x_mode_bl.o tmf882x_interface.o intel_hex_interpreter.o

Kbuild

@@ -0,0 +1,19 @@
+config SENSORS_TMF882X
+	tristate "AMS-TAOS TMF882X TOF"
+    	depends on I2C
+	default n
+ 	help
+	  If you say yes here you get support for the ams-taos tmf882x,
+	  ToF distance sensors.
+​
+	  This driver can also be built as a module.  If so, the module
+	  will be called tmf882x.
+
+config TMF882X_QCOM_AP
+	bool "AMS-TAOS TMF882X TOF QUALCOMM KERNEL"
+    	depends on SENSORS_TMF882X
+	default n
+ 	help
+	  If you say yes here you get support for the ams-taos tmf882x,
+	  ToF distance sensors with Qualcomm linux kernel additions.
+

Kconfig

@@ -0,0 +1,18 @@
+ifneq ($(KERNELRELEASE),)
+#kbuild part of Makefile
+include Kbuild
+else
+#normal Makefile
+all:
+	$(MAKE) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) -C $(LINUX_SRC) M=$$PWD modules
+
+modules:
+	$(MAKE) ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE) -C $(LINUX_SRC) M=$$PWD $@
+
+sign:
+	$(SIGN_SCRIPT) sha512 $(LINUX_SRC)/signing_key.priv $(LINUX_SRC)/signing_key.x509 $(DEVICE_NAME).ko
+
+clean:
+	$(MAKE) -C $(LINUX_SRC) M=$$PWD clean
+
+endif

Makefile

@@ -1,2 +1,53 @@
-# tmf8820_21_28_driver_linux
-TMF8820/TMF8821/TMF8828 Linux driver
+# Time-of-Flight (ToF) Linux Reference Driver
+
+The driver was developed on tested with the [ams OSRAM TMF882X_EVM_DB_DEMO Evaluation kit](https://ams-osram.com/products/boards-kits-accessories/kits/ams-tmf882x-evm-db-demo-evaluation-kit). This EVM includes a [Rasperry PI Zero](https://www.raspberrypi.com/products/raspberry-pi-zero-w/) where the Linux driver is operating.
+
+1. Description
+
+    Contains the release files for adding tmf882x support to the linux kernel
+
+    /arch/arm/boot/dts
+        Contains the device tree overlay for the TMF882X proto-
+        typed on the Raspberry Pi zero. The rpi.env script is a convenience
+        script for setting up build environment variables to point to a remote
+        linux kernel source tree. This prototyped version uses GPIO_20 for INT
+        and GPIO_16 for the "Chip-Enable" line
+
+        -tof8820-overlay.dts
+            -normal configuration, CE gpio and INT gpio
+            -change the "poll_period" attribute to use polling instead of interrupts
+
+
+2. Compiling
+
+    Driver - Compiling
+
+    1. Download Linux Kernel source:
+
+    2. Compile Linux Kernel
+
+    3. Compile ToF Device Tree
+
+    4. Compile ToF driver:
+       ```
+       make CONFIG_SENSORS_TMF882X=m
+       ```
+
+    6. Compile ToF driver for Qualcomm linux kernel:
+       ```
+       make CONFIG_SENSORS_TMF882X=m CONFIG_TMF882X_QCOM_AP=y
+       ```
+
+3. Documentation
+
+    TMF882X Driver UAPI Guide can be generated with the 'pandoc' and 'LaTeX' packages by running:
+    ```
+    pandoc doc\TMF882X_Driver_UAPI_Guide.md -o TMF882X_Driver_UAPI_Guide.pdf
+    ```
+
+    TMF882X Driver doxygen documentation can be generated by running
+    ('DOT' package is required for call-graphs):
+    ```
+    doxygen
+    ```
+