prepare for publish

Author: sdr-x

cmake/Modules/FindOPENCL.cmake

@@ -1,3 +1,6 @@
+# For OpenCL LTE Scanner (https://github.com/JiaoXianjun/LTE-Cell-Scanner)
+# Jiao Xianjun ([email protected])
+
 # - Find OpenCL
 # Find the native OpenCL includes and library
 # This module defines
@@ -26,6 +29,7 @@ IF (OPENCL_LIBRARY AND OPENCL_INCLUDE_DIR)
   SET(OPENCL_FOUND "YES")
 ELSE (OPENCL_LIBRARY AND OPENCL_INCLUDE_DIR)
   SET(OPENCL_FOUND "NO")
+  MESSAGE(STATUS "OPENCL not found.")
 ENDIF (OPENCL_LIBRARY AND OPENCL_INCLUDE_DIR)
 
 IF (OPENCL_FOUND)

include/filter_coef.h

@@ -1,6 +1,27 @@
+// An OpenCL accelerated LTE Cell Scanner
+//
+// Written by Jiao Xianjun <[email protected]>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program 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 Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+// Header file to store coefficients of FIR 6RB channel filter
+
 #ifndef HAVE_FILTER_COEF_H
 #define HAVE_FILTER_COEF_H
 
+// filter coefficients
+// This is for non-OpenCL version. You should change coefficients in OpenCL kernel files for OpenCL version
 const float chn_6RB_filter_coef[47] = { \
 8.193313185354206e-04,     3.535548569572820e-04,    -1.453429245341695e-03,     1.042805860697287e-03,     1.264224526451337e-03, \
   -3.219586065044259e-03,     1.423981657254563e-03,     3.859884310477692e-03,    -6.552708013395765e-03,     8.590509694961493e-04, \

src/filter_mchn_kernels.cl

@@ -1,3 +1,23 @@
+// An OpenCL accelerated LTE Cell Scanner
+//
+// Written by Jiao Xianjun <[email protected]>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program 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 Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+// kernels for multi channels PSS correlation
+// !!!This file should be put into $PATH directory or any other location where program can discover in runtime!!!
+
 __kernel void skip2cols( __global float2* in,
                          __global float2* out,
                          uint len_in)

src/filter_my_kernels.cl

@@ -1,3 +1,24 @@
+// An OpenCL accelerated LTE Cell Scanner
+//
+// Written by Jiao Xianjun <[email protected]>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program 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 Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+// kernels for FIR 6RB channel filter.
+// !!!This file should be put into $PATH directory or any other location where program can discover in runtime!!!
+
+// filter coefficients
 constant float chn_6RB_filter_coef[47] = { \
 8.193313185354206e-04,     3.535548569572820e-04,    -1.453429245341695e-03,     1.042805860697287e-03,     1.264224526451337e-03, \
   -3.219586065044259e-03,     1.423981657254563e-03,     3.859884310477692e-03,    -6.552708013395765e-03,     8.590509694961493e-04, \

tmp.txt

@@ -40,7 +40,16 @@ twist mode i7-3930K CPU @ 3.20GHz
 0.008s
 
 non-twist mode NO OPENCL: 6RB filter cost 0.0809879s PSS xcorr cost 7.08098s
+twist mode NO OPENCL: 6RB filter cost 0.0809879s PSS xcorr cost 26s
 
+-----------------i5 CPU       M 520  @ 2.40GHz + POCL--------------------
+6RB filter 0.008
+xcorr-workitem=2
+2.4s
+xcorr-workitem=4
+2.38s
+xcorr-workitem=8
+2.41s
 
 ./CellSearch --loadbin ~/git/rtl-sdr-LTE/scan-capture/frequency-1850-1880MHz/f1860_s1.92_g0_1s_strong.bin --num-reserve=4
 should be like: