From 1a90ed76f3983f582403e5bb468a071f9ccb8e21 Mon Sep 17 00:00:00 2001 From: Michal Fratczak Date: Fri, 2 Nov 2018 16:06:08 +0100 Subject: [PATCH] Init --- BuildInstructions.md | 117 ++ COPYING | 674 ++++++++++ README.md | 175 +++ code/CMake/FFTW3fConfig.cmake | 17 + code/CMake/FFTW3fConfigVersion.cmake | 12 + code/CMakeLists.txt | 25 + code/Decoder/AFC.h | 385 ++++++ code/Decoder/Average.h | 80 ++ code/Decoder/CMakeLists.txt | 55 + code/Decoder/CRC.cpp | 49 + code/Decoder/CRC.h | 10 + code/Decoder/Decimator.h | 149 +++ code/Decoder/Decoder.h | 803 ++++++++++++ code/Decoder/FFT.cpp | 111 ++ code/Decoder/FFT.h | 61 + code/Decoder/FSK2_Demod.h | 46 + code/Decoder/FirFilter.h | 212 ++++ code/Decoder/IQVector.h | 76 ++ code/Decoder/RTTY.h | 141 +++ code/Decoder/SpectrumInfo.h | 89 ++ code/Decoder/SymbolExtractor.h | 261 ++++ code/Decoder/filtercoef.h | 1449 ++++++++++++++++++++++ code/Decoder/func_timer.h | 142 +++ code/Decoder/habdec_windows.h | 53 + code/Decoder/print_habhub_sentence.cpp | 65 + code/Decoder/print_habhub_sentence.h | 33 + code/Decoder/sentence_extract.cpp | 70 ++ code/Decoder/sentence_extract.h | 34 + code/IQSource/CMakeLists.txt | 29 + code/IQSource/IQSource.h | 46 + code/IQSource/IQSource_File.h | 262 ++++ code/IQSource/IQSource_SoapySDR.cpp | 415 +++++++ code/IQSource/IQSource_SoapySDR.h | 77 ++ code/common/console_colors.cpp | 28 + code/common/console_colors.h | 12 + code/fltkGUI/CMakeLists.txt | 17 + code/fltkGUI/gui_utils.h | 234 ++++ code/fltkGUI/main.cpp | 426 +++++++ code/habLogger/habLogger.py | 149 +++ code/webClient/css/habdec.css | 74 ++ code/webClient/index.html | 94 ++ code/webClient/js/NetTransport.js | 80 ++ code/webClient/js/drawing.js | 194 +++ code/webClient/js/gui.js | 155 +++ code/webClient/js/habdec_commands.js | 285 +++++ code/websocketServer/CMakeLists.txt | 65 + code/websocketServer/CompressedVector.h | 311 +++++ code/websocketServer/GLOBALS.h | 117 ++ code/websocketServer/NetTransport.h | 102 ++ code/websocketServer/main.cpp | 338 +++++ code/websocketServer/program_options.cpp | 193 +++ code/websocketServer/program_options.h | 22 + code/websocketServer/server.cpp | 471 +++++++ code/websocketServer/server.h | 26 + webClientScreenshot.png | Bin 0 -> 249086 bytes 55 files changed, 9616 insertions(+) create mode 100644 BuildInstructions.md create mode 100644 COPYING create mode 100644 README.md create mode 100755 code/CMake/FFTW3fConfig.cmake create mode 100644 code/CMake/FFTW3fConfigVersion.cmake create mode 100644 code/CMakeLists.txt create mode 100644 code/Decoder/AFC.h create mode 100755 code/Decoder/Average.h create mode 100755 code/Decoder/CMakeLists.txt create mode 100644 code/Decoder/CRC.cpp create mode 100644 code/Decoder/CRC.h create mode 100644 code/Decoder/Decimator.h create mode 100644 code/Decoder/Decoder.h create mode 100644 code/Decoder/FFT.cpp create mode 100644 code/Decoder/FFT.h create mode 100644 code/Decoder/FSK2_Demod.h create mode 100644 code/Decoder/FirFilter.h create mode 100644 code/Decoder/IQVector.h create mode 100644 code/Decoder/RTTY.h create mode 100644 code/Decoder/SpectrumInfo.h create mode 100644 code/Decoder/SymbolExtractor.h create mode 100644 code/Decoder/filtercoef.h create mode 100644 code/Decoder/func_timer.h create mode 100644 code/Decoder/habdec_windows.h create mode 100644 code/Decoder/print_habhub_sentence.cpp create mode 100644 code/Decoder/print_habhub_sentence.h create mode 100644 code/Decoder/sentence_extract.cpp create mode 100644 code/Decoder/sentence_extract.h create mode 100644 code/IQSource/CMakeLists.txt create mode 100644 code/IQSource/IQSource.h create mode 100644 code/IQSource/IQSource_File.h create mode 100755 code/IQSource/IQSource_SoapySDR.cpp create mode 100644 code/IQSource/IQSource_SoapySDR.h create mode 100644 code/common/console_colors.cpp create mode 100644 code/common/console_colors.h create mode 100644 code/fltkGUI/CMakeLists.txt create mode 100644 code/fltkGUI/gui_utils.h create mode 100644 code/fltkGUI/main.cpp create mode 100755 code/habLogger/habLogger.py create mode 100644 code/webClient/css/habdec.css create mode 100755 code/webClient/index.html create mode 100644 code/webClient/js/NetTransport.js create mode 100644 code/webClient/js/drawing.js create mode 100644 code/webClient/js/gui.js create mode 100644 code/webClient/js/habdec_commands.js create mode 100755 code/websocketServer/CMakeLists.txt create mode 100644 code/websocketServer/CompressedVector.h create mode 100644 code/websocketServer/GLOBALS.h create mode 100644 code/websocketServer/NetTransport.h create mode 100755 code/websocketServer/main.cpp create mode 100644 code/websocketServer/program_options.cpp create mode 100644 code/websocketServer/program_options.h create mode 100755 code/websocketServer/server.cpp create mode 100644 code/websocketServer/server.h create mode 100644 webClientScreenshot.png diff --git a/BuildInstructions.md b/BuildInstructions.md new file mode 100644 index 0000000..951ca86 --- /dev/null +++ b/BuildInstructions.md @@ -0,0 +1,117 @@ +# Building HABDEC from source + +To build habdec from source code, you need to build it's dependecies first: +- FFTW +- boost 1.68 +- CMake version 3.8.2 +- optionally: FLTK + +Below are instructions how to obtain and compile each package. Keep in mind, these are WIP and some adjustment to your build env may be needed. + +For windows, you need to start 64bit build env, ie: `C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat` + +## CMake + +#### Windows +Just download and install binaries from https://cmake.org/download/ + +#### Linux + wget https://cmake.org/files/v3.12/cmake-3.12.3.tar.gz + tar -xf ./cmake-3.12.3.tar.gz + cd cmake-3.12.3 + ./configure --prefix=`pwd`/install + make -j4 + sudo make install + export PATH=$PATH:`pwd`/install + + +## boost 1.68 + +#### Linux + wget https://dl.bintray.com/boostorg/release/1.68.0/source/boost_1_68_0.tar.gz + tar -xf ./boost_1_68_0.tar.gz + cd boost_1_68_0 + ./bootstrap.sh + ./b2 -j 4 --layout=tagged --build-type=complete stage + +#### Windows +Download from https://www.boost.org/users/download/ and unpack. + + cd boost + bootstrap.bat + b2.exe --layout=tagged --build-type=complete --build-dir=build/static toolset=msvc address-model=64 link=static stage + + +## FFTW +You need to build FFTW with float (single precission) support. Also, enable neon optimizations for ARM. + +#### Linux x86 + wget http://fftw.org/fftw-3.3.8.tar.gz + tar -xf ./fftw-3.3.8.tar.gz + cd fftw-3.3.8 + ./configure --with-slow-timer --enable-single CFLAGS="-O4 -pipe -march=native -Wall" --prefix=`pwd`/install + make + make install + +#### Linux ARM + wget http://fftw.org/fftw-3.3.8.tar.gz + tar -xf ./fftw-3.3.8.tar.gz + cd fftw-3.3.8 + ./configure --with-slow-timer --enable-single --enable-neon CFLAGS="-O4 -pipe -march=native -mfpu=neon -Wall" --prefix=`pwd`/install + make + make install + +#### Windows +Download http://fftw.org/fftw-3.3.8.tar.gz and unpack. + + cmake -D BUILD_SHARED_LIBS=0 -D ENABLE_FLOAT=1 -D CMAKE_INSTALL_PREFIX=d:\dev\c_libs\fftw\3.3.8\install -D CMAKE_BUILD_TYPE=RELEASE -G "NMake Makefiles" ..\src + nmake + nmake install + + +## SoapySDR + +#### Windows +Just go and install binaries from https://github.com/pothosware/PothosCore/wiki/Downloads + +#### Linux + + git clone https://github.com/pothosware/SoapySDR.git + cd SoapySDR + git pull origin master + + mkdir build + cd build + cmake .. + make -j + sudo make install + sudo ldconfig + SoapySDRUtil --info + +### SoapySDR AirSpy Support + + git clone https://github.com/pothosware/SoapyAirspy.git + mkdir build + cd build + cmake ../SoapySDR + make + sudo make install + sudo ldconfig + +### SoapySDR RTL-SDR Support +Refer to https://github.com/pothosware/SoapyRTLSDR + + +## HABDEC Build + +If you managed to build or install dependencies, you're ready do build habdec + + git clone habdec + cd habdec + mkdir build + cd build + cmake cmake -D BOOST_ROOT=/path/to/boost_1.68 -D FFTW_ROOT=/path/to/fftwf/install ../code + make + make install + +You should end up with `install` dir that contains executable and a shell script that runs in loop (for cases where habdec should crash and you wan't continous run). \ No newline at end of file diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..f288702 --- /dev/null +++ b/COPYING @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/README.md b/README.md new file mode 100644 index 0000000..c01cbe5 --- /dev/null +++ b/README.md @@ -0,0 +1,175 @@ +# HABDEC - RTTY decoder for High Altitude Balloons + +![alt text](./webClientScreenshot.png) + +Habdec is a C++11 software to decode RTTY telemetry from High Altitude Balloon and upload it to [UKHAS Habitat](http://habitat.habhub.org/) + +Some facts: +- builds and runs on Windows/Linux and x64/RaspberryPI/OdroixXU4 platforms +- Uses [SoapySDR](https://github.com/pothosware/SoapySDR) to consume IQ stream from your SDR +- runs in command line (headless) +- provides websocket server so can be cotrolled from any web browser [even on your phone](https://www.youtube.com/watch?v=dli8FEFy5tM) +- can be easily integrated into your own code + +Original motivation for habdec was to have a portable tracking device you could take to a chasecar or into a field. + +Fatty laptop with dl-fldigi, full-fledged SDR app and required internet connection is not too comfortable. + +Ultimatelly habdec is intended for integration into bigger app, probably based on OpenStreetmap and running on portable RaspberryPI or OdroidXU4. Right now you can run it on headless board and cotrol from your mobile. + +## Getting habdec + +To get habdec you can download precompiled exec or build it from source. + +#### Getting Binary: +- Install SoapySDR binaries from [here](https://github.com/pothosware/SoapySDR/wiki#installation) +- Download habdec executable for your platform from [here](missing link) + +#### Building from source: +To build habdec you need a C++11 compiler and CMake version 3.8.2 +You also need to build or install some dependencies: +- basic decoder: [FFTW](http://www.fftw.org/) +- websocket server: [SoapySDR](https://github.com/pothosware/SoapySDR), [boost 1.68](https://www.boost.org/) + +Instructions how to build habdec and it's dependencies are described in [BuildInstructions.md](./BuildInstructions.md) + +## Usage + +`habdecWebsocketServer.exe --help` +``` +Command Line Interface options: + --config arg (=./habdecWebsocketServer.opts) + Last run config file. Autosaved on + every successfull decode. + +CLI opts: + --help Display help message + --device arg (=-1) SDR Device Numer + --sampling_rate arg (=0) Sampling Rate, as supported by device + --port arg (=5555) Command Port, example: --port + 127.0.0.1:5555 + --station arg (=habdec) HABHUB station callsign + --freq arg frequency in MHz + --gain arg gain + --print arg live print received chars + --rtty arg rtty: baud bits stops, example -rtty + 300 8 2 + --biast arg biasT + --bias_t arg biasT + --afc arg Auto Frequency Correction +``` + +The only mandatory parameter is --sampling_rate. Provide value that is supported by your SDR device. + +### Examples: +Print available devices + +``` +habdecWebsocketServer.exe --device -1 + + +Reading config from file ./habdecWebsocketServer.opts +Current options: + device: -1 + sampling_rate: 2.048e+06 + command_host: 0.0.0.0 + command_port: 5,555 + station: habdec + freq: 4.3435e+08 + gain: 15 + live_print: 1 + baud: 300 + rtty_ascii_bits: 8 + rtty_ascii_stops: 2 + biast: 0 +ERROR: Unable to find host: Nieznany host. +Found Rafael Micro R820T tuner +[INFO] [UHD] Win32; Microsoft Visual C++ version 14.0; Boost_106700; UHD_3.13.0.2-1-g78745bda + +Available devices: +0: + device_id 0 + driver airspy + label AIRSPY [440464c8:39627b4f] + serial 440464c8:39627b4f + Sampling Rates: + 2.5e+06 + 1e+07 + +1: + available Yes + driver rtlsdr + label Generic RTL2832U OEM :: 00000001 + manufacturer Realtek + product RTL2838UHIDIR + rtl 0 + serial 00000001 + tuner Rafael Micro R820T +Found Rafael Micro R820T tuner + Sampling Rates: + 250,000 + 1.024e+06 + 1.536e+06 + 1.792e+06 + 1.92e+06 + 2.048e+06 + 2.16e+06 + 2.56e+06 + 2.88e+06 + 3.2e+06 + + +No SDR device specified. Select one by specifying it's NUMBER +Failed Device Setup. EXIT. + +``` + +Run with AirSpy + + habdecWebsocketServer.exe --device 0 --sampling_rate 2.5e6 + +Specify websocket address and port + + habdecWebsocketServer.exe --device 0 --sampling_rate 2.5e6 -port 12.13.14.15:5555 + +Some more options +``` +habdecWebsocketServer.exe --device 0 --sampling_rate 2.5e6 + --port 12.13.14.15:5555 --station Fred + --rtty 300 8 2 + --print 1 + --freq 434.5 --gain 20 --biast 1 --afc 1 +``` + + +### Web Client + +To control habdec parameters from your browser, start `webClient/index.html` and connect to ip:port + + +## Known Limitations + +- RTTY Modes **NOT** supported: 5bit baudot, 1.5 bit stop +- SSTV is not supported +- Decoding will stop if decimation setting is too low or too high. It was tested to work with stream around 40kHz bandwidth. +- Automatic Frequency Correction needs more work. Use consciously. +- Connecting from browser is not very reliable yet, sometimes you need to refresh and wait. +- Currently, upload to HABHUB is realized with python habLogger.py which is called with system(). This will get ported to C++. +- habdec was developed and tested with [AirSpy](https://airspy.com/) and [OdroidXU4](http://hardkernel.com/). Support for windows and RtlSdr is less tested. + + +## Reporting Problems + +Use bugtracker, please. + +## Contributions + +Gladly accepted :) + +## Authors + +* **Michał Frątczak** - *parts of code from* - [GQRX](https://github.com/csete/gqrx) + +## License + +This project is licensed under the GNU General Public License diff --git a/code/CMake/FFTW3fConfig.cmake b/code/CMake/FFTW3fConfig.cmake new file mode 100755 index 0000000..b9c397a --- /dev/null +++ b/code/CMake/FFTW3fConfig.cmake @@ -0,0 +1,17 @@ + +# defined since 2.8.3 +if (CMAKE_VERSION VERSION_LESS 2.8.3) + get_filename_component (CMAKE_CURRENT_LIST_DIR ${CMAKE_CURRENT_LIST_FILE} PATH) +endif () + +# Allows loading FFTW3 settings from another project +set (FFTW3_CONFIG_FILE "${CMAKE_CURRENT_LIST_FILE}") + +# set (FFTW3f_LIBRARIES fftw3f.a ) +FIND_LIBRARY( FFTW3f_LIBRARIES NAMES fftw3f.a fftw3f PATHS ${FFTW_ROOT}/lib NO_DEFAULT_PATH ) +set (FFTW3f_LIBRARY_DIRS ${FFTW_ROOT}/lib) +set (FFTW3f_INCLUDE_DIRS ${FFTW_ROOT}/include) + +if (CMAKE_VERSION VERSION_LESS 2.8.3) + set (CMAKE_CURRENT_LIST_DIR) +endif () diff --git a/code/CMake/FFTW3fConfigVersion.cmake b/code/CMake/FFTW3fConfigVersion.cmake new file mode 100644 index 0000000..e750f80 --- /dev/null +++ b/code/CMake/FFTW3fConfigVersion.cmake @@ -0,0 +1,12 @@ + +set (PACKAGE_VERSION "3.3.7") + +# Check whether the requested PACKAGE_FIND_VERSION is compatible +if ("${PACKAGE_VERSION}" VERSION_LESS "${PACKAGE_FIND_VERSION}") + set (PACKAGE_VERSION_COMPATIBLE FALSE) +else () + set (PACKAGE_VERSION_COMPATIBLE TRUE) + if ("${PACKAGE_VERSION}" VERSION_EQUAL "${PACKAGE_FIND_VERSION}") + set (PACKAGE_VERSION_EXACT TRUE) + endif () +endif () diff --git a/code/CMakeLists.txt b/code/CMakeLists.txt new file mode 100644 index 0000000..ccf782d --- /dev/null +++ b/code/CMakeLists.txt @@ -0,0 +1,25 @@ +cmake_minimum_required( VERSION 3.8.2 ) + +project (habdec) +set ( CMAKE_CXX_STANDARD 11 ) + +# set ( CMAKE_BUILD_TYPE "Debug" ) +# set ( CMAKE_BUILD_TYPE "Release" ) +if(NOT CMAKE_BUILD_TYPE) + set(CMAKE_BUILD_TYPE "Release") +endif() + +if ( CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT ) + set ( CMAKE_INSTALL_PREFIX "${CMAKE_BINARY_DIR}/install" CACHE PATH "Install dir" FORCE) +endif() +message ( "CMAKE_INSTALL_PREFIX: " ${CMAKE_INSTALL_PREFIX} ) + + +add_subdirectory("Decoder") +add_subdirectory("IQSource") +add_subdirectory("websocketServer") + +option( fltkGUI "fltkGUI" OFF ) +if(fltkGUI) + add_subdirectory("fltkGUI") +endif() diff --git a/code/Decoder/AFC.h b/code/Decoder/AFC.h new file mode 100644 index 0000000..41077f0 --- /dev/null +++ b/code/Decoder/AFC.h @@ -0,0 +1,385 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include +#include +#include + +#include "IQVector.h" +#include "Average.h" + +namespace +{ + +template +bool FftPower(const TIQVector& fft_samples, TRVector& o_power_arr); + +template +double ComputeVariance(const VEC& i_containter, const double mean); + +template +void FindPeaks( const TRVector& v, + const double expected_relative_separation, + int* p_peak1, int* p_peak2 ); + +} + +namespace habdec +{ + +template +class AFC +{ +public: + typedef std::complex TComplex; + typedef std::vector TRVector; + typedef habdec::IQVector TIQVector; + + AFC() = default; + + void setFftSamples(const TIQVector& i_fft_samples) { fft_samples_ = i_fft_samples; } + double process(); + double operator()() { return process(); } + + const TRVector& getPowerSpectrum() const { return power_arr_; } + double getFrequencyCorrection() const { return frequency_correction_; } + void resetFrequencyCorrection(const double frequency_correction); + double getShift() const { return shift_Hz_; } + void getPeaks(int& pl, int& pr) const { pl = gui_peak_left_; pr = gui_peak_right_; } + void getNoiseFloor(double& nf, double& nv) const { nf = noise_floor_; nv = noise_variance_; } + +private: + TIQVector fft_samples_; // input FFT samples + TRVector power_arr_; + + double frequency_correction_ = 0; + + double noise_floor_ = 0; + double noise_variance_ = 0; + habdec::Average noise_floor_avg_ {100}; + habdec::Average noise_variance_avg_ {100}; + + habdec::Average peak_left_avg_ {4}; + habdec::Average peak_right_avg_ {4}; + double shift_Hz_ = 0; // peak separation in Hz + + int gui_peak_left_ = 0; + int gui_peak_right_ = 0; +}; + + +template +double AFC::process() +{ + using namespace std; + + bool b_debug = 0; + + if(b_debug) + cout<<"AFC::process begin"< peak_detect_threshold ) // peak detected + b_p1_detected = true; + + bool b_p2_detected = false; + if( power_arr_[p2] > peak_detect_threshold ) // peak detected + b_p2_detected = true; + + // peaks position stability + const int peak_stability_threshold = 2; // expressed in bins + bool b_peak_left_stable = false; + bool b_peak_right_stable = false; + if(b_p1_detected && b_p2_detected) + { + if(p2 +void AFC::resetFrequencyCorrection(const double frequency_correction) +{ + const double bins_per_Hertz = (double)fft_samples_.size() / fft_samples_.samplingRate(); + peak_left_avg_.reset( std::max((double) 0, peak_left_avg_ - frequency_correction * bins_per_Hertz) ); + peak_right_avg_.reset(std::max((double) 0, peak_right_avg_ - frequency_correction * bins_per_Hertz) ); + frequency_correction_ = 0; +} + + +} // namespace habdec + + +namespace +{ + + +template +bool hasNan(const TReal* v, size_t sz) +{ + for(size_t i=0; i +bool hasInf(const TReal* v, size_t sz) +{ + for(size_t i=0; i +double ComputeVariance(const VEC& i_containter, const double mean) +{ + double var = 0; + for(const auto& v : i_containter ) + var += (v - mean) * (v - mean); + var /= i_containter.size(); + return sqrt(var); +} + + +template +bool FftPower(const TIQVector& fft_samples, TRVector& o_power_arr) +{ + // http://nl.mathworks.com/help/signal/ug/power-spectral-density-estimates-using-fft.html + + using namespace std; + + bool b_debug = 0; + + if(!fft_samples.size()) + return 0; + + if(!fft_samples.samplingRate()) + return 0; + + if(0) + { + size_t i=0; + for(auto c : fft_samples) + cout<(fft_samples.data()); + + if(b_debug) + cout<<"FftPower NaN"<(p_fft_samples_data), fft_samples.size()*2) ) + { + cout<<"FftSpectrum Nan"<(p_fft_samples_data), fft_samples.size()*2) ) + { + cout<<"FftSpectrum Inf"< +void FindPeaks( const TRVector& v, + const double expected_relative_separation, + int* p_peak1, int* p_peak2 ) +{ + using namespace std; + + // FIND TWO MAXIMUMS SEPARATED AT LEAST BY BINS_SEP + // + + int bins_sep = round(expected_relative_separation * v.size()); + bins_sep = std::max(8, bins_sep); + + // first peak + auto i_max = max_element(v.begin(), v.end()); + int p1 = i_max - v.begin(); + float p1_val = *i_max; + + // second peak + int begin = std::max( p1 - 2 * bins_sep, 0 ); + int end = std::min( p1 + 2 * bins_sep, (int) v.size() ); + int p2 = 0; + float p2_val = v[0]; + for(int i=begin; i p2_val && abs(i-p1) > bins_sep/2) + { + p2 = i; + p2_val = v[i]; + } + } + + if(p2. +*/ + +#pragma once + +#include +#include + +namespace habdec +{ + +template +class Average +{ + +public: + Average(size_t max_count, T init_val=0) : sum_(0), count_(0), max_count_(std::max(size_t(1),max_count)) + { + add(init_val); + }; + + double add(const T& val) + { + double diff = get() - val; + + if(count_ == max_count_) + { + sum_ = get() * (max_count_-1) + val; + } + else + { + ++count_; + sum_ += val; + } + + return diff; + + } + + double get() const + { + if(!count_) + return sum_; + return double(sum_)/count_; + } + + operator double() const { double val = get(); return val; } + + void reset(const T& val) + { + sum_ = val; + count_ = 1; + } + + +private: + T sum_; + size_t count_; + const size_t max_count_; + +}; + +} // namespace habdec \ No newline at end of file diff --git a/code/Decoder/CMakeLists.txt b/code/Decoder/CMakeLists.txt new file mode 100755 index 0000000..03064ad --- /dev/null +++ b/code/Decoder/CMakeLists.txt @@ -0,0 +1,55 @@ + + +include_directories( ${PROJECT_SOURCE_DIR} ) +include_directories( ${CMAKE_CURRENT_SOURCE_DIR} ) + +set ( FFTW3f_DIR ../CMake ) +find_package( FFTW3f REQUIRED ) +include_directories( ${FFTW3f_INCLUDE_DIRS} ) +message( "FFTW Include:" ${FFTW3f_INCLUDE_DIRS} ) +message( "FFTW Lib:" ${FFTW3f_LIBRARIES} ) + + +# RTTY DECODER +set ( Decoder_src + AFC.h + Average.h + ${PROJECT_SOURCE_DIR}/common/console_colors.h + ${PROJECT_SOURCE_DIR}/common/console_colors.cpp + CRC.h CRC.cpp + Decimator.h + Decoder.h + FFT.h FFT.cpp + filtercoef.h + FirFilter.h + FSK2_Demod.h + func_timer.h + habdec_windows.h + IQVector.h + print_habhub_sentence.h print_habhub_sentence.cpp + RTTY.h + sentence_extract.h sentence_extract.cpp + SpectrumInfo.h + SymbolExtractor.h + ) + +SET( CMAKE_CXX_FLAGS " -O3 " ) +if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU") + # SET( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wshadow" ) + SET( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-class-memaccess" ) +elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "MSVC") + SET(CMAKE_CXX_FLAGS "/EHsc") + add_definitions( -D_USE_MATH_DEFINES ) +endif() + +set (PlatformSpecificLinking "") +if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU") + set (PlatformSpecificLinking "pthread") +endif() + +add_library( Decoder ${Decoder_src}) +target_link_libraries( Decoder + #${SoapySDR_LIBRARIES} + ${FFTW3f_LIBRARIES} + ${PlatformSpecificLinking} ) + diff --git a/code/Decoder/CRC.cpp b/code/Decoder/CRC.cpp new file mode 100644 index 0000000..c68fa36 --- /dev/null +++ b/code/Decoder/CRC.cpp @@ -0,0 +1,49 @@ +#include "CRC.h" + +#include + +namespace +{ + +char _hex(char Character) +{ + char _hexTable[] = "0123456789ABCDEF"; + return _hexTable[int(Character)]; +} + +} + + +namespace habdec +{ + + +std::string CRC(std::string i_str) +{ + using std::string; + + unsigned int CRC = 0xffff; + // unsigned int xPolynomial = 0x1021; + + for (size_t i = 0; i < i_str.length(); i++) + { + CRC ^= (((unsigned int)i_str[i]) << 8); + for (int j=0; j<8; j++) + { + if (CRC & 0x8000) + CRC = (CRC << 1) ^ 0x1021; + else + CRC <<= 1; + } + } + + string result; + result += _hex((CRC >> 12) & 15); + result += _hex((CRC >> 8) & 15); + result += _hex((CRC >> 4) & 15); + result += _hex(CRC & 15); + + return result; +} + +} // namespace habdec diff --git a/code/Decoder/CRC.h b/code/Decoder/CRC.h new file mode 100644 index 0000000..1831e18 --- /dev/null +++ b/code/Decoder/CRC.h @@ -0,0 +1,10 @@ +#pragma once + +#include + +namespace habdec +{ + +std::string CRC(std::string i_str); + +} // namespace habdec diff --git a/code/Decoder/Decimator.h b/code/Decoder/Decimator.h new file mode 100644 index 0000000..568a77b --- /dev/null +++ b/code/Decoder/Decimator.h @@ -0,0 +1,149 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include +#include +#include +#include + +namespace habdec +{ + +template +class Decimator +{ +public: + Decimator() {}; + Decimator(int decimation_factor, const Tt* p_taps, const size_t taps_size); + + void setInput(const Ts* p_in, const size_t in_size); + void setOutput(Ts* p_out); + void setFilter(const Tt* p_taps, const size_t taps_size); + + size_t operator()(); + + void setFactor(const int i_f) {decimation_factor_ = i_f;} + int factor() const {return decimation_factor_;} + +private: + int decimation_factor_ = 0; + + const Ts* p_in_ = 0; + size_t p_in_size_ = 0; + Ts* p_out_ = 0; //size is p_in_size_/decimation_factor_ + std::vector p_buff_; + std::vector p_taps_; + size_t decimated_samples_count_ = 0; +}; + + +template +Decimator::Decimator(int decimation_factor, const Tt* p_taps, const size_t taps_size) +{ + setFactor(decimation_factor); + setFilter(p_taps, taps_size); +} + + +template +void Decimator::setInput(const Ts* p_in, const size_t in_size) +{ + p_in_ = p_in; + p_in_size_ = in_size; + + const size_t new_buff_size = p_in_size_ + p_taps_.size() + decimation_factor_; + if(p_buff_.size() < new_buff_size) + { + p_buff_.resize(new_buff_size); + memset( p_buff_.data(), 0, sizeof(Ts) * p_taps_.size() ); + } +} + + +template +void Decimator::setFilter(const Tt *p_taps, const size_t taps_size) +{ + p_taps_.resize(taps_size); + memcpy( (void*) p_taps_.data(), p_taps, taps_size * sizeof(Tt)); +} + + +template +void Decimator::setOutput(Ts* p_out) +{ + p_out_ = p_out; +} + + +template +size_t Decimator::operator()() +{ + if(!decimation_factor_ || !p_in_ || !p_out_ || !p_buff_.size()) + { + std::cout<<"Decimator not fully initialised"<. +*/ + +#pragma once + +#include +#include +#include +#include +#include +#include + +#include "IQVector.h" +#include "Decimator.h" +#include "FFT.h" +#include "FirFilter.h" +#include "filtercoef.h" +#include "FSK2_Demod.h" +#include "SymbolExtractor.h" +#include "RTTY.h" +#include "sentence_extract.h" +#include "Decoder.h" +#include "AFC.h" +#include "SpectrumInfo.h" +#include "print_habhub_sentence.h" +#include "CRC.h" + +namespace habdec +{ + + +template +class Decoder +{ + + // STEPS: + // + // multi stage Decimation + // FFT + // Auto Frequency Correct + // FIR Filtering + // Demodulation (Polar Discriminant) + // Symbol Extraction + // RTTY + +public: + typedef TReal TValue; + typedef std::complex TComplex; + typedef std::vector TRVector; + typedef habdec::IQVector TIQVector; + typedef habdec::Decimator< std::complex, TReal > TDecimator; + typedef habdec::FirFilter< std::complex, TReal> TFIR; + + // feed decoder + bool pushSamples(const TIQVector& i_stream); + + // configure options + void lowpass_bw(float i_lowpass_bw); + float lowpass_bw() const; + void lowpass_trans(float i_lowpass_trans); + float lowpass_trans() const; + void baud(double i_baud); + double baud() const; + void rtty_bits(size_t i_ascii_bits); + size_t rtty_bits() const; + void rtty_stops(float i_ascii_stops); + float rtty_stops() const; + + size_t setupDecimationStagesFactor(const size_t i_factor); + size_t setupDecimationStagesBW(const double i_max_sampling_rate); + + // get result + std::string getRTTY(); + std::string getLastSentence(); + + // get info + int getDecimationFactor() const; + double getInputSamplingRate() const; + double getDecimatedSamplingRate() const; + double getSymbolRate() const; + + // get data for GUI + size_t getBinsCount() const; + const TIQVector getFFT() const; + const TRVector getDemodulated() const; + const TRVector getPowerSpectrum() const; + void getPeaks(int& pl, int& pr); + void getNoiseFloor(double& nf, double& nv); + double getShift() const; + double getFrequencyCorrection() const; + void resetFrequencyCorrection(double frequency_correction); + + // template + SpectrumInfo getSpectrumInfo(); + + // run it + void process(); + void operator()() + { + typedef std::chrono::nanoseconds TDur; + auto _start = std::chrono::high_resolution_clock::now(); + process(); + TDur _duration = std::chrono::duration_cast(std::chrono::high_resolution_clock::now() - _start); + // std::cout<<"process() duration "<<_duration.count()<<" nS "< decimation_stages_; + int decimation_factor_ = 1; + + // FFT + const size_t fft_bins_cnt_ = 1<<12; + FFT fft_; //TODO ! this is only float ! + TIQVector freq_in_; // FFT of chunk size + TIQVector freq_out_; // FFT of chunk size + mutable std::mutex freq_out_mtx_; + + // AFC + AFC afc_; + mutable std::mutex afc_mtx_; + + // Low Pass FIR + float lowpass_bw_ = 0.05; + float lowpass_trans_ = 0.0025; + TFIR lowpass_fir_; + mutable std::mutex lowpass_fir_mtx_; + + // Demodulation + TRVector demodulated_; // result of Polar Discriminant + mutable std::mutex demodulated_mtx_; + + // Symbol Extraction from demodulated samples + SymbolExtractor symbol_extractor_; + + // RTTY reconstruction from bits + RTTY rtty_; + std::string rtty_char_stream_; // result of rtty + std::string last_sentence_; // result of rtty + // size_t last_sentence_len_ = 0; // optimization for regexp run + + // threading + mutable std::mutex process_mutex_; // mutex for main processing + + bool live_print_ = true; // live print decoded characters +}; + + +template +bool habdec::Decoder::pushSamples(const TIQVector& i_stream) +{ + { + std::lock_guard _lock(iq_in_buffer_mtx_); + const size_t pre_insert_size = iq_in_buffer_.size(); + iq_in_buffer_.resize( pre_insert_size + i_stream.size() ); + memcpy( iq_in_buffer_.data() + pre_insert_size, i_stream.data(), i_stream.size() * sizeof(TComplex) ); + } + + if( !iq_in_buffer_.samplingRate() ) + init( i_stream.samplingRate() ); + + return true; +} + + +template +void habdec::Decoder::init(const float i_sampling_rate) +{ + iq_in_buffer_.samplingRate(i_sampling_rate); + + setupDecimationStagesBW(10.1e6/256); + + std::lock_guard lock(process_mutex_); + + // FFT + freq_in_.reserve(fft_bins_cnt_); + freq_out_.reserve(fft_bins_cnt_); +} + + +template +void habdec::Decoder::lowpass_bw(float i_lowpass_bw) +{ + std::lock_guard _lock(lowpass_fir_mtx_); + lowpass_bw_ = i_lowpass_bw; + lowpass_fir_.LP_BlackmanHarris(lowpass_bw_, lowpass_trans_); +} + +template +float habdec::Decoder::lowpass_bw() const +{ + return lowpass_bw_; +} + +template +void habdec::Decoder::lowpass_trans(float i_lowpass_trans) +{ + std::lock_guard _lock(lowpass_fir_mtx_); + lowpass_trans_ = i_lowpass_trans; + lowpass_fir_.LP_BlackmanHarris(lowpass_bw_, lowpass_trans_); +} + +template +float habdec::Decoder::lowpass_trans() const +{ + return lowpass_trans_; +} + + + +template +size_t habdec::Decoder::setupDecimationStagesFactor(const size_t i_factor) +{ + using namespace std; + + if( i_factor<1 || i_factor>256 ) + { + cout<<"Unsupported decimation factor: "< lock(process_mutex_); + + decimation_stages_.clear(); + decimation_factor_ = 1; + + switch(i_factor) + { + case 256: + decimation_stages_.emplace_back( TDecimator(64, &d_256_r_64_kernel[0], d_256_r_64_len) ); + decimation_stages_.emplace_back( TDecimator(4, &d_4_r_4_kernel[0], d_4_r_4_len) ); + break; + case 128: + decimation_stages_.emplace_back( TDecimator(32, &d_128_r_32_kernel[0], d_128_r_32_len) ); + decimation_stages_.emplace_back( TDecimator(4, &d_4_r_4_kernel[0], d_4_r_4_len) ); + break; + case 64: + decimation_stages_.emplace_back( TDecimator(32, &d_64_r_32_kernel[0], d_64_r_32_len) ); + decimation_stages_.emplace_back( TDecimator(2, &d_2_r_2_kernel[0], d_2_r_2_len) ); + break; + case 32: + decimation_stages_.emplace_back( TDecimator(16, &d_32_r_16_kernel[0], d_32_r_16_len) ); + decimation_stages_.emplace_back( TDecimator(2, &d_2_r_2_kernel[0], d_2_r_2_len) ); + break; + case 16: + decimation_stages_.emplace_back( TDecimator(8, &d_16_r_8_kernel[0], d_16_r_8_len) ); + decimation_stages_.emplace_back( TDecimator(2, &d_2_r_2_kernel[0], d_2_r_2_len) ); + break; + case 8: + decimation_stages_.emplace_back( TDecimator(8, &d_8_r_8_kernel[0], d_8_r_8_len) ); + break; + case 4: + decimation_stages_.emplace_back( TDecimator(4, &d_4_r_4_kernel[0], d_4_r_4_len) ); + break; + case 2: + decimation_stages_.emplace_back( TDecimator(2, &d_2_r_2_kernel[0], d_2_r_2_len) ); + break; + default: + cout<<"Unsupported decimation factor: "<= fft_bins_cnt_) + { + { + lock_guard _lock(freq_out_mtx_); + freq_out_.resize(fft_bins_cnt_); + fft_.setInput( (float*) freq_in_.data(), fft_bins_cnt_ ); + fft_.setOutput( (float*) freq_out_.data() ); + fft_(); + } + freq_in_.clear(); + } + + + const size_t batch_size = 256; // why does it have to be 256 ? + + if(iq_samples_decimated_.size() < batch_size) + { + if(b_debug) + cout<<"Decoder::process() "<<"iq_samples_decimated_.size() < batch_size : "<(afc_mtx_, try_to_lock)) + { + if(unique_lock(freq_out_mtx_, try_to_lock)) + { + if(freq_out_.size() == fft_bins_cnt_) + afc_.setFftSamples(freq_out_); + afc_(); + } + } + + + double frequency_correction = getFrequencyCorrection(); + double shift_Hz = afc_.getShift(); + double nf, nv; + afc_.getNoiseFloor(nf, nv); + + // cout< 4*max_decimated_sampling_rate_) + { + iq_samples_temp_.clear(); + iq_samples_decimated_.clear(); + return; + } + + + // Low Pass FIR + // + const size_t samples_to_filter_cnt = iq_samples_decimated_.size() - iq_samples_decimated_.size() % batch_size; + iq_samples_filtered_.resize(samples_to_filter_cnt); + { + lock_guard _lock(lowpass_fir_mtx_); + lowpass_fir_.setInput (iq_samples_decimated_.data(), samples_to_filter_cnt); + lowpass_fir_.setOutput(iq_samples_filtered_.data()); + lowpass_fir_.LP_BlackmanHarris(lowpass_bw_, lowpass_trans_); + lowpass_fir_(); + iq_samples_filtered_.samplingRate( getDecimatedSamplingRate() ); + } + iq_samples_decimated_.erase( iq_samples_decimated_.begin(), iq_samples_decimated_.begin()+samples_to_filter_cnt ); + + if(b_debug) + cout<<"Decoder::process() "<<"FIR taps : "< _lock(demodulated_mtx_); + demodulated_.resize( iq_samples_filtered_.size() ); + FSK2_Demod( + iq_samples_filtered_.data(), iq_samples_filtered_.size(), + demodulated_.data() ); + + symbol_extractor_.samplingRate( getDecimatedSamplingRate() ); + symbol_extractor_.pushSamples(demodulated_); + } + + + if(b_debug) + cout<<"Decoder::process() "<<"demodulated_.size() "< symbols = symbol_extractor_.get(); + if(b_debug) + cout<<"Decoder::process() "<<"symbols.size() "< 1000) + rtty_char_stream_.erase( 0, rtty_char_stream_.rfind('$') ); + + // scan for sentence from time to time + if( rtty_char_stream_.size() > 20 /*last_sentence_.size()/2*/ ) + { + bool b_scan_for_sentence = true; + while(b_scan_for_sentence) + { + map result = extractSentence(rtty_char_stream_); + if( result["success"] == "OK" ) + { + rtty_char_stream_ = result["stream"]; // rest of stream after sentence + last_sentence_ = result["callsign"] + "," + result["data"] + "*" + result["crc"]; + printHabhubSentence( result["callsign"], result["data"], result["crc"] ); + + if( success_callback_ && + result["crc"] == CRC(result["callsign"] + "," + result["data"]) ) + success_callback_( result["callsign"], result["data"], result["crc"] ); + } + else + { + b_scan_for_sentence = false; + } + } + } +} // process() + + +template +std::string Decoder::getRTTY() +{ + return rtty_char_stream_; +} + + +template +std::string Decoder::getLastSentence() +{ + return last_sentence_; +} + + +template +void Decoder::baud(double i_baud) +{ + std::lock_guard _lock(process_mutex_); + symbol_extractor_.symbolRate(i_baud); +} + + +template +double Decoder::baud() const +{ + return symbol_extractor_.symbolRate(); +} + + +template +void Decoder::rtty_bits(size_t i_ascii_bits) +{ + std::lock_guard _lock(process_mutex_); + rtty_.ascii_bits(i_ascii_bits); +} + + +template +size_t Decoder::rtty_bits() const +{ + return rtty_.ascii_bits(); +} + + +template +void Decoder::rtty_stops(float i_ascii_stops) +{ + std::lock_guard _lock(process_mutex_); + rtty_.ascii_stops(i_ascii_stops); +} + + +template +float Decoder::rtty_stops() const +{ + return rtty_.ascii_stops(); +} + + +template +int Decoder::getDecimationFactor() const +{ + //std::lock_guard _lock(process_mutex_); + // this probably should be locked with process_mutex_ + return decimation_factor_; +} + + +template +double Decoder::getInputSamplingRate() const +{ + return iq_in_buffer_.samplingRate(); +} + + +template +double Decoder::getDecimatedSamplingRate() const +{ + return getInputSamplingRate() / getDecimationFactor(); +} + + +template +double Decoder::getSymbolRate() const +{ + return symbol_extractor_.symbolRate(); +} + + +template +size_t Decoder::getBinsCount() const +{ + return fft_bins_cnt_; +} + + +template +const typename Decoder::TIQVector Decoder::getFFT() const +{ + std::lock_guard _lock(freq_out_mtx_); + return freq_out_; +} + + +template +const typename Decoder::TRVector Decoder::getDemodulated() const +{ + std::lock_guard _lock(demodulated_mtx_); + return demodulated_; +} + + +template +const typename Decoder::TRVector Decoder::getPowerSpectrum() const +{ + std::lock_guard _lock(afc_mtx_); + // std::this_thread::sleep_for( ( std::chrono::duration(1000) )); + return afc_.getPowerSpectrum(); +} + + +template +void Decoder::getPeaks(int& pl, int& pr) +{ + std::lock_guard _lock(afc_mtx_); + afc_.getPeaks(pl, pr); +} + + +template +void habdec::Decoder::getNoiseFloor(double& nf, double& nv) +{ + std::lock_guard _lock(afc_mtx_); + afc_.getNoiseFloor(nf, nv); +} + + +template +double habdec::Decoder::getShift() const +{ + return afc_.getShift(); +} + + +template +double habdec::Decoder::getFrequencyCorrection() const +{ + return afc_.getFrequencyCorrection(); +} + + +template +void habdec::Decoder::resetFrequencyCorrection(double frequency_correction) +{ + afc_.resetFrequencyCorrection(frequency_correction); +} + + +template +SpectrumInfo habdec::Decoder::getSpectrumInfo() +{ + SpectrumInfo spectr_info; + spectr_info = getPowerSpectrum(); + if(!spectr_info.size()) + return spectr_info; + spectr_info.min_ = *std::min_element( spectr_info.cbegin(), spectr_info.cend() ); + spectr_info.max_ = *std::max_element( spectr_info.cbegin(), spectr_info.cend() ); + + int pl, pr; + getPeaks(pl, pr); + spectr_info.peak_left_ = std::abs(pl); + spectr_info.peak_left_valid_ = pl>0; + spectr_info.peak_right_ = std::abs(pr); + spectr_info.peak_right_valid_ = pr>0; + + getNoiseFloor(spectr_info.noise_floor_, spectr_info.noise_variance_); + spectr_info.sampling_rate_ = getDecimatedSamplingRate(); + + spectr_info.shift_ = getShift(); + + return spectr_info; +} + + +template +std::ostream& operator<<( std::ostream& output, const std::vector& v ) +{ + for(const auto& a : v) + output<. +*/ + +#include "FFT.h" + +#include +#include +#include + +namespace habdec +{ + +FFT::~FFT() +{ + if(size_) + fftwf_destroy_plan(fftw_plan_); + if(fft_in_) + fftwf_free(fft_in_); + if(fft_out_) + fftwf_free(fft_out_); +} + + +size_t FFT::size() const +{ + return size_; +} + + +void FFT::setInput(float* p_input, const size_t i_size) +{ + if(i_size != size_) + { + std::cout<<"FFT rebuild to "<* p_samples_float = reinterpret_cast*>(p_out_); + + const size_t half = size()/2; + for(size_t i=0; i) ); + fftwf_execute(fftw_plan_); + memcpy( (void*) p_out_, fft_out_, size() * sizeof(std::complex) ); + + swap_half(); + } + else if(!p_in_) + { + std::cout<<"FFT No Input"<. +*/ + +#pragma once + +#include +#include + +namespace habdec +{ + + +class FFT +{ +public: + FFT() = default; + FFT(const FFT&) = delete; + FFT& operator=(const FFT&) = delete; + ~FFT(); + + void setInput(float* p_input, const size_t i_size); + void setOutput(float* p_output); + size_t size() const; + + void operator()(); + +private: + + void swap_half(); // swaps values on other half of FFT result + + size_t size_ = 0; + + float* p_in_ = 0; + float* p_out_ = 0; + + // fftw stuff + fftwf_plan fftw_plan_; + fftwf_complex* fft_in_ = 0; + fftwf_complex* fft_out_ = 0; + +}; + + +} // namespace habdec diff --git a/code/Decoder/FSK2_Demod.h b/code/Decoder/FSK2_Demod.h new file mode 100644 index 0000000..7510da9 --- /dev/null +++ b/code/Decoder/FSK2_Demod.h @@ -0,0 +1,46 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include + +namespace habdec +{ + + +template +void FSK2_Demod( + const std::complex* p_cmplx_samples, const size_t samples_count, + T* o_demod ) +{ + // TO DO - this should not be static if threads... + static std::complex last_value = p_cmplx_samples[0]; + + for(size_t i=1; i. +*/ + +#pragma once + +#include +#include +#include +#include + +#include "habdec_windows.h" + + +namespace habdec +{ + + +template // Tsamples, Ttaps +class FirFilter +{ +public: + bool setInput(const Ts* p_input, const size_t in_size); + bool setOutput(Ts*); + bool setFilter(const Tt*, const size_t taps_size); + size_t taps_size(); + bool operator()(); + + void LP_BlackmanHarris(const float i_relative_filt_width, const float trans_bw = 0); + +private: + const Ts* p_input_ = 0; + size_t p_input_size_ = 0; + + Ts* p_output_ = 0; + + std::vector taps_; + + std::vector buff_; + + void dotProduct(); +}; + + + + +template +bool inline FirFilter::operator()() +{ + dotProduct(); + return true; +} + + +template +size_t inline FirFilter::taps_size() +{ + return taps_.size() ; +} + + +template +bool inline FirFilter::setInput(const Ts* p_input, const size_t in_size) +{ + if(!p_input || !in_size) + return false; + + p_input_ = p_input; + p_input_size_ = in_size; + + return true; +} + + +template +bool inline FirFilter::setFilter(const Tt* p_filter, const size_t in_size) +{ + if(!p_filter || !in_size) + return false; + + taps_.resize(in_size); + memcpy( taps_.data(), p_filter, in_size * sizeof(Tt) ); + + return true; +} + + +template +bool inline FirFilter::setOutput(Ts* p_output) +{ + if(!p_output) + return false; + + p_output_ = p_output; + + return true; +} + + +template +void FirFilter::dotProduct() +{ + using namespace std; + + if(!taps_.size()) + { + cout<<"FirFilter::dotProduct() no taps. return."< p_input_size_+1 ) + { + cout<<"FirFilter::dotProduct() more taps than samples. return. "< +void FirFilter::LP_BlackmanHarris(const float i_relative_filt_width, const float trans_bw) +{ + if(!p_input_size_) + { + std::cout<<"FirFilter::LP_BlackmanHarris No Input set."<p_input_size_) + taps_sz = p_input_size_; + taps_sz |= 1; // must be odd number + + if(taps_sz <= 4) + return; + + if(taps_sz == taps_.size()) + return; + + taps_.resize(taps_sz); + + double _sum = 0; + const int _mid = int(taps_sz/2); // !! INT IS VERY IMPORTANT HERE !! + for(int i=0; i(size_t(i), taps_sz); + _sum += taps_[i]; + } + + // normalize taps_ + for(size_t i=0; i. +*/ + +#pragma once + +#include +#include +#include + +namespace habdec +{ + +// IQ vector with sampling rate +// +template +class IQVector : public std::vector< std::complex > +{ +public: + typedef T TValue; + typedef std::complex TComplex; + + IQVector() = default; + IQVector(const IQVector& rhs); + IQVector operator=(const IQVector& rhs); + + double samplingRate() const {return sampling_rate_;} + void samplingRate(const double i_samplingRate) {sampling_rate_ = i_samplingRate;} + +private: + std::atomic sampling_rate_ = {0}; +}; + + +template +IQVector::IQVector(const IQVector& rhs) : std::vector< std::complex >::vector(rhs) +{ + sampling_rate_.store(rhs.sampling_rate_); +} + + +template +IQVector IQVector::operator=(const IQVector& rhs) +{ + std::vector< std::complex >::operator=(rhs); + sampling_rate_.store(rhs.sampling_rate_); + return *this; +} + + +template +std::ostream& operator<<( std::ostream& output, const IQVector& iqVector ) +{ + for(size_t i=0; i. +*/ + +#pragma once + +#include "stddef.h" +#include +#include +#include + +#include "common/console_colors.h" + +namespace habdec +{ + +template +class RTTY +{ + +public: + void ascii_bits(size_t i_bits) {nbits_ = i_bits;}; + size_t ascii_bits() const {return nbits_;}; + void ascii_stops(float i_stops) {nstops_ = i_stops;}; + float ascii_stops() const {return nstops_;}; + + void push(const std::vector& i_bits); + size_t size() {return chars_.size();} + std::vector get(); + size_t operator()(); + +private: + size_t nbits_ = 0; + float nstops_ = 0; + + std::vector bits_; + std::vector chars_; +}; + + + +template +void RTTY::push(const std::vector& i_bits) +{ + using namespace std; + bits_.insert( bits_.end(), i_bits.begin(), i_bits.end() ); +} + + +template +std::vector RTTY::get() +{ + auto res = chars_; + chars_.clear(); + return res; +} + + + +template +size_t RTTY::operator()() +{ + if(!nbits_ && !nstops_) + return 0; + + if( bits_.size() < (1+nbits_+nstops_) ) + return 0; + + using namespace std; + + size_t decoded_chars = 0; + size_t last_decoded_bit_index = 0; + + for(size_t i=0; i. +*/ + +#pragma once + +#include +#include + +namespace habdec +{ + +/* + just a vector with spectrum power values + and some extra info +*/ + +template +class SpectrumInfo : public std::vector +{ +public: + typedef T TValue; + + mutable T min_ = 0; + mutable T max_ = 0; + mutable double noise_floor_ = 0; + mutable double noise_variance_ = 0; + mutable double sampling_rate_ = 0; + mutable double shift_ = 0; + mutable int peak_left_ = 0; + mutable int peak_right_ = 0; + mutable bool peak_left_valid_ = false; + mutable bool peak_right_valid_ = false; + + SpectrumInfo() = default; + + template + SpectrumInfo(const SpectrumInfo& rhs) : + std::vector::vector(rhs), + noise_floor_(rhs.noise_floor_), + noise_variance_(rhs.noise_variance_), + peak_left_(rhs.peak_left_), + peak_right_(rhs.peak_right_), + peak_left_valid_(rhs.peak_left_valid_), + peak_right_valid_(rhs.peak_right_valid_) + { + // + } + + template + const SpectrumInfo& operator=(const SpectrumInfo& rhs) + { + std::vector::operator=(rhs); + noise_floor_ = rhs.noise_floor_; + noise_variance_ = rhs.noise_variance_; + peak_left_ = rhs.peak_left_; + peak_right_ = rhs.peak_right_; + peak_left_valid_ = rhs.peak_left_valid_; + peak_right_valid_ = rhs.peak_right_valid_; + return *this; + } + + const SpectrumInfo& operator=(const std::vector& rhs) + { + std::vector::operator=(rhs); + return *this; + } + +}; + + + +} // namespace habdec \ No newline at end of file diff --git a/code/Decoder/SymbolExtractor.h b/code/Decoder/SymbolExtractor.h new file mode 100644 index 0000000..48a53b9 --- /dev/null +++ b/code/Decoder/SymbolExtractor.h @@ -0,0 +1,261 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include +#include +#include +#include + +namespace +{ + +template +inline int sgn(T val) +{ + return (T(0) < val) - (val < T(0)); +} + + +template +inline int _dir(T left, T right) +{ + if( sgn(left) < sgn(right) ) + return 1; + else if( sgn(left) > sgn(right) ) + return -1; + else + return 0; +} + + +template +void FlipPointAvrg( + const TRVector& v, + const size_t i, + const size_t R, + TReal& o_avg_l, + TReal& o_avg_r ) +{ + using namespace std; int _L = max(int(i-R), 0); // left bound + int _R = min(i+R, v.size()); // right bound + o_avg_l = std::accumulate(v.begin()+_L, v.begin()+i, TReal(0)) / (i-_L); + o_avg_r = std::accumulate(v.begin()+i, v.begin()+_R, TReal(0)) / (_R-i); +} + + +} // namespace + + + +namespace habdec +{ + +template +class SymbolExtractor +{ + +public: + typedef std::vector TRVector; + + void pushSamples(const TRVector& v); //REAL samples after Freq demodulation + + void samplingRate(const double sm_r) { sampling_rate_ = sm_r; } + double samplingRate() const { return sampling_rate_; } + + void symbolRate(const double sb_r) { symbol_rate_ = sb_r; } // baud + double symbolRate() const { return symbol_rate_; } + + std::vector get(size_t count=0); + + size_t samplesPerBit() const { return size_t(round( samplingRate()/symbolRate() )); } + + void operator()(); + +private: + double sampling_rate_ = 0; + double symbol_rate_ = 1; + TRVector samples_; + std::vector bits_; + + size_t findFirstFlipPoint(const size_t start_offset); + std::vector findFlipPoints(); +}; + + + + +template +void SymbolExtractor::pushSamples(const TRVector& v) +{ + using namespace std; + + if(!v.size()) + return; + + // safety vent + if(samples_.size() > 1e6) + { + cout<<"SymbolExtractor::pushSamples overflow. Delete samples."< +void SymbolExtractor::operator()() +{ + if( !sampling_rate_ || !symbol_rate_ ) + return; + + if( samples_.size() < samplingRate()/symbolRate()*3 ) // have at least 3 symbols + return; + + std::vector flip_points = findFlipPoints(); + if(!flip_points.size()) + return; + + size_t last_flip_point = 0; + for(const auto flip_point : flip_points) + { + TReal avg = TReal( + std::accumulate( samples_.begin()+last_flip_point, + samples_.begin()+flip_point, (TReal)0 ) + ) / (flip_point-last_flip_point); + + bool bit_value = avg > 0; + size_t bit_count = size_t( round( float(flip_point-last_flip_point) / float(samplesPerBit()) ) ); + last_flip_point = flip_point; + while(bit_count--) + bits_.push_back(bit_value); + } + + size_t erase_to = std::min(last_flip_point, samples_.size()); + samples_.erase( samples_.begin(), samples_.begin() + erase_to ); +} + + +template +size_t SymbolExtractor::findFirstFlipPoint(const size_t start_offset) +{ + if( (samples_.size()-start_offset) < samplesPerBit() ) + return 0; + + // FIND FIRST FLIP POINT + // IT NEEDS TO HAVE DIFFERENT SIGN OF AVERAGE + // ON IT'S LEFT AND RIGHT SIDE OF LENGTH R + const size_t R = std::max(4, int(samplesPerBit() / 4)); + + std::vector flip_points; + + // start at R + size_t flip_point = start_offset + R; + + TReal avg_left; + TReal avg_right; + FlipPointAvrg(samples_, flip_point, R, avg_left, avg_right); + + // SCAN UNTIL FIRST FLIP_POINT + while(sgn(avg_left) == sgn(avg_right)) + { + flip_point += 1; + + if(flip_point >= (samples_.size() - samplesPerBit())) + return 0; + + FlipPointAvrg(samples_, flip_point, R, avg_left, avg_right); + } + + size_t flip_point_left = flip_point; + // int value_change_dir = _dir(avg_left, avg_right); + + // SCAN UNTIL LAST FLIP_POINT WITH CHANGING SIGN OF AVERAGE + while(sgn(avg_left) != sgn(avg_right)) + { + flip_point += 1; + + if(flip_point >= (samples_.size() - samplesPerBit())) + return 0; + + FlipPointAvrg(samples_, flip_point, R, avg_left, avg_right); + } + + size_t flip_point_right = flip_point; + + // in range [flip_point_left, flip_point_right) + // find point with largest difference in average values + + std::vector flip_point_candidates; + std::vector flip_point_candidates_weight; + for(size_t i=flip_point_left; i +std::vector SymbolExtractor::findFlipPoints() +{ + size_t offset = 0; + size_t flip_point = findFirstFlipPoint(offset); + std::vector all_points; + + while(flip_point) + { + all_points.push_back(flip_point); + offset = flip_point; + flip_point = findFirstFlipPoint(offset); + } + return all_points; +} + + +template +std::vector SymbolExtractor::get(size_t count) +{ + if(count == 0) + count = bits_.size(); + const size_t _count = std::min(count, bits_.size()); + + const std::vector res( bits_.begin(), bits_.begin() + _count ); + bits_.erase( bits_.begin(), bits_.begin() + _count ); + + return res; +} + + + +} // namespace habdec + + diff --git a/code/Decoder/filtercoef.h b/code/Decoder/filtercoef.h new file mode 100644 index 0000000..6018862 --- /dev/null +++ b/code/Decoder/filtercoef.h @@ -0,0 +1,1449 @@ +#pragma once + +/* + coefficients taken from + https://github.com/csete/gqrx/blob/master/src/dsp/filter/fir_decim_coef.h +*/ + +/* +d_2_r_2_len = 69 +d_2_r_2_kernel +d_4_r_4_len = 139 +d_4_r_4_kernel +d_8_r_8_len = 280 +d_8_r_8_kernel +d_16_r_8_len = 54 +d_16_r_8_kernel +d_32_r_16_len = 107 +d_32_r_16_kernel +d_64_r_32_len = 212 +d_64_r_32_kernel +d_128_r_32_len = 174 +d_128_r_32_kernel +d_256_r_64_len = 348 +d_256_r_64_kernel +*/ + +static const int d_2_r_2_len = 69; +static const float d_2_r_2_kernel[] = +{ + 0.000399985734121014f, + 0.002073370222476234f, + 0.004853019240304940f, + 0.005977464755456102f, + 0.002625480716699286f, + -0.002713628293157090f, + -0.003379460736391527f, + 0.001637205667907783f, + 0.004080689203761314f, + -0.000982433398470081f, + -0.005119016867477646f, + 0.000177424749467386f, + 0.006424890506348696f, + 0.001008090651156955f, + -0.007915926496343137f, + -0.002717062331286239f, + 0.009511042111613645f, + 0.005077150379032227f, + -0.011151300589456603f, + -0.008251061374053964f, + 0.012781117215688672f, + 0.012490374909303374f, + -0.014344287749952384f, + -0.018209086168089920f, + 0.015778580923975386f, + 0.026178028229057050f, + -0.017029165534577999f, + -0.038051941291319488f, + 0.018060406839966188f, + 0.058210457193828925f, + -0.018831122390764166f, + -0.102778567522516130f, + 0.019291268777910851f, + 0.317182812089170980f, + 0.480536048712957740f, + 0.317182812089170980f, + 0.019291268777910851f, + -0.102778567522516130f, + -0.018831122390764166f, + 0.058210457193828925f, + 0.018060406839966188f, + -0.038051941291319488f, + -0.017029165534577999f, + 0.026178028229057050f, + 0.015778580923975386f, + -0.018209086168089920f, + -0.014344287749952384f, + 0.012490374909303374f, + 0.012781117215688672f, + -0.008251061374053964f, + -0.011151300589456603f, + 0.005077150379032227f, + 0.009511042111613645f, + -0.002717062331286239f, + -0.007915926496343137f, + 0.001008090651156955f, + 0.006424890506348696f, + 0.000177424749467386f, + -0.005119016867477646f, + -0.000982433398470081f, + 0.004080689203761314f, + 0.001637205667907783f, + -0.003379460736391527f, + -0.002713628293157090f, + 0.002625480716699286f, + 0.005977464755456102f, + 0.004853019240304940f, + 0.002073370222476234f, + 0.000399985734121014f +}; + +static const int d_4_r_4_len = 139; +static const float d_4_r_4_kernel[] = +{ + 0.000042167047949931f, + 0.000162480875041441f, + 0.000413474829003805f, + 0.000815488719349860f, + 0.001323484844111109f, + 0.001803932401530970f, + 0.002050805379425780f, + 0.001851476423100084f, + 0.001088358238163842f, + -0.000165599354540670f, + -0.001612840277093291f, + -0.002799173360323900f, + -0.003280737659419560f, + -0.002830930204582274f, + -0.001589296551711622f, + -0.000060142418430366f, + 0.001072157673911288f, + 0.001252059507347206f, + 0.000346781210023729f, + -0.001233491421169468f, + -0.002682865592015316f, + -0.003178340139233828f, + -0.002320119390193667f, + -0.000402092792444196f, + 0.001661437823975322f, + 0.002761727219457103f, + 0.002186981534424376f, + 0.000071307331744879f, + -0.002570893712874658f, + -0.004301512250227543f, + -0.004015094439084645f, + -0.001606879839533175f, + 0.001838674337622738f, + 0.004510048531846937f, + 0.004804547613530567f, + 0.002266863620581679f, + -0.002004704037111716f, + -0.005785548895574678f, + -0.006849655924079080f, + -0.004239720077392586f, + 0.001024318787772757f, + 0.006275193248599259f, + 0.008511512338709764f, + 0.006070603106211769f, + -0.000247611530141919f, + -0.007317511868656072f, + -0.011170336815604164f, + -0.009152698013614463f, + -0.001621157345452147f, + 0.007851435931989321f, + 0.014073238852672171f, + 0.012972692080589394f, + 0.004087473189926854f, + -0.008634954375856124f, + -0.018413964067748419f, + -0.019050011539439745f, + -0.008545626179408438f, + 0.009039966712164142f, + 0.024793283315122296f, + 0.029034181171149441f, + 0.016560363014866013f, + -0.009522346448795137f, + -0.037569562545468192f, + -0.051411140638474247f, + -0.037221789978391415f, + 0.009679493935209005f, + 0.081286213859684806f, + 0.158552299980228740f, + 0.217917169253869340f, + 0.240164834839879550f, + 0.217917169253869340f, + 0.158552299980228740f, + 0.081286213859684806f, + 0.009679493935209005f, + -0.037221789978391415f, + -0.051411140638474247f, + -0.037569562545468192f, + -0.009522346448795137f, + 0.016560363014866013f, + 0.029034181171149441f, + 0.024793283315122296f, + 0.009039966712164142f, + -0.008545626179408438f, + -0.019050011539439745f, + -0.018413964067748419f, + -0.008634954375856124f, + 0.004087473189926854f, + 0.012972692080589394f, + 0.014073238852672171f, + 0.007851435931989321f, + -0.001621157345452147f, + -0.009152698013614463f, + -0.011170336815604164f, + -0.007317511868656072f, + -0.000247611530141919f, + 0.006070603106211769f, + 0.008511512338709764f, + 0.006275193248599259f, + 0.001024318787772757f, + -0.004239720077392586f, + -0.006849655924079080f, + -0.005785548895574678f, + -0.002004704037111716f, + 0.002266863620581679f, + 0.004804547613530567f, + 0.004510048531846937f, + 0.001838674337622738f, + -0.001606879839533175f, + -0.004015094439084645f, + -0.004301512250227543f, + -0.002570893712874658f, + 0.000071307331744879f, + 0.002186981534424376f, + 0.002761727219457103f, + 0.001661437823975322f, + -0.000402092792444196f, + -0.002320119390193667f, + -0.003178340139233828f, + -0.002682865592015316f, + -0.001233491421169468f, + 0.000346781210023729f, + 0.001252059507347206f, + 0.001072157673911288f, + -0.000060142418430366f, + -0.001589296551711622f, + -0.002830930204582274f, + -0.003280737659419560f, + -0.002799173360323900f, + -0.001612840277093291f, + -0.000165599354540670f, + 0.001088358238163842f, + 0.001851476423100084f, + 0.002050805379425780f, + 0.001803932401530970f, + 0.001323484844111109f, + 0.000815488719349860f, + 0.000413474829003805f, + 0.000162480875041441f, + 0.000042167047949931f +}; + +static const int d_8_r_8_len = 280; +static const float d_8_r_8_kernel[] = +{ + 0.000005299484859782f, + 0.000023653198869943f, + 0.000045443155025411f, + 0.000086660616597102f, + 0.000145468147843215f, + 0.000227646032445337f, + 0.000334591194217999f, + 0.000466890457500183f, + 0.000622018386430552f, + 0.000794466626663634f, + 0.000975304575250323f, + 0.001152454785657775f, + 0.001311296864337127f, + 0.001435783630074849f, + 0.001509953148215840f, + 0.001519741581366084f, + 0.001454903824191261f, + 0.001310813201213376f, + 0.001089882810057675f, + 0.000802361759738747f, + 0.000466304093914126f, + 0.000106589241438445f, + -0.000247017317721992f, + -0.000562646941659305f, + -0.000809708828030606f, + -0.000962510996013040f, + -0.001003685261621032f, + -0.000926952775265634f, + -0.000738799897838057f, + -0.000458730744403599f, + -0.000117916487516219f, + 0.000243742648939376f, + 0.000581911777806535f, + 0.000853035291692318f, + 0.001019866746633974f, + 0.001056611000192218f, + 0.000952962453331239f, + 0.000716408838645576f, + 0.000372351073038558f, + -0.000038150274869667f, + -0.000462881782404900f, + -0.000844797294892937f, + -0.001129425716907750f, + -0.001272432677940103f, + -0.001246307890160262f, + -0.001045192378203970f, + -0.000687044203214210f, + -0.000212653183490116f, + 0.000318579724580746f, + 0.000835734644546107f, + 0.001265542439063603f, + 0.001542487733459282f, + 0.001618487960413105f, + 0.001470755262270050f, + 0.001106608046232222f, + 0.000564346197878288f, + -0.000090197750452171f, + -0.000771230463597417f, + -0.001383890554706424f, + -0.001837132239362339f, + -0.002056896211703681f, + -0.001997709076123834f, + -0.001650953765714851f, + -0.001048413504576680f, + -0.000260276733547870f, + 0.000612469118131840f, + 0.001450527381084600f, + 0.002132190093380017f, + 0.002550584440683641f, + 0.002629881881769309f, + 0.002338080196576415f, + 0.001694308341293216f, + 0.000769260408641065f, + -0.000321736170028782f, + -0.001432485915523021f, + -0.002404976322971185f, + -0.003091310085438950f, + -0.003375549372556256f, + -0.003192330168178722f, + -0.002539372888669491f, + -0.001481713556478757f, + -0.000146533823587781f, + 0.001291251516558131f, + 0.002631154368260663f, + 0.003674321213032700f, + 0.004252198884660451f, + 0.004252637433548458f, + 0.003639528435255283f, + 0.002462762274858131f, + 0.000856475239499534f, + -0.000974892854265319f, + -0.002781496880057425f, + -0.004301065594668099f, + -0.005295755541230454f, + -0.005587859925192526f, + -0.005089203765495300f, + -0.003819632950038145f, + -0.001911267954229858f, + 0.000402995000090862f, + 0.002816115056235722f, + 0.004985868963592199f, + 0.006581423530514738f, + 0.007331423828496663f, + 0.007066900231758860f, + 0.005752595831756849f, + 0.003501526672561130f, + 0.000569595914029656f, + -0.002670342281476470f, + -0.005772755486290897f, + -0.008277141861910673f, + -0.009772095428011296f, + -0.009957304065452081f, + -0.008694779007964944f, + -0.006041501906687299f, + -0.002257673645446692f, + 0.002212348869418207f, + 0.006785874581560984f, + 0.010810304734210376f, + 0.013646746123386143f, + 0.014758915386036504f, + 0.013796112346034117f, + 0.010659097540521932f, + 0.005539210274923477f, + -0.001076115841043161f, + -0.008434444147245189f, + -0.015584625308516726f, + -0.021472430244782261f, + -0.025055744331654087f, + -0.025426655616721288f, + -0.021926322954481325f, + -0.014238733805135361f, + -0.002451384366749276f, + 0.012925647002682830f, + 0.030986186274100380f, + 0.050498778538203032f, + 0.070015421670629074f, + 0.088007266252761618f, + 0.103012981470773550f, + 0.113783757663955240f, + 0.119409036455313980f, + 0.119409036455313980f, + 0.113783757663955240f, + 0.103012981470773550f, + 0.088007266252761618f, + 0.070015421670629074f, + 0.050498778538203032f, + 0.030986186274100380f, + 0.012925647002682830f, + -0.002451384366749276f, + -0.014238733805135361f, + -0.021926322954481325f, + -0.025426655616721288f, + -0.025055744331654087f, + -0.021472430244782261f, + -0.015584625308516726f, + -0.008434444147245189f, + -0.001076115841043161f, + 0.005539210274923477f, + 0.010659097540521932f, + 0.013796112346034117f, + 0.014758915386036504f, + 0.013646746123386143f, + 0.010810304734210376f, + 0.006785874581560984f, + 0.002212348869418207f, + -0.002257673645446692f, + -0.006041501906687299f, + -0.008694779007964944f, + -0.009957304065452081f, + -0.009772095428011296f, + -0.008277141861910673f, + -0.005772755486290897f, + -0.002670342281476470f, + 0.000569595914029656f, + 0.003501526672561130f, + 0.005752595831756849f, + 0.007066900231758860f, + 0.007331423828496663f, + 0.006581423530514738f, + 0.004985868963592199f, + 0.002816115056235722f, + 0.000402995000090862f, + -0.001911267954229858f, + -0.003819632950038145f, + -0.005089203765495300f, + -0.005587859925192526f, + -0.005295755541230454f, + -0.004301065594668099f, + -0.002781496880057425f, + -0.000974892854265319f, + 0.000856475239499534f, + 0.002462762274858131f, + 0.003639528435255283f, + 0.004252637433548458f, + 0.004252198884660451f, + 0.003674321213032700f, + 0.002631154368260663f, + 0.001291251516558131f, + -0.000146533823587781f, + -0.001481713556478757f, + -0.002539372888669491f, + -0.003192330168178722f, + -0.003375549372556256f, + -0.003091310085438950f, + -0.002404976322971185f, + -0.001432485915523021f, + -0.000321736170028782f, + 0.000769260408641065f, + 0.001694308341293216f, + 0.002338080196576415f, + 0.002629881881769309f, + 0.002550584440683641f, + 0.002132190093380017f, + 0.001450527381084600f, + 0.000612469118131840f, + -0.000260276733547870f, + -0.001048413504576680f, + -0.001650953765714851f, + -0.001997709076123834f, + -0.002056896211703681f, + -0.001837132239362339f, + -0.001383890554706424f, + -0.000771230463597417f, + -0.000090197750452171f, + 0.000564346197878288f, + 0.001106608046232222f, + 0.001470755262270050f, + 0.001618487960413105f, + 0.001542487733459282f, + 0.001265542439063603f, + 0.000835734644546107f, + 0.000318579724580746f, + -0.000212653183490116f, + -0.000687044203214210f, + -0.001045192378203970f, + -0.001246307890160262f, + -0.001272432677940103f, + -0.001129425716907750f, + -0.000844797294892937f, + -0.000462881782404900f, + -0.000038150274869667f, + 0.000372351073038558f, + 0.000716408838645576f, + 0.000952962453331239f, + 0.001056611000192218f, + 0.001019866746633974f, + 0.000853035291692318f, + 0.000581911777806535f, + 0.000243742648939376f, + -0.000117916487516219f, + -0.000458730744403599f, + -0.000738799897838057f, + -0.000926952775265634f, + -0.001003685261621032f, + -0.000962510996013040f, + -0.000809708828030606f, + -0.000562646941659305f, + -0.000247017317721992f, + 0.000106589241438445f, + 0.000466304093914126f, + 0.000802361759738747f, + 0.001089882810057675f, + 0.001310813201213376f, + 0.001454903824191261f, + 0.001519741581366084f, + 0.001509953148215840f, + 0.001435783630074849f, + 0.001311296864337127f, + 0.001152454785657775f, + 0.000975304575250323f, + 0.000794466626663634f, + 0.000622018386430552f, + 0.000466890457500183f, + 0.000334591194217999f, + 0.000227646032445337f, + 0.000145468147843215f, + 0.000086660616597102f, + 0.000045443155025411f, + 0.000023653198869943f, + 0.000005299484859782f +}; + +static const int d_16_r_8_len = 54; +static const float d_16_r_8_kernel[] = +{ + -0.000010553664672862f, + -0.000061498701563991f, + -0.000169601122616288f, + -0.000389180581238296f, + -0.000769984128346191f, + -0.001370862255977838f, + -0.002239657737237394f, + -0.003399895346870093f, + -0.004830710741492023f, + -0.006448450828431843f, + -0.008091858901382079f, + -0.009515843884697457f, + -0.010397443295914180f, + -0.010356613550454467f, + -0.008992200646607676f, + -0.005930785604319544f, + -0.000883275448312690f, + 0.006298249742162992f, + 0.015572313369334116f, + 0.026677316967261836f, + 0.039125602626276818f, + 0.052226529544645239f, + 0.065138652777540620f, + 0.076946528099683636f, + 0.086753462256061120f, + 0.093778457566739207f, + 0.097444274566674538f, + 0.097444274566674538f, + 0.093778457566739207f, + 0.086753462256061120f, + 0.076946528099683636f, + 0.065138652777540620f, + 0.052226529544645239f, + 0.039125602626276818f, + 0.026677316967261836f, + 0.015572313369334116f, + 0.006298249742162992f, + -0.000883275448312690f, + -0.005930785604319544f, + -0.008992200646607676f, + -0.010356613550454467f, + -0.010397443295914180f, + -0.009515843884697457f, + -0.008091858901382079f, + -0.006448450828431843f, + -0.004830710741492023f, + -0.003399895346870093f, + -0.002239657737237394f, + -0.001370862255977838f, + -0.000769984128346191f, + -0.000389180581238296f, + -0.000169601122616288f, + -0.000061498701563991f, + -0.000010553664672862f +}; + +static const int d_32_r_16_len = 107; +static const float d_32_r_16_kernel[] = +{ + -0.000004024163639795f, + -0.000017672975608646f, + -0.000028369983125930f, + -0.000051841257358260f, + -0.000084114931088978f, + -0.000130374705334955f, + -0.000193165706690690f, + -0.000276282392544972f, + -0.000383294466797586f, + -0.000517836385761646f, + -0.000683246849920059f, + -0.000882378788952720f, + -0.001117308161626894f, + -0.001389043294976996f, + -0.001697213461428019f, + -0.002039760314912465f, + -0.002412643435722481f, + -0.002809577646098091f, + -0.003221818992095683f, + -0.003638016956253216f, + -0.004044149516577933f, + -0.004423556043039536f, + -0.004757080371798020f, + -0.005023332869090757f, + -0.005199075945795754f, + -0.005259732456805450f, + -0.005180010907146506f, + -0.004934635615957972f, + -0.004499164222082719f, + -0.003850869437258024f, + -0.002969657050308204f, + -0.001838988139263688f, + -0.000446770521598867f, + 0.001213817123243464f, + 0.003143605116121320f, + 0.005336851770962665f, + 0.007780833517050342f, + 0.010455633416035585f, + 0.013334149150643793f, + 0.016382334116677784f, + 0.019559676833852839f, + 0.022819914826782396f, + 0.026111969807273771f, + 0.029381081811115123f, + 0.032570111325119062f, + 0.035620970792186964f, + 0.038476140562399175f, + 0.041080219701286683f, + 0.043381459308086866f, + 0.045333225316341701f, + 0.046895339212960678f, + 0.048035248704517766f, + 0.048728985952954711f, + 0.048961878385199747f, + 0.048728985952954711f, + 0.048035248704517766f, + 0.046895339212960678f, + 0.045333225316341701f, + 0.043381459308086866f, + 0.041080219701286683f, + 0.038476140562399175f, + 0.035620970792186964f, + 0.032570111325119062f, + 0.029381081811115123f, + 0.026111969807273771f, + 0.022819914826782396f, + 0.019559676833852839f, + 0.016382334116677784f, + 0.013334149150643793f, + 0.010455633416035585f, + 0.007780833517050342f, + 0.005336851770962665f, + 0.003143605116121320f, + 0.001213817123243464f, + -0.000446770521598867f, + -0.001838988139263688f, + -0.002969657050308204f, + -0.003850869437258024f, + -0.004499164222082719f, + -0.004934635615957972f, + -0.005180010907146506f, + -0.005259732456805450f, + -0.005199075945795754f, + -0.005023332869090757f, + -0.004757080371798020f, + -0.004423556043039536f, + -0.004044149516577933f, + -0.003638016956253216f, + -0.003221818992095683f, + -0.002809577646098091f, + -0.002412643435722481f, + -0.002039760314912465f, + -0.001697213461428019f, + -0.001389043294976996f, + -0.001117308161626894f, + -0.000882378788952720f, + -0.000683246849920059f, + -0.000517836385761646f, + -0.000383294466797586f, + -0.000276282392544972f, + -0.000193165706690690f, + -0.000130374705334955f, + -0.000084114931088978f, + -0.000051841257358260f, + -0.000028369983125930f, + -0.000017672975608646f, + -0.000004024163639795f +}; + +static const int d_64_r_32_len = 212; +static const float d_64_r_32_kernel[] = +{ + -0.000004403823942508f, + -0.000008963059919890f, + -0.000007276052892980f, + -0.000013448546764569f, + -0.000016407338246392f, + -0.000022821877811828f, + -0.000029059859493782f, + -0.000037502053326083f, + -0.000047050128769168f, + -0.000058647705667398f, + -0.000072066821233235f, + -0.000087775432302674f, + -0.000105848488644829f, + -0.000126598475702349f, + -0.000150205141042045f, + -0.000176926965601505f, + -0.000206973701715915f, + -0.000240575602493366f, + -0.000277937749971926f, + -0.000319260777052827f, + -0.000364722541989086f, + -0.000414482134953896f, + -0.000468670554403767f, + -0.000527388854339363f, + -0.000590701722925615f, + -0.000658633566464172f, + -0.000731163061150287f, + -0.000808218604975926f, + -0.000889673345622962f, + -0.000975340650633742f, + -0.001064969616730599f, + -0.001158240957389821f, + -0.001254763178484453f, + -0.001354069203096897f, + -0.001455613461052586f, + -0.001558769541846508f, + -0.001662828458596891f, + -0.001766997597152117f, + -0.001870400403116935f, + -0.001972076865069115f, + -0.002070984841172726f, + -0.002166002272448999f, + -0.002255930317598858f, + -0.002339497436442704f, + -0.002415364439683740f, + -0.002482130514177367f, + -0.002538340220525754f, + -0.002582491452580508f, + -0.002613044332960035f, + -0.002628431011812668f, + -0.002627066321370591f, + -0.002607359228695053f, + -0.002567725018271331f, + -0.002506598123060911f, + -0.002422445514576562f, + -0.002313780550524778f, + -0.002179177170034060f, + -0.002017284317828416f, + -0.001826840471286680f, + -0.001606688137875605f, + -0.001355788185007890f, + -0.001073233860638388f, + -0.000758264360902667f, + -0.000410277798843436f, + -0.000028843430628706f, + 0.000386287004249912f, + 0.000835168966487215f, + 0.001317655958647924f, + 0.001833391650175865f, + 0.002381803404668191f, + 0.002962097316406667f, + 0.003573254853063226f, + 0.004214031187543062f, + 0.004882955288187807f, + 0.005578331822331469f, + 0.006298244909815173f, + 0.007040563748502659f, + 0.007802950114525442f, + 0.008582867722817980f, + 0.009377593413961051f, + 0.010184230117287451f, + 0.010999721518727896f, + 0.011820868346749476f, + 0.012644346170734195f, + 0.013466724590201118f, + 0.014284487677241258f, + 0.015094055520281103f, + 0.015891806704001060f, + 0.016674101548252919f, + 0.017437305919088521f, + 0.018177815416425963f, + 0.018892079736813970f, + 0.019576627004361302f, + 0.020228087861972253f, + 0.020843219113185100f, + 0.021418926707647539f, + 0.021952287867040517f, + 0.022440572154110033f, + 0.022881261295670835f, + 0.023272067580484536f, + 0.023610950665041715f, + 0.023896132633698622f, + 0.024126111175283287f, + 0.024299670755100852f, + 0.024415891678976044f, + 0.024474156966027200f, + 0.024474156966027200f, + 0.024415891678976044f, + 0.024299670755100852f, + 0.024126111175283287f, + 0.023896132633698622f, + 0.023610950665041715f, + 0.023272067580484536f, + 0.022881261295670835f, + 0.022440572154110033f, + 0.021952287867040517f, + 0.021418926707647539f, + 0.020843219113185100f, + 0.020228087861972253f, + 0.019576627004361302f, + 0.018892079736813970f, + 0.018177815416425963f, + 0.017437305919088521f, + 0.016674101548252919f, + 0.015891806704001060f, + 0.015094055520281103f, + 0.014284487677241258f, + 0.013466724590201118f, + 0.012644346170734195f, + 0.011820868346749476f, + 0.010999721518727896f, + 0.010184230117287451f, + 0.009377593413961051f, + 0.008582867722817980f, + 0.007802950114525442f, + 0.007040563748502659f, + 0.006298244909815173f, + 0.005578331822331469f, + 0.004882955288187807f, + 0.004214031187543062f, + 0.003573254853063226f, + 0.002962097316406667f, + 0.002381803404668191f, + 0.001833391650175865f, + 0.001317655958647924f, + 0.000835168966487215f, + 0.000386287004249912f, + -0.000028843430628706f, + -0.000410277798843436f, + -0.000758264360902667f, + -0.001073233860638388f, + -0.001355788185007890f, + -0.001606688137875605f, + -0.001826840471286680f, + -0.002017284317828416f, + -0.002179177170034060f, + -0.002313780550524778f, + -0.002422445514576562f, + -0.002506598123060911f, + -0.002567725018271331f, + -0.002607359228695053f, + -0.002627066321370591f, + -0.002628431011812668f, + -0.002613044332960035f, + -0.002582491452580508f, + -0.002538340220525754f, + -0.002482130514177367f, + -0.002415364439683740f, + -0.002339497436442704f, + -0.002255930317598858f, + -0.002166002272448999f, + -0.002070984841172726f, + -0.001972076865069115f, + -0.001870400403116935f, + -0.001766997597152117f, + -0.001662828458596891f, + -0.001558769541846508f, + -0.001455613461052586f, + -0.001354069203096897f, + -0.001254763178484453f, + -0.001158240957389821f, + -0.001064969616730599f, + -0.000975340650633742f, + -0.000889673345622962f, + -0.000808218604975926f, + -0.000731163061150287f, + -0.000658633566464172f, + -0.000590701722925615f, + -0.000527388854339363f, + -0.000468670554403767f, + -0.000414482134953896f, + -0.000364722541989086f, + -0.000319260777052827f, + -0.000277937749971926f, + -0.000240575602493366f, + -0.000206973701715915f, + -0.000176926965601505f, + -0.000150205141042045f, + -0.000126598475702349f, + -0.000105848488644829f, + -0.000087775432302674f, + -0.000072066821233235f, + -0.000058647705667398f, + -0.000047050128769168f, + -0.000037502053326083f, + -0.000029059859493782f, + -0.000022821877811828f, + -0.000016407338246392f, + -0.000013448546764569f, + -0.000007276052892980f, + -0.000008963059919890f, + -0.000004403823942508f +}; + +static const int d_128_r_32_len = 174; +static const float d_128_r_32_kernel[] = +{ + -0.000007703161797332f, + -0.000007067232655723f, + -0.000010206071983051f, + -0.000014172048980291f, + -0.000019092331824095f, + -0.000025093561850217f, + -0.000032309725460887f, + -0.000040869410108629f, + -0.000050902771287247f, + -0.000062527941809152f, + -0.000075857080877625f, + -0.000090981984892608f, + -0.000107979276021387f, + -0.000126895337525829f, + -0.000147750778600044f, + -0.000170524898241214f, + -0.000195159646270053f, + -0.000221543901544016f, + -0.000249517228886741f, + -0.000278854334896464f, + -0.000309268991706370f, + -0.000340399096744052f, + -0.000371811190567229f, + -0.000402986592324930f, + -0.000433326971103446f, + -0.000462142048725246f, + -0.000488656689255886f, + -0.000512000649038707f, + -0.000531217622524194f, + -0.000545257474301118f, + -0.000552987616398289f, + -0.000553188077307909f, + -0.000544565488882758f, + -0.000525751232639430f, + -0.000495318184744208f, + -0.000451782034515639f, + -0.000393620779029084f, + -0.000319279140356296f, + -0.000227190622760720f, + -0.000115784771504684f, + 0.000016488581452787f, + 0.000171149664304299f, + 0.000349662890884785f, + 0.000553425442457719f, + 0.000783740497411292f, + 0.001041804838025221f, + 0.001328682064289453f, + 0.001645290145967291f, + 0.001992375608565783f, + 0.002370502036550272f, + 0.002780026279675712f, + 0.003221088947286086f, + 0.003693593686280741f, + 0.004197200680900796f, + 0.004731309996663634f, + 0.005295059011515552f, + 0.005887310701543637f, + 0.006506655780921748f, + 0.007151406625936390f, + 0.007819604696828528f, + 0.008509020566706571f, + 0.009217166946123657f, + 0.009941305011649831f, + 0.010678463067957514f, + 0.011425449071796635f, + 0.012178874660574504f, + 0.012935173457761552f, + 0.013690629889370804f, + 0.014441402554104810f, + 0.015183556958199267f, + 0.015913092956531424f, + 0.016625980278750660f, + 0.017318188813430120f, + 0.017985725593062503f, + 0.018624666516886546f, + 0.019231193320663705f, + 0.019801625228558870f, + 0.020332454367773867f, + 0.020820375812973399f, + 0.021262319920613983f, + 0.021655479285054610f, + 0.021997336565315176f, + 0.022285687008084795f, + 0.022518660515178174f, + 0.022694738600454345f, + 0.022812769691468757f, + 0.022871979661449618f, + 0.022871979661449618f, + 0.022812769691468757f, + 0.022694738600454345f, + 0.022518660515178174f, + 0.022285687008084795f, + 0.021997336565315176f, + 0.021655479285054610f, + 0.021262319920613983f, + 0.020820375812973399f, + 0.020332454367773867f, + 0.019801625228558870f, + 0.019231193320663705f, + 0.018624666516886546f, + 0.017985725593062503f, + 0.017318188813430120f, + 0.016625980278750660f, + 0.015913092956531424f, + 0.015183556958199267f, + 0.014441402554104810f, + 0.013690629889370804f, + 0.012935173457761552f, + 0.012178874660574504f, + 0.011425449071796635f, + 0.010678463067957514f, + 0.009941305011649831f, + 0.009217166946123657f, + 0.008509020566706571f, + 0.007819604696828528f, + 0.007151406625936390f, + 0.006506655780921748f, + 0.005887310701543637f, + 0.005295059011515552f, + 0.004731309996663634f, + 0.004197200680900796f, + 0.003693593686280741f, + 0.003221088947286086f, + 0.002780026279675712f, + 0.002370502036550272f, + 0.001992375608565783f, + 0.001645290145967291f, + 0.001328682064289453f, + 0.001041804838025221f, + 0.000783740497411292f, + 0.000553425442457719f, + 0.000349662890884785f, + 0.000171149664304299f, + 0.000016488581452787f, + -0.000115784771504684f, + -0.000227190622760720f, + -0.000319279140356296f, + -0.000393620779029084f, + -0.000451782034515639f, + -0.000495318184744208f, + -0.000525751232639430f, + -0.000544565488882758f, + -0.000553188077307909f, + -0.000552987616398289f, + -0.000545257474301118f, + -0.000531217622524194f, + -0.000512000649038707f, + -0.000488656689255886f, + -0.000462142048725246f, + -0.000433326971103446f, + -0.000402986592324930f, + -0.000371811190567229f, + -0.000340399096744052f, + -0.000309268991706370f, + -0.000278854334896464f, + -0.000249517228886741f, + -0.000221543901544016f, + -0.000195159646270053f, + -0.000170524898241214f, + -0.000147750778600044f, + -0.000126895337525829f, + -0.000107979276021387f, + -0.000090981984892608f, + -0.000075857080877625f, + -0.000062527941809152f, + -0.000050902771287247f, + -0.000040869410108629f, + -0.000032309725460887f, + -0.000025093561850217f, + -0.000019092331824095f, + -0.000014172048980291f, + -0.000010206071983051f, + -0.000007067232655723f, + -0.000007703161797332f +}; + +static const int d_256_r_64_len = 348; +static const float d_256_r_64_kernel[] = +{ + -0.000006032200297229f, + -0.000002790586794678f, + -0.000003423524464373f, + -0.000004141892670381f, + -0.000004959329780957f, + -0.000005880953015414f, + -0.000006916263845337f, + -0.000008064028056128f, + -0.000009336504822940f, + -0.000010742797132820f, + -0.000012302324525658f, + -0.000014003128525449f, + -0.000015868003792231f, + -0.000017906061357310f, + -0.000020111369902626f, + -0.000022508204619172f, + -0.000025093613992638f, + -0.000027881953296601f, + -0.000030875236885189f, + -0.000034086060833210f, + -0.000037517497377010f, + -0.000041176665997414f, + -0.000045067469478981f, + -0.000049199353227621f, + -0.000053568215176887f, + -0.000058185242147041f, + -0.000063047547807853f, + -0.000068158618146586f, + -0.000073517650784389f, + -0.000079124725926570f, + -0.000084976788235246f, + -0.000091070103041806f, + -0.000097399649098627f, + -0.000103959504668590f, + -0.000110738977492950f, + -0.000117729935644196f, + -0.000124919754739577f, + -0.000132293212128623f, + -0.000139836270835869f, + -0.000147529334756596f, + -0.000155353239032747f, + -0.000163284378055491f, + -0.000171298895948762f, + -0.000179368841745378f, + -0.000187464129074148f, + -0.000195552549576070f, + -0.000203599379753965f, + -0.000211565351775375f, + -0.000219411598860001f, + -0.000227093646507866f, + -0.000234565855614429f, + -0.000241779257421431f, + -0.000248682177854843f, + -0.000255220180724547f, + -0.000261335292980978f, + -0.000266967862740791f, + -0.000272054419087176f, + -0.000276528686849870f, + -0.000280322370041046f, + -0.000283363923695878f, + -0.000285578633373008f, + -0.000286890694598539f, + -0.000287220112764771f, + -0.000286486063219693f, + -0.000284603980740463f, + -0.000281488659987540f, + -0.000277051522643753f, + -0.000271202733437524f, + -0.000263850662609383f, + -0.000254902132867105f, + -0.000244261829079865f, + -0.000231834561467387f, + -0.000217522684614226f, + -0.000201228717970838f, + -0.000182854056621652f, + -0.000162300101972573f, + -0.000139467943568298f, + -0.000114258627064630f, + -0.000086574168670878f, + -0.000056316612617103f, + -0.000023389083735015f, + 0.000012303734435184f, + 0.000050856088211618f, + 0.000092360432854175f, + 0.000136906695012963f, + 0.000184583050199368f, + 0.000235474395169584f, + 0.000289663252276950f, + 0.000347228091667187f, + 0.000408244468331575f, + 0.000472783700962668f, + 0.000540912739938505f, + 0.000612694289527581f, + 0.000688186201030564f, + 0.000767440808596336f, + 0.000850505496981770f, + 0.000937421598757782f, + 0.001028224584686942f, + 0.001122943571650730f, + 0.001221601170177604f, + 0.001324213422447449f, + 0.001430788817328081f, + 0.001541329271676986f, + 0.001655828820474164f, + 0.001774273932442011f, + 0.001896643321221287f, + 0.002022907760579356f, + 0.002153029565104709f, + 0.002286963138555204f, + 0.002424654105591249f, + 0.002566039990527927f, + 0.002711049190015392f, + 0.002859602052878106f, + 0.003011609882021581f, + 0.003166975340851216f, + 0.003325592606007947f, + 0.003487347156138999f, + 0.003652115769225347f, + 0.003819766988190932f, + 0.003990160791661657f, + 0.004163149004759460f, + 0.004338575232032592f, + 0.004516275281704776f, + 0.004696077226065694f, + 0.004877801369702575f, + 0.005061261175365414f, + 0.005246262760259225f, + 0.005432605634097002f, + 0.005620082968897619f, + 0.005808481837004595f, + 0.005997583515661679f, + 0.006187164045980849f, + 0.006376994441064236f, + 0.006566841257680600f, + 0.006756466702660143f, + 0.006945629644096785f, + 0.007134085474240178f, + 0.007321586857189369f, + 0.007507884388699728f, + 0.007692726710717013f, + 0.007875861286146892f, + 0.008057034853723447f, + 0.008235993962285608f, + 0.008412485423992495f, + 0.008586256905270668f, + 0.008757057550423931f, + 0.008924638381879985f, + 0.009088752763977616f, + 0.009249157391806035f, + 0.009405612190690901f, + 0.009557881349450560f, + 0.009705733651032743f, + 0.009848943025250930f, + 0.009987289003226731f, + 0.010120557317645952f, + 0.010248540384643352f, + 0.010371037696321509f, + 0.010487856281889540f, + 0.010598811426250850f, + 0.010703726661456589f, + 0.010802434494593470f, + 0.010894776824678817f, + 0.010980605060844476f, + 0.011059780725514858f, + 0.011132175645830765f, + 0.011197672374601442f, + 0.011256164283833567f, + 0.011307555970121824f, + 0.011351763540287503f, + 0.011388714558166329f, + 0.011418348423280301f, + 0.011440616600089638f, + 0.011455482402780947f, + 0.011462921415360990f, + 0.011462921415360990f, + 0.011455482402780947f, + 0.011440616600089638f, + 0.011418348423280301f, + 0.011388714558166329f, + 0.011351763540287503f, + 0.011307555970121824f, + 0.011256164283833567f, + 0.011197672374601442f, + 0.011132175645830765f, + 0.011059780725514858f, + 0.010980605060844476f, + 0.010894776824678817f, + 0.010802434494593470f, + 0.010703726661456589f, + 0.010598811426250850f, + 0.010487856281889540f, + 0.010371037696321509f, + 0.010248540384643352f, + 0.010120557317645952f, + 0.009987289003226731f, + 0.009848943025250930f, + 0.009705733651032743f, + 0.009557881349450560f, + 0.009405612190690901f, + 0.009249157391806035f, + 0.009088752763977616f, + 0.008924638381879985f, + 0.008757057550423931f, + 0.008586256905270668f, + 0.008412485423992495f, + 0.008235993962285608f, + 0.008057034853723447f, + 0.007875861286146892f, + 0.007692726710717013f, + 0.007507884388699728f, + 0.007321586857189369f, + 0.007134085474240178f, + 0.006945629644096785f, + 0.006756466702660143f, + 0.006566841257680600f, + 0.006376994441064236f, + 0.006187164045980849f, + 0.005997583515661679f, + 0.005808481837004595f, + 0.005620082968897619f, + 0.005432605634097002f, + 0.005246262760259225f, + 0.005061261175365414f, + 0.004877801369702575f, + 0.004696077226065694f, + 0.004516275281704776f, + 0.004338575232032592f, + 0.004163149004759460f, + 0.003990160791661657f, + 0.003819766988190932f, + 0.003652115769225347f, + 0.003487347156138999f, + 0.003325592606007947f, + 0.003166975340851216f, + 0.003011609882021581f, + 0.002859602052878106f, + 0.002711049190015392f, + 0.002566039990527927f, + 0.002424654105591249f, + 0.002286963138555204f, + 0.002153029565104709f, + 0.002022907760579356f, + 0.001896643321221287f, + 0.001774273932442011f, + 0.001655828820474164f, + 0.001541329271676986f, + 0.001430788817328081f, + 0.001324213422447449f, + 0.001221601170177604f, + 0.001122943571650730f, + 0.001028224584686942f, + 0.000937421598757782f, + 0.000850505496981770f, + 0.000767440808596336f, + 0.000688186201030564f, + 0.000612694289527581f, + 0.000540912739938505f, + 0.000472783700962668f, + 0.000408244468331575f, + 0.000347228091667187f, + 0.000289663252276950f, + 0.000235474395169584f, + 0.000184583050199368f, + 0.000136906695012963f, + 0.000092360432854175f, + 0.000050856088211618f, + 0.000012303734435184f, + -0.000023389083735015f, + -0.000056316612617103f, + -0.000086574168670878f, + -0.000114258627064630f, + -0.000139467943568298f, + -0.000162300101972573f, + -0.000182854056621652f, + -0.000201228717970838f, + -0.000217522684614226f, + -0.000231834561467387f, + -0.000244261829079865f, + -0.000254902132867105f, + -0.000263850662609383f, + -0.000271202733437524f, + -0.000277051522643753f, + -0.000281488659987540f, + -0.000284603980740463f, + -0.000286486063219693f, + -0.000287220112764771f, + -0.000286890694598539f, + -0.000285578633373008f, + -0.000283363923695878f, + -0.000280322370041046f, + -0.000276528686849870f, + -0.000272054419087176f, + -0.000266967862740791f, + -0.000261335292980978f, + -0.000255220180724547f, + -0.000248682177854843f, + -0.000241779257421431f, + -0.000234565855614429f, + -0.000227093646507866f, + -0.000219411598860001f, + -0.000211565351775375f, + -0.000203599379753965f, + -0.000195552549576070f, + -0.000187464129074148f, + -0.000179368841745378f, + -0.000171298895948762f, + -0.000163284378055491f, + -0.000155353239032747f, + -0.000147529334756596f, + -0.000139836270835869f, + -0.000132293212128623f, + -0.000124919754739577f, + -0.000117729935644196f, + -0.000110738977492950f, + -0.000103959504668590f, + -0.000097399649098627f, + -0.000091070103041806f, + -0.000084976788235246f, + -0.000079124725926570f, + -0.000073517650784389f, + -0.000068158618146586f, + -0.000063047547807853f, + -0.000058185242147041f, + -0.000053568215176887f, + -0.000049199353227621f, + -0.000045067469478981f, + -0.000041176665997414f, + -0.000037517497377010f, + -0.000034086060833210f, + -0.000030875236885189f, + -0.000027881953296601f, + -0.000025093613992638f, + -0.000022508204619172f, + -0.000020111369902626f, + -0.000017906061357310f, + -0.000015868003792231f, + -0.000014003128525449f, + -0.000012302324525658f, + -0.000010742797132820f, + -0.000009336504822940f, + -0.000008064028056128f, + -0.000006916263845337f, + -0.000005880953015414f, + -0.000004959329780957f, + -0.000004141892670381f, + -0.000003423524464373f, + -0.000002790586794678f, + -0.000006032200297229f +}; + diff --git a/code/Decoder/func_timer.h b/code/Decoder/func_timer.h new file mode 100644 index 0000000..0347f72 --- /dev/null +++ b/code/Decoder/func_timer.h @@ -0,0 +1,142 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +// fancy decorator to measure execution time + +// #if defined(__cpp_decltype_auto) +#if 0 +#define FUNC_TIMER 1 + +#include +#include +#include +#include + +//https://stackoverflow.com/questions/28498852/c-function-decorator/33642149 + + +namespace habdec +{ + + +template +struct RetWrapper +{ + template + RetWrapper(Tfunc &&func, Targs &&... args) + : val(std::forward(func)(std::forward(args)...)) {} + + //T&& value() { return std::move(val); } + T value() { return val; } + + +private: + T val; +}; + + +template <> +struct RetWrapper +{ + template + RetWrapper(Tfunc &&func, Targs &&... args) + { + std::forward(func)(std::forward(args)...); + } + + void value() {} +}; + + + +//template +template +//auto decorate(Tfunc &&func, Tbefore &&before, Tafter &&after) +auto AddTimer(Tfunc&& func, std::string name) +{ + return [ + func = std::forward(func), + name + //before = std::forward(before), + //after = std::forward(after) + ] (auto&& ... args) -> decltype(auto) + { + //before(std::forward(args)...); + + using namespace std; + typedef chrono::microseconds DurT; + static int count = 0; + static DurT dur_min = DurT::max(); + static DurT dur_max = DurT::min(); + static DurT dur_sum = DurT::zero(); + static auto time_start = chrono::high_resolution_clock::now(); + + auto _start = chrono::high_resolution_clock::now(); + //////////////////////////////////////////////////////////// + RetWrapper> ret( + func, std::forward(args)... + ); + //////////////////////////////////////////////////////////// + auto _end = chrono::high_resolution_clock::now(); + + DurT _duration = chrono::duration_cast(_end - _start); + ++count; + dur_sum += _duration; + if(_duration < dur_min) + dur_min = _duration; + if(_duration > dur_max) + dur_max = _duration; + + if( chrono::duration_cast( + chrono::high_resolution_clock::now() - time_start).count() >= 1000 + ) + { + DurT avg = dur_sum / count; + +#define FUNC_TIMER_NO_PRINT 1 +#if !defined(FUNC_TIMER_NO_PRINT) + cout<(args)...); + + // does not work if return directly + return ret.value(); + //auto result = ret.value(); + //return result; + }; +} + + +} // namespace habdec + +#endif //#if defined(__cpp_nontype_template_parameter_auto) diff --git a/code/Decoder/habdec_windows.h b/code/Decoder/habdec_windows.h new file mode 100644 index 0000000..a2471bd --- /dev/null +++ b/code/Decoder/habdec_windows.h @@ -0,0 +1,53 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include + + +template +inline T_flt_ sinc(T_flt_ x) +{ + if(x) + return sin(x)/x; + else + return 1; +} + + +template // float like types... +inline T_flt_ BlackmanHarris(const size_t x, const size_t N) +{ + static const T_flt_ a0 = 0.35874; + static const T_flt_ a1 = 0.48829; + static const T_flt_ a2 = 0.14128; + static const T_flt_ a3 = 0.01168; + static const T_flt_ PI2 = 2.0*M_PI; + static const T_flt_ PI4 = 4.0*M_PI; + static const T_flt_ PI6 = 6.0*M_PI; + + const T_flt_ N_1 = N-1; + + T_flt_ w = a0 - a1*cos(PI2*x / N_1) + a2*cos(PI4*x / N_1) - a3*cos(PI6*x / N_1); + + return w; +} diff --git a/code/Decoder/print_habhub_sentence.cpp b/code/Decoder/print_habhub_sentence.cpp new file mode 100644 index 0000000..f6755e3 --- /dev/null +++ b/code/Decoder/print_habhub_sentence.cpp @@ -0,0 +1,65 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#include "print_habhub_sentence.h" + +#include +#include +#include "CRC.h" +#include "common/console_colors.h" + + +namespace habdec +{ + + +void printHabhubSentence( + const std::string& callsign, + const std::string& data, + const std::string in_crc ) +{ + using namespace std; + + static int success = 0; + static int failure = 0; + + if( in_crc == CRC(callsign + string(",") + data) ) + { + cout<. +*/ + +#pragma once + +#include + +namespace habdec +{ + +void printHabhubSentence( + const std::string& callsign, + const std::string& data, + const std::string in_crc ); + +} // namespace habdec \ No newline at end of file diff --git a/code/Decoder/sentence_extract.cpp b/code/Decoder/sentence_extract.cpp new file mode 100644 index 0000000..481047c --- /dev/null +++ b/code/Decoder/sentence_extract.cpp @@ -0,0 +1,70 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#include "sentence_extract.h" + +#include + +namespace habdec +{ + +std::regex HABHUB_REGEX( R"_(.*?(\$+)([\w,\-]+?),(.+?)(\*|\$)(\w\w\w\w).*)_" ); + +std::map extractSentence(std::string stream) +{ + using namespace std; + + // replace '\n' in stream with spaces, otherwise regex will fail (C++ 11 issue) + replace( stream.begin(), stream.end(), '\n', ' '); + + map result; + result["success"] = string("ERR"); + + const int CRC_LEN = 4; // usually 4 chars after * + + if(stream.find("*") < string::npos-CRC_LEN) + { + smatch match; + regex_match(stream, match, HABHUB_REGEX); + + if(match.size() >= 5) + { + const string callsign = match[2]; + const string data = match[3]; + const string data_end = match[4]; // * or another $ + const string _crc = match[5]; + + const size_t cut = min( stream.size(), size_t(match.position(4)+CRC_LEN) ); + stream = stream.substr( cut ); + + result["success"] = string("OK"); + result["callsign"] = callsign; + result["data"] = data; + result["crc"] = _crc; + result["stream"] = stream; + + } + + } + + return result; +} + +} // namespace habdec diff --git a/code/Decoder/sentence_extract.h b/code/Decoder/sentence_extract.h new file mode 100644 index 0000000..e6ae579 --- /dev/null +++ b/code/Decoder/sentence_extract.h @@ -0,0 +1,34 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include +#include +#include + + +namespace habdec +{ + +std::map extractSentence(std::string i_str); + +} // namespace habdec \ No newline at end of file diff --git a/code/IQSource/CMakeLists.txt b/code/IQSource/CMakeLists.txt new file mode 100644 index 0000000..e65b53d --- /dev/null +++ b/code/IQSource/CMakeLists.txt @@ -0,0 +1,29 @@ + + +#include_directories( ${PROJECT_SOURCE_DIR} ) +include_directories( ${CMAKE_CURRENT_SOURCE_DIR} ) + + +find_package(SoapySDR REQUIRED) # this reverts CMAKE_CXX_STANDARD to '11' +#set ( CMAKE_CXX_STANDARD 17 ) +include_directories( ${SoapySDR_INCLUDE_DIRS} ) +message( "SoapySDR_INCLUDE_DIRS:" ${SoapySDR_INCLUDE_DIRS} ) +message( "SoapySDR_LIBRARIESL:" ${SoapySDR_LIBRARIES} ) + +# RTTY DECODER +set ( IQSource_src + IQSource_File.h + IQSource.h + IQSource_SoapySDR.h IQSource_SoapySDR.cpp + ) + + +if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU") + SET( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wshadow" ) + SET( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-class-memaccess" ) + SET( CMAKE_CXX_FLAGS " -O3 " ) +endif() + + +add_library( IQSource ${IQSource_src}) +target_link_libraries( IQSource ${SoapySDR_LIBRARIES} ) diff --git a/code/IQSource/IQSource.h b/code/IQSource/IQSource.h new file mode 100644 index 0000000..d6c9bec --- /dev/null +++ b/code/IQSource/IQSource.h @@ -0,0 +1,46 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include + +namespace habdec +{ + + +class IQSource +{ +public: + virtual bool init() = 0; + virtual bool start() = 0; + virtual bool stop() = 0; + virtual bool isRunning() const = 0; + virtual std::string type() const = 0; + virtual size_t count() const = 0; + virtual size_t get(void* p_data, const size_t i_count) = 0; + virtual double samplingRate() const = 0; + virtual bool setOption(const std::string& option, const void* p_data) = 0; + virtual bool getOption(const std::string& option, void* p_data) = 0; +}; + + +} // namespace habdec \ No newline at end of file diff --git a/code/IQSource/IQSource_File.h b/code/IQSource/IQSource_File.h new file mode 100644 index 0000000..bc40796 --- /dev/null +++ b/code/IQSource/IQSource_File.h @@ -0,0 +1,262 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include "IQSource.h" + +#include +#include +#include +#include +#include + +#include +#include + + +namespace habdec +{ + +template +class IQSource_File : public habdec::IQSource +{ +public: + typedef T TValue; + typedef std::complex TComplex; + + bool start(); + bool stop(); + bool isRunning() const; + size_t count() const; + size_t get(void* p_data, const size_t i_count); + std::string type() const {return std::string("File");}; + double samplingRate() const; + bool setOption(const std::string& option, const void* p_data); + bool getOption(const std::string& option, void* p_data); + + bool init(); + + ~IQSource_File(); + +private: + bool b_is_running_ = false; + bool b_is_realtime_ = true; + bool b_loop_ = false; + + std::ifstream file_handle_; + std::string file_path_; + + double sampling_rate_ = 0; + size_t count_ = 0; +}; + +} // namespace + + + +namespace +{ +std::ifstream::pos_type filesize(const char* filename) +{ + std::ifstream in(filename, std::ifstream::ate | std::ifstream::binary); + return in.tellg(); +} +} // namespace + +namespace habdec +{ + +template +bool IQSource_File::start() +{ + if(!file_handle_.is_open()) + return false; + b_is_running_ = true; + return true; +} + + +template +bool IQSource_File::stop() +{ + if(!file_handle_.is_open()) + return false; + b_is_running_ = true; + return true; +} + + +template +bool IQSource_File::isRunning() const +{ + if(!file_handle_.is_open()) + return false; + return b_is_running_; +} + + +template +size_t IQSource_File::count() const +{ + return count_; +} + + +template +size_t IQSource_File::get(void* p_data, const size_t i_count) +{ + using namespace std; + + if(!file_handle_.is_open()) + { + std::cout<<"file_handle_ == 0"<(p_data), min(i_count, count_) * sizeof(TComplex) ); + const size_t read_count = file_handle_.gcount() / sizeof(TComplex); + + if(!file_handle_) + { + if(read_count != i_count) + cout<<"IQSource_File::get() read less than desired: "<(wait) ); + } + + return read_count; +} + + +template +double IQSource_File::samplingRate() const +{ + return sampling_rate_; +} + + +template +IQSource_File::~IQSource_File() +{ + if(file_handle_) + { + stop(); + // fclose(file_handle_); + file_handle_.close(); + } +} + + +template +bool IQSource_File::init() +{ + count_ = filesize( file_path_.c_str() ) / sizeof(TComplex); + file_handle_.open( file_path_, std::ios::binary ); + if(!file_handle_.is_open()) + return false; + return true; +} + + +template +bool IQSource_File::setOption(const std::string& option, const void* p_data) +{ + void* p_data_nonconst = const_cast(p_data); + + if(option == "file_string") + { + file_path_ = *reinterpret_cast(p_data_nonconst); + } + if(option == "sampling_rate_double") + { + sampling_rate_ = *reinterpret_cast(p_data_nonconst); + } + else if(option == "realtime_bool") + { + b_is_realtime_ = *reinterpret_cast(p_data_nonconst); + } + else if(option == "loop_bool") + { + b_loop_ = *reinterpret_cast(p_data_nonconst); + } + else + { + std::cout<<"IQSource_File::setOption error. Unknown option: "< +bool IQSource_File::getOption(const std::string& option, void* p_data) +{ + if(option == "file_string") + { + *reinterpret_cast(p_data) = file_path_; + } + if(option == "sampling_rate_double") + { + *reinterpret_cast(p_data) = sampling_rate_; + } + else if(option == "realtime_bool") + { + *reinterpret_cast(p_data) = b_is_realtime_; + } + else if(option == "loop_bool") + { + *reinterpret_cast(p_data) = b_loop_; + } + else + { + std::cout<<"IQSource_File::getOption error. Unknown option: "<. +*/ + + +#include "IQSource_SoapySDR.h" + +#include +#include +#include +#include +#include +#include + +#include +#include +#include + +namespace habdec +{ + +bool IQSource_SoapySDR::start() +{ + if(!p_device_) + return false; + + int result = 0; + if(!b_is_running_) + result = p_device_->activateStream(p_stream_); + + if(result) + { + std::cout<<"IQSource_SoapySDR::start error. "<deactivateStream(p_stream_); + + if(result) + { + std::cout<<"IQSource_SoapySDR::stop error. "<(p_data) }; + int reveice_flags = 0; + long long time_ns = 0; + const int result = p_device_->readStream(p_stream_, buffs, i_count, reveice_flags, time_ns); + + if(result<0) + { + std::cout<<"IQSource_SoapySDR::get error."<(result); +} + + +double IQSource_SoapySDR::samplingRate() const +{ + return sampling_rate_; +} + + +IQSource_SoapySDR::~IQSource_SoapySDR() +{ + if(p_device_) + { + stop(); + p_device_->closeStream(p_stream_); + //SoapySDR::Device::unmake(p_device_.get()); + } +} + + +bool IQSource_SoapySDR::init() +{ + p_device_.reset( SoapySDR::Device::make(soapysdr_kwargs_) ); + + if(!p_device_) + return false; + + using namespace std; + + cout<<"IQSource_SoapySDR::init"<getDriverKey(); + cout<<'\t'<<"driver_key "<getHardwareKey(); + + const auto serial_it = soapysdr_kwargs_.find("serial"); + if(serial_it != soapysdr_kwargs_.end()) + hwinfo_serial_ = serial_it->second; + + // hw info + // cout<<'\t'<<"hw_info:"<getHardwareInfo(); + for(const auto& it : hw_info) + { + // cout<<"\t\tproperty:: "<listGains(SOAPY_SDR_RX,0)) + hwinfo_gains_.push_back(gain); + + // freq range + const SoapySDR::RangeList freq_range_list = p_device_->getFrequencyRange(SOAPY_SDR_RX, 0); + hwinfo_freq_min_ = freq_range_list.front().minimum(); + hwinfo_freq_max_ = freq_range_list.back().maximum(); + + // sampling rates + hwinfo_sampling_rates_ = p_device_->listSampleRates(SOAPY_SDR_RX, 0); + sort(hwinfo_sampling_rates_.begin(), hwinfo_sampling_rates_.end()); + + // stream formats + hwinfo_stream_formats_.clear(); + for(const auto stream_format : p_device_->getStreamFormats(SOAPY_SDR_RX, 0)) // doubles + hwinfo_stream_formats_.push_back(stream_format); + + // gain range + const SoapySDR::Range gain_range = p_device_->getGainRange(SOAPY_SDR_RX, 0); + hwinfo_gain_min_ = gain_range.minimum(); + hwinfo_gain_max_ = gain_range.maximum(); + + // init + + sampling_rate_ = hwinfo_sampling_rates_.back(); + if(hwinfo_hwkey_ != "Airspy") + sampling_rate_ = hwinfo_sampling_rates_[3]; + p_device_->setSampleRate(SOAPY_SDR_RX, 0, sampling_rate_); + + p_device_->setGain( SOAPY_SDR_RX, 0, (hwinfo_gain_max_ - hwinfo_gain_min_)/2 ); + p_device_->setFrequency( SOAPY_SDR_RX, 0, 434274500 ); + p_stream_ = p_device_->setupStream(SOAPY_SDR_RX, SOAPY_SDR_CF32); + + + // PRINT INFO + ///////////////// + + // hw info + cout<<'\t'<<"hw_key "<getFrontendMapping(SOAPY_SDR_RX)<listBandwidths(SOAPY_SDR_RX, 0)) // doubles + cout<hasDCOffsetMode(SOAPY_SDR_RX, 0)<hasFrequencyCorrection(SOAPY_SDR_RX, 0)<(p_data); + + bool b_verbose = false; + + if(option == "SoapySDR_Kwargs") + { + soapysdr_kwargs_ = *reinterpret_cast(p_data_nonconst); + return true; + } + + if(!p_device_) + { + cout<<"IQSource_SoapySDR::setOption no device initialized."<(p_data_nonconst); + cout<<"Setting "<setSampleRate(SOAPY_SDR_RX, 0, value); + sampling_rate_ = p_device_->getSampleRate(SOAPY_SDR_RX, 0); + cout<<"Set "<(p_data_nonconst); + if(p_device_) + { + if(b_verbose) + cout<<"Set "<setFrequency( SOAPY_SDR_RX, 0, value ); + } + return true; + } + else if(option == "gain_double") + { + double value = *reinterpret_cast(p_data_nonconst); + if(p_device_) + { + p_device_->setGain( SOAPY_SDR_RX, 0, value ); + if(b_verbose) + cout<<"Set "<(p_data_nonconst); + if(p_device_) + { + if(b_verbose) + cout<<"Set "<writeSetting("biastee", "true"); + else + p_device_->writeSetting("biastee", "false"); + } + return true; + } + else + { + cout<<"IQSource_SoapySDR::setOption error. Unknown option: "<(p_data) = sampling_rate_; + if(b_verbose) + cout<<"getOption "<(p_data)<(p_data) = p_device_->getFrequency( SOAPY_SDR_RX, 0); + if(b_verbose) + cout<<"getOption "<(p_data)<(p_data) = p_device_->getGain( SOAPY_SDR_RX, 0 ); + if(b_verbose) + cout<<"getOption "<(p_data)<readSetting("biastee") == string("true"); + *reinterpret_cast(p_data) = biastee_val; + if(b_verbose) + cout<<"getOption "<. +*/ + +#pragma once + +#include "IQSource.h" + +#include +#include + +#include +#include + + +namespace habdec +{ + + +class IQSource_SoapySDR : public habdec::IQSource +{ +public: + ~IQSource_SoapySDR(); + + bool start(); + bool stop(); + bool isRunning() const; + size_t count() const; + size_t get(void* p_data, const size_t i_count); + std::string type() const {return std::string("SoapySDR");}; + double samplingRate() const; + bool setOption(const std::string& option, const void* p_data); + bool getOption(const std::string& option, void* p_data); + + bool init(); + +private: + std::unique_ptr p_device_ = 0; + SoapySDR::Stream* p_stream_ = 0; + + bool b_is_running_ = false; + double sampling_rate_ = 0; + + // SoapySDR hardware info + SoapySDR::Kwargs soapysdr_kwargs_; // used for init() + std::string hwinfo_hwkey_; + std::string hwinfo_serial_; + size_t hwinfo_device_id_; + + std::vector hwinfo_gains_; + std::vector hwinfo_sampling_rates_; + std::vector hwinfo_stream_formats_; + + double hwinfo_freq_min_ = 0; + double hwinfo_freq_max_ = 0; + double hwinfo_gain_min_ = 0; + double hwinfo_gain_max_ = 0; +}; + + +} // namespace habdec \ No newline at end of file diff --git a/code/common/console_colors.cpp b/code/common/console_colors.cpp new file mode 100644 index 0000000..405c3ee --- /dev/null +++ b/code/common/console_colors.cpp @@ -0,0 +1,28 @@ +#ifdef __linux__ + const char* C_BLACK = "\033[1;30m"; + const char* C_RED = "\033[1;31m"; + const char* C_GREEN = "\033[1;32m"; + const char* C_BROWN = "\033[1;33m"; + const char* C_BLUE = "\033[1;34m"; + const char* C_MAGENTA = "\033[1;35m"; + const char* C_CYAN = "\033[1;36m"; + const char* C_LIGHTGREY = "\033[1;37m"; + const char* C_OFF = "\033[0m"; + const char* C_CLEAR = "\033[2K"; +// #elif _WIN32 +// #elif __APPLE__ +// #elif __unix__ // all unices not caught above +// #elif defined(_POSIX_VERSION) +#else + const char* C_BLACK = ""; + const char* C_RED = ""; + const char* C_GREEN = ""; + const char* C_BROWN = ""; + const char* C_BLUE = ""; + const char* C_MAGENTA = ""; + const char* C_CYAN = ""; + const char* C_LIGHTGREY = ""; + const char* C_OFF = ""; + const char* C_CLEAR = ""; + +#endif \ No newline at end of file diff --git a/code/common/console_colors.h b/code/common/console_colors.h new file mode 100644 index 0000000..047caa4 --- /dev/null +++ b/code/common/console_colors.h @@ -0,0 +1,12 @@ +#pragma once + +extern const char* C_BLACK; +extern const char* C_RED; +extern const char* C_GREEN; +extern const char* C_BROWN; +extern const char* C_BLUE; +extern const char* C_MAGENTA; +extern const char* C_CYAN; +extern const char* C_LIGHTGREY; +extern const char* C_OFF; +extern const char* C_CLEAR; \ No newline at end of file diff --git a/code/fltkGUI/CMakeLists.txt b/code/fltkGUI/CMakeLists.txt new file mode 100644 index 0000000..7129f75 --- /dev/null +++ b/code/fltkGUI/CMakeLists.txt @@ -0,0 +1,17 @@ + +include_directories( ${PROJECT_SOURCE_DIR} ) +include_directories( ${CMAKE_CURRENT_SOURCE_DIR} ) + +set ( FLTK_SKIP_FLUID True ) +find_package( FLTK REQUIRED ) +include_directories( ${FLTK_INCLUDE_DIR} ) +message( "FLTK Include:" ${FLTK_INCLUDE_DIR} ) +message( "FLTK Lib:" ${FLTK_LIBRARIES} ) + +SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-unused-variable") +SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-unused-parameter") + +add_executable (habdec_fltk main.cpp gui_utils.h ) +target_link_libraries( habdec_fltk Decoder ${FLTK_LIBRARIES} IQSource Decoder pthread ) + +install ( TARGETS habdec_fltk DESTINATION ${CMAKE_INSTALL_PREFIX} ) diff --git a/code/fltkGUI/gui_utils.h b/code/fltkGUI/gui_utils.h new file mode 100644 index 0000000..378d95d --- /dev/null +++ b/code/fltkGUI/gui_utils.h @@ -0,0 +1,234 @@ +#pragma once + +#include +#include +#include +#include +#include +#include + +#define BG_COLOR 45 +#define TICK_COLOR 50 +#define CIRC_COLOR 0 + +typedef uchar LUMA_T; +typedef uchar RGB_T; + +extern const int RES_X; +extern const int RES_Y; + +extern RGB_T SPECTRUM_BITMAP_RGB []; +extern RGB_T TIME_BITMAP_RGB []; + + +template +void SimpleDownsampleVector(std::vector& vec, size_t factor) +{ + using namespace std; + + if(!vec.size()) + return; + + if(factor<2) + return; + + const size_t _S = vec.size() / factor; + + if(factor == 2) + { + for(size_t i=0; i<_S; ++i) + vec[i] = .5 * (vec[2*i] + vec[2*i+1]); + } + else + { //somehow does not work for ractor=2 + for(size_t i=0; i<_S; ++i) + { + for(size_t j=1; j +void Histogram2Bitmap(COLOR_T* p_bitmap, int spectr_res_x, int spectr_res_y, + //float* p_values, int num_values, + const std::vector& values, + float min_value, float max_value, float avg_value, + float offset, float scale, + bool is_rgb) +{ + using namespace std; + + if(min_value == max_value) + { + min_value = *min_element( values.begin(), values.end() ); + max_value = *max_element( values.begin(), values.end() ); + } + + //if(fabs(min_value) > 100 || fabs(max_value) > 100) return; + + static float total_scale = fabs(max_value - min_value); + //cout<<"total_scale "< 1) val_0_1 = 1; + + int y_tip = val_0_1 * (spectr_res_y-1); + y_tip = spectr_res_y - 1 - y_tip; + + int x = pix_x; + for(int y=y_tip; y 1) _b = 1; + + size_t off = y*spectr_res_x+x; + if(is_rgb) + { + off *= 3; + + if(pix_x > .5f * spectr_res_x) + { + p_bitmap[off] = (COLOR_T)(_b * 255); + p_bitmap[off+1] = (COLOR_T)(_b * 0); + p_bitmap[off+2] = 0; + } + else + { + p_bitmap[off] = 0; + p_bitmap[off+1] = (COLOR_T)(_b * 155); + p_bitmap[off+2] = (COLOR_T)(_b * 255); + } + } + else + { + p_bitmap[off] = (COLOR_T)(_b * 255);//220; + } + } + } + + // center vertical line + for(int y=0; y +void VectorToBitmap(COLOR_T* p_bitmap, const std::vector& samples_, int m_res_x, int m_res_y) +{ + auto abs_sum = [&](TReal a, TReal b){return abs(a) + abs(b);}; + const TReal avg = accumulate(samples_.begin(), samples_.end(), .0, abs_sum) / samples_.size(); + + for(int x=0; x= m_res_y) + y = m_res_y - 1; + + size_t off = y*m_res_x+x; + if(samples_[_x_0_1 * samples_.size()] > 0) + { + p_bitmap[3*off+0] = (RGB_T)(255); + p_bitmap[3*off+1] = (RGB_T)(0); + p_bitmap[3*off+2] = (RGB_T)(0); + } + else + { + p_bitmap[3*off+0] = (RGB_T)(0); + p_bitmap[3*off+1] = (RGB_T)(150); + p_bitmap[3*off+2] = (RGB_T)(255); + } + } +} + + +template +void HorizontalLineToBitmap(COLOR_T* p_bitmap, int spectr_res_x, int y, bool is_rgb, + short r=0, short g=200, short b=250) +{ + for(int x=0; x +void VerticalLineToBitmap(COLOR_T* p_bitmap, int spectr_res_x, int spectr_res_y, int x, bool is_rgb, + short r=0, short g=200, short b=250) +{ + //int x = peak.first; + for(int y=0; y +#include +#include +using namespace std; + + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + + +#include "IQSource/IQSource_File.h" +#include "IQSource/IQSource_SoapySDR.h" +#include "Decoder/Decoder.h" + +#include "gui_utils.h" + +using namespace std; +using namespace habdec; + +typedef float TReal; +IQVector G_SAMPLES; +Decoder G_DECODER; +IQSource* G_IQ_SRC_PTR = 0; +double G_FREQ = 100e6; // 434.274451e6; +double G_SAMPLING_RATE = 0; +double G_FREQ_SPAN = 0; +bool DO_CORRECTION = false; + + +void SetFrequency(double freq) +{ + if(G_IQ_SRC_PTR) + { + G_FREQ = freq; + double freq_double = freq; + G_IQ_SRC_PTR->setOption("frequency_double", &freq_double); + } +} + +void RunDecoder() +{ + size_t max_samples_num = 256*256; // it doesn't work for small batches and radio ... + G_SAMPLES.resize(max_samples_num); + + while(1) + { + typedef std::chrono::nanoseconds TDur; + + auto _start = std::chrono::high_resolution_clock::now(); + size_t count = G_IQ_SRC_PTR->get( G_SAMPLES.data(), G_SAMPLES.size() ); + G_DECODER.pushSamples(G_SAMPLES); + + G_DECODER(); + TDur _duration = std::chrono::duration_cast(std::chrono::high_resolution_clock::now() - _start); + // std::cout<<"Decoder duration "<<_duration.count()<<" nS "< + (std::chrono::high_resolution_clock::now() - last_afc_time).count() > 1000000 + ) + { + double freq_corr = G_DECODER.getFrequencyCorrection(); + if(DO_CORRECTION) + { + if( 100 < abs(freq_corr) ) + { + G_FREQ += freq_corr; + G_IQ_SRC_PTR->setOption("frequency_double", &G_FREQ); + G_DECODER.resetFrequencyCorrection(freq_corr); + last_afc_time = std::chrono::high_resolution_clock::now(); + } + } + } + } +} + + +int InitProcess(int baud, int a_bits, int a_stops, std::string fname) +{ + if(fname != "") + { + cout<<"File"<; + G_IQ_SRC_PTR->setOption("sampling_rate_double", &G_SAMPLING_RATE); + G_IQ_SRC_PTR->setOption("file_string", &fname); + bool realtime = false; + G_IQ_SRC_PTR->setOption("realtime_bool", &realtime); + bool loop = true; + G_IQ_SRC_PTR->setOption("loop_bool", &loop); + + if( !G_IQ_SRC_PTR->init() ) + { + cout<<"IQSource_File::init failed."<count()<setOption("SoapySDR_Kwargs", &device); + + if( !G_IQ_SRC_PTR->init() ) + { + cout<<"IQSource_SoapySDR::init failed."<getOption("sampling_rate_double", &sr); + cout<setOption("gain_double", &gain); + + G_FREQ = 434.274e6; + SetFrequency(G_FREQ); // RTL + } + + cout<<"G_IQ_SRC_PTR->sampling_rate() "<samplingRate()<start() ) + { + cout<<"IQSource_File::start failed."<isRunning() ) + { + cout<<"IQSource_File::isRunning failed."<(1000) ); + + std::thread* p_thread = new std::thread(RunDecoder); + + return 0; +} + + + +///////////////////////////////////////////////////////////////////////// +///////////////////////////////////////////////////////////////////////// + + +typedef uchar LUMA_T; +typedef uchar RGB_T; +#define BG_COLOR 45 +const int RES_X = 1024; +const int RES_Y = 256; + +RGB_T SPECTRUM_BITMAP_RGB [RES_X*RES_Y*3]; // FFT +RGB_T TIME_BITMAP_RGB [RES_X*RES_Y*3]; // Demodulated samples + +class FreqViewport : public Fl_Box +{ +public: + FreqViewport(int X,int Y,int W,int H, const char*L=0) + : Fl_Box(X,Y,W,H,L), m_x(X), m_y(Y), m_res_x(W), m_res_y(H) + { + box(FL_FLAT_BOX); + color(BG_COLOR); + Fl::add_timeout(0.1, FreqViewport_CB, (void*)this); + } + +private: + const int m_x; + const int m_y; + const int m_res_x; + const int m_res_y; + + // frequency drag + int m_xMB; + bool m_DRAG; + int m_xMB_x; + int m_drag_freq_start; + + // IQVector m_frequencies_; + std::vector m_magnitudesArr; + + int handle(int event) + { + if(event == FL_MOUSEWHEEL) + { + size_t decimation_factor = G_DECODER.getDecimationFactor(); + size_t new_decim_exp = log2(decimation_factor) - Fl::event_dy(); + cout<<"Decimation: "< spectr_inf = G_DECODER.getSpectrumInfo(); + if(!spectr_inf.size()) + return; + m_magnitudesArr = spectr_inf; + + if( !m_magnitudesArr.size() ) + { + cout<<"if( !m_magnitudesArr.size() )"< low_level(25, spectr_inf.min_); + low_level.add(spectr_inf.min_); + // double low_level = -300; + + nf = (nf > (double)low_level) ? nf : (double)low_level; + + ClearBitmap(SPECTRUM_BITMAP_RGB, m_res_x, m_res_y, 3); + Histogram2Bitmap(SPECTRUM_BITMAP_RGB, m_res_x, m_res_y, + m_magnitudesArr, + low_level, 0, 0, + .0, .99, true); + + + if(spectr_inf.peak_left_valid_) + VerticalLineToBitmap(SPECTRUM_BITMAP_RGB, m_res_x, m_res_y, pl, true, 200, 50, 0); + else + VerticalLineToBitmap(SPECTRUM_BITMAP_RGB, m_res_x, m_res_y, pl, true, 50, 12, 0); + if(spectr_inf.peak_right_valid_) + VerticalLineToBitmap(SPECTRUM_BITMAP_RGB, m_res_x, m_res_y, pr, true, 0, 80, 250); + else + VerticalLineToBitmap(SPECTRUM_BITMAP_RGB, m_res_x, m_res_y, pr, true, 0, 20, 60); + + HorizontalLineToBitmap(SPECTRUM_BITMAP_RGB, m_res_x, (nf/low_level)*m_res_y, true, 80,80,80); + HorizontalLineToBitmap(SPECTRUM_BITMAP_RGB, m_res_x, ((nf+nv)/low_level)*m_res_y, true, 80,80,80); + + + Fl_Box::draw(); + fl_draw_image(SPECTRUM_BITMAP_RGB, m_x, m_y, m_res_x, m_res_y, 3, 0); + } + + static void FreqViewport_CB(void *userdata) + { + ((FreqViewport*)userdata)->redraw(); + Fl::repeat_timeout(1.0f/500, FreqViewport_CB, userdata); + } +}; + + +class DemodViewport : public Fl_Box +{ + +public: + const int m_x; + const int m_y; + const int m_res_x; + const int m_res_y; + + DemodViewport(int X,int Y,int W,int H, const char*L=0) + : Fl_Box(X,Y,W,H,L), m_x(X), m_y(Y), m_res_x(W), m_res_y(H) + { + box(FL_FLAT_BOX); + color(BG_COLOR); + Fl::add_timeout(0.1, DemodViewport_CB, (void*)this); + } + + +private: + std::vector samples_; + size_t samples_to_show_cnt_ = 0; + + void draw() + { + if(!samples_to_show_cnt_) + samples_to_show_cnt_ = G_DECODER.getDecimatedSamplingRate() / G_DECODER.getSymbolRate() * 10; // 10 symbols + + const size_t samples_size_pre_insert_ = samples_.size(); + auto demod = G_DECODER.getDemodulated(); + samples_.insert( + samples_.end(), + demod.cbegin(), + demod.cbegin() + min(samples_to_show_cnt_,demod.size()) + ); + + // if(!samples_.size()) + if(samples_.size() < samples_to_show_cnt_) + return; + + ClearBitmap(TIME_BITMAP_RGB, m_res_x, m_res_y, 3); + VectorToBitmap(TIME_BITMAP_RGB, samples_, m_res_x, m_res_y); + HorizontalLineToBitmap(TIME_BITMAP_RGB, m_res_x, m_res_y/2, true); + + Fl_Box::draw(); + fl_draw_image(TIME_BITMAP_RGB, m_x, m_y, m_res_x, m_res_y, 3, 0); + + if(samples_.size() > samples_to_show_cnt_) + samples_.erase( samples_.begin(), samples_.end()-samples_size_pre_insert_); + + } + + static void DemodViewport_CB(void *userdata) + { + ((DemodViewport*)userdata)->redraw(); + Fl::repeat_timeout(1.0f/10, DemodViewport_CB, userdata); + } + + +}; +///////////////////////////////// +///////////////////////////////// + + +void DO_AFC_CB(Fl_Widget* p_w, void* p_user) +{ + DO_CORRECTION = !DO_CORRECTION; +} + +int GUI_MAIN() +{ + Fl::visual(FL_RGB); // disable dithering + + Fl_Double_Window* p_window = new Fl_Double_Window(RES_X, 1.5*RES_Y + 50); + + p_window->begin(); + FreqViewport* p_freqVP = new FreqViewport( 0, 0*RES_Y, RES_X, RES_Y); + DemodViewport* p_timeVP = new DemodViewport( 0, 1*RES_Y, RES_X, RES_Y/2); + auto button = new Fl_Button(0, 1*RES_Y + RES_Y/2 + 10, 100, 20, "AFC"); + button->callback( ( Fl_Callback* ) DO_AFC_CB ); + p_window->end(); + p_window->show(0, 0); + + return Fl::run(); +} + + + +int main(int argc, char** argv) +{ + using namespace std; + + struct thousand_separators : numpunct { + char do_thousands_sep() const { return ','; } + string do_grouping() const { return "\3"; } + }; + cout.imbue( locale(locale(""), new thousand_separators) ); + + + string file(""); + if(argc > 4) + file = string(argv[4]); + cout<<"File: "<(3000)); + +} diff --git a/code/habLogger/habLogger.py b/code/habLogger/habLogger.py new file mode 100755 index 0000000..dc57aaa --- /dev/null +++ b/code/habLogger/habLogger.py @@ -0,0 +1,149 @@ +#!/usr/bin/env python + +import string +import os +import sys +import time +import datetime +import argparse +import json +import re +import traceback +from base64 import b64encode +import httplib +from hashlib import sha256 + + +C_BLACK = "\033[1;30m" +C_RED = "\033[1;31m" +C_GREEN = "\033[1;32m" +C_BROWN = "\033[1;33m" +C_BLUE = "\033[1;34m" +C_MAGENTA = "\033[1;35m" +C_CYAN = "\033[1;36m" +C_LIGHTGREY = "\033[1;37m" +C_OFF = "\033[0m" + +# logname = time.strftime("%Y-%m-%d_%H.%M.%S", time.gmtime()) + ".txt" +logname = time.strftime("%Y-%m-%d_%H", time.gmtime()) + ".txt" +with open('./' + logname, 'a') as f: + f.write(logname + "\n") + + +def prog_opts(): + parser = argparse.ArgumentParser(description='arg parser') + parser.add_argument('--addr', dest='port', action='store', help='port') + parser.add_argument('--station',dest='station', action='store', help='listener callsign') + args = parser.parse_args() + return args + + +def get_config(): + opts = prog_opts() + CFG = {} + + CFG['addr'] = "" + CFG['station'] = "" + + if opts.port: CFG['addr'] = opts.port + if opts.station: CFG['station'] = opts.station + return CFG + + +def crc(i_str): + def _hex(Character): + _hexTable = '0123456789ABCDEF' + return _hexTable[Character] + + CRC = 0xffff + xPolynomial = 0x1021 + + for i in xrange(len(i_str)): + CRC ^= (ord(i_str[i]) << 8) + for j in xrange(8): + if CRC & 0x8000: + CRC = (CRC << 1) ^ 0x1021 + else: + CRC <<= 1 + + result = '' + result += _hex((CRC >> 12) & 15) + result += _hex((CRC >> 8) & 15) + result += _hex((CRC >> 4) & 15) + result += _hex(CRC & 15) + + return result + + +def AppendToLogFile(msg): + with open('./' + logname, 'a') as f: + msg = string.strip(msg) + f.write(msg + '\n\r') + + +def sendSentence(sntc, listener_callsign): + # print ("PYTHON ", sntc, listener_callsign) + # return + + sentence = sntc + + if sentence[-1] != '\n': sentence += '\n' + if sentence[0] != '$': sentence = '$' + sentence + if sentence[1] != '$': sentence = '$' + sentence + + print "PY SENTENCE ", sentence + + sentence = b64encode(sentence) + + retries = 5 + + while retries: + date = datetime.datetime.utcnow().isoformat("T") + "Z" + + data = { + "type": "payload_telemetry", + "data": { + "_raw": sentence + }, + "receivers": { + listener_callsign: { + "time_created": date, + "time_uploaded": date, + }, + }, + } + + c = httplib.HTTPConnection("habitat.habhub.org") + c.request( + "PUT", + "/habitat/_design/payload_telemetry/_update/add_listener/%s" % sha256(sentence).hexdigest(), + json.dumps(data), # BODY + {"Content-Type": "application/json"} # HEADERS + ) + + response = c.getresponse() + print response.status, response.reason, response.read() + + if response.status == 201 or response.status == '201': + retries == 0 + break + + retries = retries - 1 + time.sleep(1) + + +def main(): + caller = "habdec" + + if len(sys.argv) > 2: + caller = sys.argv[2] + + if len(sys.argv) > 1: + sendSentence(sys.argv[1], caller) + +if __name__ == '__main__': + try: + main() + except: + print traceback.format_exc() + diff --git a/code/webClient/css/habdec.css b/code/webClient/css/habdec.css new file mode 100644 index 0000000..5d65641 --- /dev/null +++ b/code/webClient/css/habdec.css @@ -0,0 +1,74 @@ + +body, html { + background-color:hsl(210, 15%, 24%); +} + +div{ + font-family: Tahoma, Verdana, Segoe, sans-serif; +} + +label { + color: hsl(32, 93%, 45%); +} + +button { + background-color:hsl(210, 15%, 34%); + border: none; + color: #AAAAAA; + /* padding: 15px 32px; */ + text-align: center; + display: inline-block; + font-size: 20px; + height: 4.0rem; + + border: 0.1rem solid hsl(210, 15%, 20%); + border-radius: .4rem; +} + +input[type=checkbox] +{ + /* Double-sized Checkboxes */ + -ms-transform: scale(2.5); /* IE */ + -moz-transform: scale(2.5); /* FF */ + -webkit-transform: scale(2.5); /* Safari and Chrome */ + -o-transform: scale(2.5); /* Opera */ + padding: 10px; +} + +.checkboxtext +{ + font-size: 130%; + display: inline; +} + +.ctrl_container { + width: 100%; +} + +.habsentence_text { + font-size: 12px; +} + +.ctrl_box { + color: hsl(32, 93%, 60%); + background-color: transparent; + border: 0.1rem solid #000000; + border-radius: .4rem; + height: 2.5rem; + padding: .6rem 1.0rem; + width: 50px; +} + +.increment_button { + background-color:hsl(210, 15%, 34%); + border: none; + color: #AAAAAA; + text-align: center; + display: inline-block; + font-size: 20px; + height: 60px; + width: 80px; + + border: 0.1rem solid hsl(210, 15%, 20%); + border-radius: .4rem; +} \ No newline at end of file diff --git a/code/webClient/index.html b/code/webClient/index.html new file mode 100755 index 0000000..3e757b9 --- /dev/null +++ b/code/webClient/index.html @@ -0,0 +1,94 @@ + + + + + + + + + + + + + + + + + +
+
+ +
+
+
+
+
+
+ +
+ +
+
+ +
+
+
+ +
+
+
+
+
+
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+ +
+ BiasTee

+ AFC +

+
+ +
+
+ + +
+ + + + + + diff --git a/code/webClient/js/NetTransport.js b/code/webClient/js/NetTransport.js new file mode 100644 index 0000000..a363d56 --- /dev/null +++ b/code/webClient/js/NetTransport.js @@ -0,0 +1,80 @@ + + +function DecodeSpectrum(i_buffer, i_offset) +{ + var header = + { + header_size_ : 0, // int32_t + noise_floor_ : 0, // float + noise_variance_ : 0, // float + sampling_rate_: 0, // float + shift_ : 0, // float + peak_left_ : 0, // int32_t + peak_right_ : 0, // int32_t + peak_left_valid_ : 0, // int32_t + peak_right_valid_ : 0, // int32_t + min_ : 0, // float + max_ : 0, // float + + type_size_ : 0, // int32_t. value:s 1/2/4 for uint8 uint16 float32 + size_ : 0 // int32_t + }; + + var dv = new DataView(i_buffer, i_offset); + + var offset = 0; + header.header_size_ = dv.getInt32 (offset, true); offset += 4; + header.noise_floor_ = dv.getFloat32 (offset, true); offset += 4; + header.noise_variance_ = dv.getFloat32 (offset, true); offset += 4; + header.sampling_rate_= dv.getFloat32 (offset, true); offset += 4; + header.shift_ = dv.getFloat32 (offset, true); offset += 4; + header.peak_left_ = dv.getInt32 (offset, true); offset += 4; + header.peak_right_ = dv.getInt32 (offset, true); offset += 4; + header.peak_left_valid_= dv.getInt32 (offset, true); offset += 4; + header.peak_right_valid_= dv.getInt32 (offset, true); offset += 4; + header.min_ = dv.getFloat32 (offset, true); offset += 4; + header.max_ = dv.getFloat32 (offset, true); offset += 4; + header.type_size_ = dv.getInt32 (offset, true); offset += 4; + header.size_ = dv.getInt32 (offset, true); offset += 4; + + // add data + if(header.type_size_ == 1) // 8 bit char + header.values_ = new Uint8Array( i_buffer, offset, header.size_); + else if(header.type_size_ == 2) // uint16_t + header.values_ = new Uint16Array( i_buffer, offset, header.size_); + else if(header.type_size_ == 4) // 32float + header.values_ = new Float32Array( i_buffer, offset, header.size_); + + return header; +} + +function DecodeDemod(i_buffer, i_offset) +{ + var header = + { + header_size_ : 0, // int32_t + min_ : 0, // float + max_ : 0, // float + type_size_ : 0, // int32_t. value:s 1/2/4 for uint8 uint16 float32 + size_ : 0 // int32_t + }; + + var dv = new DataView(i_buffer, i_offset); + + var offset = 0; + header.header_size_ = dv.getInt32 (offset, true); offset += 4; + header.min_ = dv.getFloat32 (offset, true); offset += 4; + header.max_ = dv.getFloat32 (offset, true); offset += 4; + header.type_size_ = dv.getInt32 (offset, true); offset += 4; + header.size_ = dv.getInt32 (offset, true); offset += 4; + + // add data + if(header.type_size_ == 1) // 8 bit char + header.values_ = new Uint8Array( i_buffer, offset, header.size_); + else if(header.type_size_ == 2) // uint16_t + header.values_ = new Uint16Array( i_buffer, offset, header.size_); + else if(header.type_size_ == 4) // 32float + header.values_ = new Float32Array( i_buffer, offset, header.size_); + + return header; +} diff --git a/code/webClient/js/drawing.js b/code/webClient/js/drawing.js new file mode 100644 index 0000000..78863e2 --- /dev/null +++ b/code/webClient/js/drawing.js @@ -0,0 +1,194 @@ +function DrawPowerSpectrum(i_canvas, i_spectrum) +{ + var ctx = i_canvas.getContext("2d"); + + // CLEAR THE CANVAS + // + ctx.clearRect(0, 0, i_canvas.width-1, i_canvas.height-1); + + // BG + // + var grd_bg = ctx.createLinearGradient(0, 0, 0, i_canvas.height-1); + grd_bg.addColorStop(0, "hsl(210, 15%, 24%)"); + grd_bg.addColorStop(.5, "hsl(210, 15%, 40%)"); + grd_bg.addColorStop(1, "hsl(210, 15%, 24%)"); + ctx.fillStyle = grd_bg; + ctx.fillRect(0, 0, i_canvas.width-1, i_canvas.height-1); + + G_SPECTRUM_ZOOM = Math.max(0, Math.min(1, G_SPECTRUM_ZOOM)); + + var zoom = G_SPECTRUM_ZOOM; + + // LOWPASS FILTER DRAW + // + var _lowpass_bw = GLOBALS.lowpass_bw / (1.0 - .999*zoom); + var _lowpass_trans = GLOBALS.lowpass_trans / (1.0 - .999*zoom); + var grd_lowpass = ctx.createLinearGradient(0, 0, i_canvas.width-1, 0); + var _l = Math.max(0, .5 - .5 * _lowpass_bw); + var _ll = Math.max(0, .5 - .5 * (_lowpass_bw + _lowpass_trans)); + var _r = Math.min(1, .5 + .5 * _lowpass_bw); + var _rr = Math.min(1, .5 + .5 * (_lowpass_bw + _lowpass_trans)); + + grd_lowpass.addColorStop(0, "rgba(15,25,50,0)"); + grd_lowpass.addColorStop(_ll, "rgba(15,25,50,0)"); + grd_lowpass.addColorStop(_l, "#113555"); + grd_lowpass.addColorStop(_r, "#113555"); + grd_lowpass.addColorStop(_rr, "rgba(15,25,50,0)"); + grd_lowpass.addColorStop(1, "rgba(15,25,50,0)"); + ctx.fillStyle = grd_lowpass; + ctx.fillRect(0, 0, i_canvas.width-1, i_canvas.height-1); + + // SPECTRUM + // + var power_grd = ctx.createLinearGradient(0, 0, 0, i_canvas.height-1); + power_grd.addColorStop(0.2, "yellow"); + power_grd.addColorStop(.6, "#993311"); + power_grd.addColorStop(1, "black"); + + ctx.strokeStyle = power_grd; + ctx.beginPath(); + if(i_spectrum.type_size_ == 1) // 8 bit char + { + for(var x=0; x")); + + var incr_big = document.createElement("button"); + incr_big.classList.add("increment_button"); + incr_big.appendChild(document.createTextNode(">>>")); + + // arrows callbacks + decr_big.onclick = function() { + widget.value = parseFloat(widget.value) - parseFloat(widget.getAttribute("step_big")); + i_callback("set:" + i_parameter + "=" + widget.value); + }; + decr_small.onclick = function() { + widget.value = parseFloat(widget.value) - parseFloat(widget.getAttribute("step_small")); + i_callback("set:" + i_parameter + "=" + widget.value); + }; + incr_small.onclick = function() { + widget.value = parseFloat(widget.value) + parseFloat(widget.getAttribute("step_small")); + i_callback("set:" + i_parameter + "=" + widget.value); + }; + incr_big.onclick = function() { + widget.value = parseFloat(widget.value) + parseFloat(widget.getAttribute("step_big")); + i_callback("set:" + i_parameter + "=" + widget.value); + }; + + document.getElementById(i_cnt).style.textAlign = "right"; + + document.getElementById(i_cnt).appendChild(lab); + + document.getElementById(i_cnt).appendChild(widget); + + document.getElementById(i_cnt).appendChild(decr_big); + document.getElementById(i_cnt).appendChild(decr_small); + document.getElementById(i_cnt).appendChild(incr_small); + document.getElementById(i_cnt).appendChild(incr_big); + + return widget; +} + + +function SetGuiToGlobals(i_globals) +{ + for(var param in i_globals) + { + var value = i_globals[param]; + // console.debug("setting ", param, value); + try {document.getElementById(param).value = value; } catch(err) {}; + try {document.getElementById(param + "_box").value = value; } catch(err) {}; + try {document.getElementById(param).checked = value; } catch(err) {}; + } +} + + +function CreateControls() +{ + var freq_widget = CreateFloatBoxWithArrows("cnt_frequency", "frequency", + SendCommand, 25, 1200, 434.355, 20.0/1e6, 1000.0/1e6, 1e-6); + freq_widget.style.width = "100px"; + CreateFloatBoxWithArrows("cnt_decimation", "decimation", + SendCommand, 0, 8, 8, 1, 1); + CreateFloatBoxWithArrows("cnt_gain", "gain", + SendCommand, 0, 49, 21, 1, 5); + CreateFloatBoxWithArrows("cnt_lowpass_bw", "lowpass_bw", + SendCommand, .0, 1.0, .05, .002, .02); + CreateFloatBoxWithArrows("cnt_lowpass_trans", "lowpass_trans", + SendCommand, .0025, 0.1, .05, .0025, .01); + CreateFloatBoxWithArrows("cnt_baud", "baud", + SendCommand, 50, 1200, 300, 25, 100); + CreateFloatBoxWithArrows("cnt_rtty_bits", "rtty_bits", + SendCommand, 7, 8, 8, 1, 1); + CreateFloatBoxWithArrows("cnt_rtty_stops", "rtty_stops", + SendCommand, 1, 2, 2, 1, 1); + CreateFloatBoxWithArrows("cnt_datasize", "datasize", + SendCommand, 1, 4, 1, 1, 1); +} + + +function toggleFullscreen(elem) +{ + elem = elem || document.documentElement; + if (!document.fullscreenElement && !document.mozFullScreenElement && + !document.webkitFullscreenElement && !document.msFullscreenElement) + { + if (elem.requestFullscreen) { + elem.requestFullscreen(); + } else if (elem.msRequestFullscreen) { + elem.msRequestFullscreen(); + } else if (elem.mozRequestFullScreen) { + elem.mozRequestFullScreen(); + } else if (elem.webkitRequestFullscreen) { + elem.webkitRequestFullscreen(Element.ALLOW_KEYBOARD_INPUT); + } + } + else + { + if (document.exitFullscreen) { + document.exitFullscreen(); + } else if (document.msExitFullscreen) { + document.msExitFullscreen(); + } else if (document.mozCancelFullScreen) { + document.mozCancelFullScreen(); + } else if (document.webkitExitFullscreen) { + document.webkitExitFullscreen(); + } + } +} diff --git a/code/webClient/js/habdec_commands.js b/code/webClient/js/habdec_commands.js new file mode 100644 index 0000000..7fc23e7 --- /dev/null +++ b/code/webClient/js/habdec_commands.js @@ -0,0 +1,285 @@ + +var websocket; +var connected = 0; +var LastHabSentences = []; +var G_SPECTRUM_ZOOM = 0; +var G_SENTECES_OK_COUNT = 0; + +var GLOBALS = +{ + frequency: 0, + sampling_rate: 0, + gain: 0, + baud: 0, + rtty_bits: 0, + rtty_stops: 0, + lowpass_bw: 0, + lowpass_trans: 0, + biastee: 0, + decimation: 0, + afc: 0 +}; + + +function debug_print() +{ + console.debug(arguments); + /* + document.getElementById("cnt_debug").innerHTML = ""; + for (i = 0; i < arguments.length; i++) + document.getElementById("cnt_debug").innerHTML += arguments[i] + " "; + */ +} + + +function OpenConnection() +{ + if(connected) + return; + + var server = document.getElementById("server_address").value; + debug_print("Connecting to ", server, " ..."); + websocket = new WebSocket("ws://" + server); + websocket.binaryType = 'arraybuffer'; // or 'blob' + + websocket.onopen = function(evt) { ws_onOpen(evt) }; + websocket.onclose = function(evt) { ws_onClose(evt) }; + websocket.onmessage = function(evt) { ws_onMessage(evt) }; + websocket.onerror = function(evt) { ws_onError(evt) }; +} + + +function ws_onClose(evt) +{ + connected = 0; + debug_print("DISCONNECTED"); + setTimeout(function () { OpenConnection(); }, 5000); +} + + +function ws_onError(evt) +{ + debug_print("ws_onError: ", evt.data); +} + + +function ws_onOpen(evt) +{ + connected = 1; + debug_print("ws_onOpen: ", "Connected."); + + websocket.send("hi"); + for(var param in GLOBALS) + SendCommand("get:" + param); + + console.debug("ws_onOpen: init refresh."); + RefreshPowerSpectrum(); + RefreshDemod(); + RefreshLivePrint(); +} + + +function ws_onMessage(evt) +{ + if(!connected) + { + debug_print("ws_onMessage: not connected."); + return; + } + + // console.debug("ON_MSG", evt); + + if(typeof evt.data === "string") + { + HandleMessage(evt.data) + } + else if(evt.data instanceof ArrayBuffer) + { + var what = String.fromCharCode.apply( null, new Uint8Array(evt.data,0,4) ); + if(what == "PWR_") + { + var spectrum = DecodeSpectrum(evt.data, 4); + if(GLOBALS.sampling_rate != spectrum.sampling_rate_) + { + GLOBALS.sampling_rate = spectrum.sampling_rate_; + var widget = document.getElementById("frequency"); + widget.setAttribute("step_big", GLOBALS.sampling_rate / 1e6 / 30); + widget.setAttribute("step_small", GLOBALS.sampling_rate / 1e6 / 500); + } + DrawPowerSpectrum(document.getElementById("powerSpectrumCanvas"), spectrum); + } + else if(what == "DEM_") + { + var demod = DecodeDemod(evt.data, 4); + DrawDemod(document.getElementById("demodCanvas"), demod); + } + } + else + { + debug_print("ws_onMessage: unknown data type."); + return; + } +} + + +function SendCommand(i_cmd) +{ + if(!connected) + { + debug_print("SendCommand: not connected."); + return; + } + var msg = "cmd::" + i_cmd; + // debug_print("SendCommand: ", msg); + websocket.send(msg); +} + + +function HandleMessage(i_data) +{ + if(!connected) + { + debug_print("HandleMessage: not connected."); + return; + } + + if( !i_data.startsWith("cmd::info:liveprint") ) + debug_print("Received Message: ", i_data); + + // cmd::set + // + var set_rex = String.raw`cmd\:\:set\:(\D+)=(.+)`; + var set_re = new RegExp(set_rex); + var set_match = set_re.exec(i_data); + if(set_match != null && set_match.length == 3) + { + if(set_match[1] == "frequency") + GLOBALS.frequency = parseFloat(set_match[2]); + if(set_match[1] == "decimation") + GLOBALS.decimation = parseInt(set_match[2]); + else if(set_match[1] == "gain") + GLOBALS.gain = parseFloat(set_match[2]); + else if(set_match[1] == "baud") + GLOBALS.baud = parseInt(set_match[2]); + else if(set_match[1] == "lowpass_bw") + GLOBALS.lowpass_bw = parseFloat(set_match[2]); + else if(set_match[1] == "lowpass_trans") + GLOBALS.lowpass_trans = parseFloat(set_match[2]); + else if(set_match[1] == "rtty_bits") + GLOBALS.rtty_bits = parseFloat(set_match[2]); + else if(set_match[1] == "rtty_stops") + GLOBALS.rtty_stops = parseFloat(set_match[2]); + else if(set_match[1] == "lowPass") + { + GLOBALS.lowpass_bw = parseFloat(set_match[2].split(',')[0]); + GLOBALS.lowpass_trans = parseFloat(set_match[2].split(',')[1]); + } + else if(set_match[1] == "biastee") + { + GLOBALS.biastee = parseFloat(set_match[2]); + debug_print("Received Message: ", i_data); + } + else if(set_match[1] == "afc") + { + GLOBALS.afc = parseFloat(set_match[2]); + debug_print("Received Message: ", i_data); + } + + SetGuiToGlobals(GLOBALS); + + return true; + } + + // cmd::info + // + var data_without_new_lines = i_data.replace(/(\r\n|\n|\r)/gm," "); + var info_rex = String.raw`cmd\:\:info\:(\D+)=(.+)`; + var info_re = new RegExp(info_rex); + var info_match = info_re.exec(data_without_new_lines); + // if (info_match && info_match.length == 3) + { + if(info_match[1] == "sentence") + { + G_SENTECES_OK_COUNT += 1; + document.getElementById("cnt_habsentence_count").innerHTML = "OK: " + G_SENTECES_OK_COUNT; + + var sntnc = info_match[2]; + + var cnt_habsentence_list = document.getElementById("cnt_habsentence_list") + cnt_habsentence_list.innerHTML = '' + sntnc + '';; + + while(LastHabSentences.length > 12) + LastHabSentences.pop(); + LastHabSentences.forEach( function(i_snt){ + cnt_habsentence_list.innerHTML += '
' + i_snt + ''; + } + ); + + LastHabSentences.unshift( info_match[2] ); + } + else if(info_match[1] == "liveprint") + { + var livestream = info_match[2]; + if(livestream.length > 100) + livestream = livestream.substr(livestream.length-100, livestream.length); + document.getElementById("cnt_liveprint").innerHTML = livestream; + } + + return true; + } + + return false; + +} + + +function RefreshPowerSpectrum() +{ + if(!connected) + return; + + G_SPECTRUM_ZOOM = Math.max(0, Math.min(1, G_SPECTRUM_ZOOM)); + var zoom = Math.max(0, Math.min(1, G_SPECTRUM_ZOOM)); + var canvas = document.getElementById("powerSpectrumCanvas"); + SendCommand("power:res=" + canvas.width + ",zoom=" + zoom); + setTimeout(function () {RefreshPowerSpectrum();}, 1000 / 15); +} + + +function RefreshDemod() +{ + if(!connected) + return; + var canvas = document.getElementById("demodCanvas"); + SendCommand("demod:res=" + canvas.width); + setTimeout(function () {RefreshDemod();}, 1000 / 3); +} + + +function RefreshLivePrint() +{ + if(!connected) + return; + SendCommand("liveprint"); + setTimeout(function () {RefreshLivePrint();}, 1000 / 4); +} + + +function SetBiasT() +{ + var value = document.getElementById("biastee").checked; + if(value) + SendCommand("set:biastee=1"); + else + SendCommand("set:biastee=0"); +} + + +function SetAFC() +{ + var value = document.getElementById("afc").checked; + if(value) + SendCommand("set:afc=1"); + else + SendCommand("set:afc=0"); +} diff --git a/code/websocketServer/CMakeLists.txt b/code/websocketServer/CMakeLists.txt new file mode 100755 index 0000000..49d8673 --- /dev/null +++ b/code/websocketServer/CMakeLists.txt @@ -0,0 +1,65 @@ + + +include_directories( ${PROJECT_SOURCE_DIR} ) +include_directories( ${CMAKE_CURRENT_SOURCE_DIR} ) + +set ( FFTW3f_DIR ../CMake ) +find_package( FFTW3f REQUIRED ) +include_directories( ${FFTW3f_INCLUDE_DIRS} ) + +# boost +set ( Boost_NO_BOOST_CMAKE ON ) +set ( Boost_NO_SYSTEM_PATHS ON ) +set ( Boost_USE_STATIC_LIBS ON ) +add_definitions ( -DBOOST_ALL_NO_LIB ) +find_package(Boost REQUIRED COMPONENTS program_options system ) +include_directories( ${Boost_INCLUDE_DIRS} ) +message ( "Boost_INCLUDE_DIRS " ${Boost_INCLUDE_DIRS} ) +message ( "Boost_LIBRARY_DIRS " ${Boost_LIBRARY_DIRS} ) + +find_package(SoapySDR REQUIRED) # this reverts CMAKE_CXX_STANDARD to '11' +#set ( CMAKE_CXX_STANDARD 17 ) +include_directories( ${SoapySDR_INCLUDE_DIRS} ) + + +set( CMAKE_CXX_FLAGS " -O3 " ) +if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU") + # set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wshadow" ) + set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-class-memaccess" ) + set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-unused-variable" ) + set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-unused-parameter" ) +elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "MSVC") + SET(CMAKE_CXX_FLAGS "/EHsc") + add_definitions( -D_USE_MATH_DEFINES ) +endif() + +set (PlatformSpecificLinking "") +if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU") + set (PlatformSpecificLinking "pthread") +endif() + + +set ( websocketServer_src + program_options.h program_options.cpp + server.h server.cpp + main.cpp + ) + +add_executable ( habdecWebsocketServer ${websocketServer_src} ) +target_link_libraries( habdecWebsocketServer + Decoder + IQSource + ${Boost_LIBRARIES} + ${PlatformSpecificLinking} ) + +install ( TARGETS habdecWebsocketServer DESTINATION ${CMAKE_INSTALL_PREFIX} ) +install ( FILES ${PROJECT_SOURCE_DIR}/habLogger/habLogger.py + PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ + DESTINATION ${CMAKE_INSTALL_PREFIX} ) + + +file( WRITE ${CMAKE_CURRENT_BINARY_DIR}/run_loop.sh "#!/bin/sh\n while true; do ./habdecWebsocketServer --config ./habdecWebsocketServer.opts; done\n" ) +install ( FILES ${CMAKE_CURRENT_BINARY_DIR}/run_loop.sh + PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ + DESTINATION ${CMAKE_INSTALL_PREFIX} ) + diff --git a/code/websocketServer/CompressedVector.h b/code/websocketServer/CompressedVector.h new file mode 100644 index 0000000..9ef7508 --- /dev/null +++ b/code/websocketServer/CompressedVector.h @@ -0,0 +1,311 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include +#include + +namespace habdec +{ + +template +class CompressedVector +{ +public: + + typedef T TValue; + + mutable double min_ = 0; + mutable double max_ = 0; + std::vector values_; + + virtual ~CompressedVector() = default; + CompressedVector() = default; + + template + CompressedVector(const CompressedVector& rhs) : + min_(rhs.min_), + max_(rhs.max_) + // normalized_(rhs.normalized_) + { + copyValues(rhs); + } + + template + CompressedVector(const std::vector& rhs_vec) + { + min_ = *std::min_element(rhs_vec.begin(), rhs_vec.end()); + max_ = *std::max_element(rhs_vec.begin(), rhs_vec.end()); + copyValues(rhs_vec, min_, max_); + } + + template + const CompressedVector& operator=(const CompressedVector& rhs) + { + min_ = rhs.min_; + max_ = rhs.max_; + copyValues(rhs); + return *this; + } + + double calcMin() const + { + if(!values_.size()) + return 0; + min_ = *std::min_element(values_.begin(), values_.end()); + return min_; + } + + double calcMax() const + { + if(!values_.size()) + return 0; + max_ = *std::max_element(values_.begin(), values_.end()); + return max_; + } + +private: + template + void copyValues(const std::vector& rhs, double i_min, double i_max) + { + if(!rhs.size()) + { + values_.clear(); + return; + } + values_.resize(rhs.size()); + std::copy(rhs.begin(), rhs.end(), values_.begin()); + } + +}; + + +// specialization: float --> double +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + if(!rhs.size()) + { + values_.clear(); + return; + } + + values_.resize(rhs.size()); + std::copy(rhs.begin(), rhs.end(), values_.begin()); +} + + +// specialization: double --> float +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: double --> float"< unsigned char +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: float --> unsigned char"<::max(); + values_.push_back(v_out); + } +} + + +// specialization: float --> uint16_t +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: float --> uint16_t"<::max(); + values_.push_back(v_out); + } +} + + +// specialization: double --> unsigned char +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: double --> unsigned char"<::max(); + values_.push_back(v_out); + } +} + + +// specialization: double --> uint16_t +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: double --> uint16_t"<::max(); + values_.push_back(v_out); + } +} + + +// specialization: unsigned char --> float +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: unsigned char --> float"<::max(); + values_.push_back(rhs_v_0_1); + } +} + + +// specialization: uint16_t --> float +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: uint16_t --> float"<::max(); + values_.push_back(rhs_v_0_1); + } +} + + +// specialization: unsigned char --> double +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: unsigned char --> double"<::max(); + values_.push_back(rhs_v_0_1); + } +} + + +// specialization: uint16_t --> double +template<> +template<> +void CompressedVector::copyValues(const std::vector& rhs, double i_min, double i_max) +{ + // std::cout<<"specialization: uint16_t --> double"<::max(); + values_.push_back(rhs_v_0_1); + } +} + + +} // namespace habdec \ No newline at end of file diff --git a/code/websocketServer/GLOBALS.h b/code/websocketServer/GLOBALS.h new file mode 100644 index 0000000..9d7db51 --- /dev/null +++ b/code/websocketServer/GLOBALS.h @@ -0,0 +1,117 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include +#include +#include +#include + + +#include "IQSource/IQSource.h" +#include "Decoder/Decoder.h" + + +typedef float TReal; // we operate on float IQ samples +typedef habdec::Decoder TDecoder; + + +// singleton class keeping all global data +class GLOBALS +{ +public: + GLOBALS(GLOBALS const&) = delete; + void operator=(GLOBALS const&) = delete; + + static GLOBALS& get() + { + static GLOBALS instance_; + return instance_; + } + + // decoder and IQ source + TDecoder decoder_; + std::unique_ptr p_iq_source_; + + enum class TransportDataType {kUnknown=0, kChar, kShort, kFloat}; // 8, 16, 32 bits + TransportDataType transport_data_type_ = TransportDataType::kChar; + + std::vector demod_accumulated_; // acuumulated demod samples, used for GUI display + std::mutex demod_accumulated_mtx_; + + // decoded sentences que + std::vector senteces_to_log_; + std::mutex senteces_to_log_mtx_; + std::vector senteces_to_web_; + std::mutex senteces_to_web_mtx_; + + // outgoing commands. used to sync webgui + std::vector out_commands_; + std::mutex out_commands_mtx_; + + // OPTS: + int device_ = -1; // index to SoapySDR::Device::enumerate() + std::string command_host_ = "0.0.0.0"; + int command_port_ = 5555; + std::string station_callsign_ = ""; // habitat upload + double sampling_rate_ = 0; + double frequency_ = 434349500.0f; + double gain_ = 15; + bool biast_ = false; + float baud_ = 300; + int rtty_ascii_bits_ = 8; + float rtty_ascii_stops_ = 2; + bool live_print_ = true; + bool afc_ = false; + + static bool DumpToFile(std::string fName) + { + using namespace std; + try{ + fstream oFile(fName, fstream::out); + + oFile<<"device = "<. +*/ + +#pragma once + +#include +#include + +#include "Decoder/SpectrumInfo.h" +#include "CompressedVector.h" + +struct SpectrumInfoHeader +{ + int32_t header_size_ = (int32_t)sizeof(SpectrumInfoHeader); + float noise_floor_ = 0; + float noise_variance_ = 0; + float sampling_rate_ = 0; + float shift_ = 0; + int32_t peak_left_ = 0; + int32_t peak_right_ = 0; + int32_t peak_left_valid_ = 0; + int32_t peak_right_valid_ = 0; + float min_ = 0; + float max_ = 0; + // int32_t normalized_ = 0; + + int32_t type_size_ = 0; + int32_t size_ = 0; +}; + + +struct DemodHeader +{ + int32_t header_size_ = sizeof(DemodHeader); + float min_ = 0; + float max_ = 0; + int32_t type_size_ = 0; + int32_t size_ = 0; +}; + + + +template +void SerializeSpectrum(const TSpectrumInfo& spectrum_info, std::stringstream& ostr, TTransport* unused) +{ + // convert spectrum_info values to type TTransport + habdec::CompressedVector compressed(spectrum_info); + + // make header + SpectrumInfoHeader header; + header.noise_floor_ = spectrum_info.noise_floor_; + header.noise_variance_ = spectrum_info.noise_variance_; + header.sampling_rate_ = spectrum_info.sampling_rate_; + header.shift_ = spectrum_info.shift_; + header.peak_left_ = spectrum_info.peak_left_; + header.peak_right_ = spectrum_info.peak_right_; + header.peak_left_valid_ = spectrum_info.peak_left_valid_; + header.peak_right_valid_ = spectrum_info.peak_right_valid_; + header.size_ = spectrum_info.size(); + + header.min_ = compressed.min_; + header.max_ = compressed.max_; + + header.type_size_ = sizeof(TTransport); + + ostr.write( reinterpret_cast(&header), sizeof(header) ); + ostr.write( reinterpret_cast( compressed.values_.data()), compressed.values_.size() * sizeof(TTransport) ); +} + + +template +void SerializeDemodulation(const DemodVector& vec, std::stringstream& ostr, TTransport* unused) +{ + habdec::CompressedVector compressed(vec); + + // make header + DemodHeader header; + header.size_ = vec.size(); + header.min_ = compressed.min_; + header.max_ = compressed.max_; + header.type_size_ = sizeof(TTransport); + + ostr.write( reinterpret_cast(&header), sizeof(header) ); + ostr.write( reinterpret_cast( compressed.values_.data()), compressed.values_.size() * sizeof(TTransport) ); +} diff --git a/code/websocketServer/main.cpp b/code/websocketServer/main.cpp new file mode 100755 index 0000000..43f855c --- /dev/null +++ b/code/websocketServer/main.cpp @@ -0,0 +1,338 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#include "program_options.h" + +#include +#include +#include +#include + +#include +#include + + +#include "IQSource/IQSource_SoapySDR.h" +#include "Decoder/Decoder.h" +#include "common/console_colors.h" +#include "GLOBALS.h" +#include "server.h" + + +bool G_DO_EXIT = false; + +using namespace std; + + +void PrintDevicesList(const SoapySDR::KwargsList& device_list) +{ + int DEV_NUM = 0; + cout< sampling_rates = p_device->listSampleRates(SOAPY_SDR_RX, 0); + sort(sampling_rates.begin(), sampling_rates.end()); + + cout<<"\tSampling Rates:"<= int(device_list.size()) ) + { + cout<setOption("SoapySDR_Kwargs", &device); + + if( !GLOBALS::get().p_iq_source_->init() ) + { + cout<setOption("frequency_double", &freq); + double gain = GLOBALS::get().gain_; + GLOBALS::get().p_iq_source_->setOption("gain_double", &gain); + double biastee = GLOBALS::get().biast_; + GLOBALS::get().p_iq_source_->setOption("biastee_double", &biastee); + GLOBALS::get().p_iq_source_->setOption("sampling_rate_double", &GLOBALS::get().sampling_rate_); + + return true; +} + + +void DECODER_FEED_THREAD() +{ + using namespace std; + cout<<"Start DECODER_FEED_THREAD"<start()) + { + cout<isRunning()) + { + cout< samples; + samples.resize(256*256); + samples.samplingRate( p_iq_src->samplingRate() ); + + while(!G_DO_EXIT) + { + auto _start = std::chrono::high_resolution_clock::now(); + + size_t count = p_iq_src->get( samples.data(), samples.size() ); + DECODER.pushSamples(samples); + DECODER(); // DECODE ! + + // AFC - don't do this too often. Too unstable, needs more work. + static auto last_afc_time = std::chrono::high_resolution_clock::now(); + if( std::chrono::duration_cast< std::chrono::seconds > + (std::chrono::high_resolution_clock::now() - last_afc_time).count() > 5 + ) + { + double freq_corr = DECODER.getFrequencyCorrection(); + if(GLOBALS::get().afc_) + { + if( 100 < abs(freq_corr) ) + { + GLOBALS::get().frequency_ += freq_corr; + double f = GLOBALS::get().frequency_; + p_iq_src->setOption("frequency_double", &f); + DECODER.resetFrequencyCorrection(freq_corr); + last_afc_time = std::chrono::high_resolution_clock::now(); + + // notify webgui + { + lock_guard _lock( GLOBALS::get().out_commands_mtx_ ); + GLOBALS::get().out_commands_.emplace_back("cmd::set:frequency=" + to_string(f / 1e6)); + } + } + } + } + + + TDur _duration = std::chrono::duration_cast(std::chrono::high_resolution_clock::now() - _start); + + // accumulate demod samples to display more + { + std::lock_guard _lock(GLOBALS::get().demod_accumulated_mtx_); + + const size_t max_sz = DECODER.getDecimatedSamplingRate() / + DECODER.getSymbolRate() * 50; // 50 symbols + + auto demod = DECODER.getDemodulated(); + auto& demod_acc = GLOBALS::get().demod_accumulated_; + demod_acc.insert( demod_acc.end(), demod.cbegin(), demod.cend() ); + + // remove leading values + if( demod_acc.size() > max_sz) + demod_acc.erase( demod_acc.begin(), demod_acc.begin() + demod_acc.size() - max_sz ); + } + } +} + +void HAB_UPLOAD_THREAD() +{ + using namespace std; + + while(!G_DO_EXIT) + { + this_thread::sleep_for( chrono::duration(500) ); + + vector sentences; + { + lock_guard _lock( GLOBALS::get().senteces_to_log_mtx_ ); + sentences = move( GLOBALS::get().senteces_to_log_ ); + } + if(GLOBALS::get().station_callsign_ != "") + { + for(auto& sentence : sentences) + { + string cmd = "python ./habLogger.py "; + cmd += sentence; + cmd += " "; + cmd += GLOBALS::get().station_callsign_; + + auto res = system(cmd.c_str()); + cout<<"HAB upload res: "< + { + char do_thousands_sep() const { return ','; } + string do_grouping() const { return "\3"; } + }; + try{ + std::cout.imbue( std::locale(locale(""), new thousand_separators) ); + } + catch(exception& e) { + + } + + // setup GLOBALS + prog_opts(argc, argv); + + // setup SoapySDR device + if(!SetupDevice()) + { + cout< _lock( GLOBALS::get().senteces_to_log_mtx_ ); + GLOBALS::get().senteces_to_log_.emplace_back( callsign + "," + data + "*" + crc ); + } + { + lock_guard _lock( GLOBALS::get().senteces_to_web_mtx_ ); + GLOBALS::get().senteces_to_web_.emplace_back( callsign + "," + data + "*" + crc ); + } + GLOBALS::DumpToFile("./habdecWebsocketServer.opts"); + }; + + // feed decoder with IQ samples + std::thread* decoder_feed_thread = new std::thread(DECODER_FEED_THREAD); + + // HAB upload + std::thread* hab_upload_thread = new std::thread(HAB_UPLOAD_THREAD); + + // websocket server thread. this call is blocking + RunCommandServer( GLOBALS::get().command_host_ , GLOBALS::get().command_port_ ); + + G_DO_EXIT = true; + decoder_feed_thread->join(); + hab_upload_thread->join(); + + return 0; +} diff --git a/code/websocketServer/program_options.cpp b/code/websocketServer/program_options.cpp new file mode 100644 index 0000000..ededf64 --- /dev/null +++ b/code/websocketServer/program_options.cpp @@ -0,0 +1,193 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + + +#include +#include +#include +#include + +#include + +#include "GLOBALS.h" +#include "common/console_colors.h" + +void prog_opts(int ac, char* av[]) +{ + namespace po = boost::program_options; + using namespace std; + + try + { + po::options_description generic("CLI opts"); + generic.add_options() + ("help", "Display help message") + ("device", po::value()->default_value(-1), "SDR Device Numer") + ("sampling_rate", po::value()->default_value(0), "Sampling Rate, as supported by device") + + ("port", po::value()->default_value("5555"), "Command Port, example: --port 127.0.0.1:5555") + ("station", po::value()->default_value(""), "HABHUB station callsign") + + ("freq", po::value(), "frequency in MHz") + ("gain", po::value(), "gain") + ("print", po::value(), "live print received chars, values: 0, 1") + ("rtty", po::value< std::vector >()->multitoken(), "rtty: baud bits stops, example: -rtty 300 8 2") + ("biast", po::value(), "biasT, values: 0, 1") + ("bias_t", po::value(), "biasT, values: 0, 1") + ("afc", po::value(), "Auto Frequency Correction, values: 0, 1") + ; + + po::options_description cli_options("Command Line Interface options"); + cli_options.add(generic); + + string config_file; + cli_options.add_options() + ("config", po::value(&config_file), "Last run config file. Autosaved on every successfull decode."); + // ("config", po::value(&config_file)->default_value("./habdecWebsocketServer.opts"), "Last run config file. Autosaved on every successfull decode."); + + po::options_description file_options; + file_options.add(generic); + + po::variables_map vm; + store( po::command_line_parser(ac, av).options(cli_options).allow_unregistered().run(), vm ); + notify(vm); + + if(vm.count("help")) + { + cout<(); + } + if (vm.count("sampling_rate")) + { + GLOBALS::get().sampling_rate_ = vm["sampling_rate"].as(); + } + if (vm.count("port")) // [host:][port] + { + smatch match; + regex_match( vm["port"].as(), match, std::regex(R"_(([\w\.]*)(\:?)(\d*))_") ); + + if(match.size() == 4) + { + if(match[2] == "" && match[3] == "") // special case when only port is given: --port 5555 + { + GLOBALS::get().command_port_ = stoi(match[1]); + } + else + { + if(match[1] != "") GLOBALS::get().command_host_ = match[1]; + if(match[3] != "") GLOBALS::get().command_port_ = stoi(match[3]); + } + } + } + if (vm.count("station")) + { + GLOBALS::get().station_callsign_ = vm["station"].as(); + } + if (vm.count("freq")) + { + GLOBALS::get().frequency_ = vm["freq"].as() * 1e6; + } + if (vm.count("gain")) + { + GLOBALS::get().gain_ = vm["gain"].as(); + } + if (vm.count("print")) + { + GLOBALS::get().live_print_ = vm["print"].as(); + } + if (vm.count("biast")) + { + GLOBALS::get().biast_ = vm["biast"].as(); + } + if (vm.count("bias_t")) + { + GLOBALS::get().biast_ = vm["bias_t"].as(); + } + if (vm.count("afc")) + { + GLOBALS::get().afc_ = vm["afc"].as(); + } + if (vm.count("rtty")) + { + vector rtty_tokens = vm["rtty"].as< vector >(); + if( rtty_tokens.size() != 3 ) + { + cout<. +*/ + +#pragma once +void prog_opts(int ac, char* av[]); diff --git a/code/websocketServer/server.cpp b/code/websocketServer/server.cpp new file mode 100755 index 0000000..138c8fc --- /dev/null +++ b/code/websocketServer/server.cpp @@ -0,0 +1,471 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#include + +#include +#include +#include +#include +#include +#include + +#include +#include +#include +using boost::asio::ip::tcp; +namespace beast = boost::beast; +namespace websocket = boost::beast::websocket; + + +#include "common/console_colors.h" +#include "CompressedVector.h" +#include "GLOBALS.h" +#include "NetTransport.h" + +extern bool G_DO_EXIT; + + +bool HandleCommand(const std::string i_command, websocket::stream& ws) +{ + if(!GLOBALS::get().p_iq_source_) + return false; + + using namespace std; + smatch match; + + // GET + if(i_command == "get:frequency") + { + double frequency = 0; + GLOBALS::get().p_iq_source_->getOption("frequency_double", &frequency); + frequency /= 1e6; + string o_command = "cmd::set:frequency=" + to_string(frequency); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:gain") + { + double gain = 0; + GLOBALS::get().p_iq_source_->getOption("gain_double", &gain); + string o_command = "cmd::set:gain=" + to_string(gain); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:baud") + { + size_t baud = GLOBALS::get().decoder_.baud(); + string o_command = "cmd::set:baud=" + to_string(baud); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:rtty_bits") + { + size_t rtty_bits = GLOBALS::get().decoder_.rtty_bits(); + string o_command = "cmd::set:rtty_bits=" + to_string(rtty_bits); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:rtty_stops") + { + float rtty_stops = GLOBALS::get().decoder_.rtty_stops(); + string o_command = "cmd::set:rtty_stops=" + to_string(rtty_stops); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:lowpass_bw") + { + string o_command = "cmd::set:lowpass_bw=" + to_string(GLOBALS::get().decoder_.lowpass_bw()); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:lowpass_trans") + { + string o_command = "cmd::set:lowpass_trans=" + to_string(GLOBALS::get().decoder_.lowpass_trans()); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:biastee") + { + double biastee = 0; + GLOBALS::get().p_iq_source_->getOption("biastee_double", &biastee); + string o_command = "cmd::set:biastee=" + to_string(biastee); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:afc") + { + string o_command = "cmd::set:afc=" + to_string(GLOBALS::get().afc_); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:decimation") + { + int decim_factor_log = std::log2( GLOBALS::get().decoder_.getDecimationFactor() ); + string o_command = "cmd::set:decimation=" + to_string(decim_factor_log); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if(i_command == "get:sampling_rate") + { + double sr = 0; + GLOBALS::get().p_iq_source_->getOption("sampling_rate_double", &sr); + string o_command = "cmd::info:sampling_rate=" + to_string(sr); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + // SET + else if( regex_match(i_command, match, regex(R"_(set\:frequency=([+-]?([0-9]*[.])?[0-9]+))_")) && match.size() > 1 ) + { + double frequency = stod(match[1]); + frequency *= 1e6; + GLOBALS::get().p_iq_source_->setOption("frequency_double", &frequency); + GLOBALS::get().frequency_ = frequency; + + string o_command = "cmd::set:frequency=" + to_string(frequency/1e6); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:decimation=(\d+))_")) && match.size() > 1 ) + { + int decim_factor_log = stoi(match[1]); + GLOBALS::get().decoder_.setupDecimationStagesFactor( pow(2,decim_factor_log) ); + string o_command = "cmd::set:decimation=" + to_string(decim_factor_log); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:gain=([+-]?([0-9]*[.])?[0-9]+))_")) && match.size() > 1 ) + { + double gain = stod(match[1]); + GLOBALS::get().p_iq_source_->setOption("gain_double", &gain); + string o_command = "cmd::set:gain=" + to_string(gain); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + GLOBALS::get().gain_ = gain; + } + else if( regex_match(i_command, match, regex(R"_(set\:lowpass_bw=([+-]?([0-9]*[.])?[0-9]+))_")) && match.size() > 1 ) + { + cout<<"set lowpass_bw "< 1 ) + { + GLOBALS::get().decoder_.lowpass_trans(stof(match[1])); + string o_command = "cmd::set:lowpass_trans=" + to_string(GLOBALS::get().decoder_.lowpass_trans()); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:baud=([+-]?([0-9]*[.])?[0-9]+))_")) && match.size() > 1 ) + { + GLOBALS::get().decoder_.baud( stof(match[1]) ); + string o_command = "cmd::set:baud=" + to_string(GLOBALS::get().decoder_.baud()); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:rtty_bits=(\d+))_")) && match.size() > 1 ) + { + GLOBALS::get().decoder_.rtty_bits(stoi(match[1])); + string o_command = "cmd::set:rtty_bits=" + to_string(GLOBALS::get().decoder_.rtty_bits()); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:rtty_stops=([+-]?([0-9]*[.])?[0-9]+))_")) && match.size() > 1 ) + { + GLOBALS::get().decoder_.rtty_stops(stof(match[1])); + string o_command = "cmd::set:rtty_stops=" + to_string(GLOBALS::get().decoder_.rtty_stops()); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:datasize=(\d+))_")) && match.size() > 1 ) + { + int datasize = stoi(match[1]); + if(datasize != 1 && datasize != 2 && datasize != 4) + datasize = 1; + + if(datasize == 1) GLOBALS::get().transport_data_type_ = GLOBALS::TransportDataType::kChar; // 8bit + if(datasize == 2) GLOBALS::get().transport_data_type_ = GLOBALS::TransportDataType::kShort;// 16 bit + if(datasize == 4) GLOBALS::get().transport_data_type_ = GLOBALS::TransportDataType::kFloat;// 32bit + string o_command = "cmd::set:datasize=" + to_string(datasize); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:biastee=([0-9])+)_")) && match.size() > 1 ) + { + double value = stod(match[1]); + GLOBALS::get().p_iq_source_->setOption("biastee_double", &value); + GLOBALS::get().biast_ = value; + string o_command = "cmd::set:biastee=" + to_string(value); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else if( regex_match(i_command, match, regex(R"_(set\:afc=([0-9])+)_")) && match.size() > 1 ) + { + int value = stoi(match[1]); + GLOBALS::get().afc_ = value; + string o_command = "cmd::set:afc=" + to_string(value); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + else + { + cout< +void ShrinkVector(T& vec, size_t new_size) +{ + if(new_size >= vec.size()) + return; + + for(size_t i=0; i spectrum_info.size()) + { + spectrum_info.peak_left_ = 0; + spectrum_info.peak_left_valid_ = false; + } + + spectrum_info.peak_right_ -= zoom_slice_begin; + if(spectrum_info.peak_right_ < 0 || spectrum_info.peak_right_ > spectrum_info.size()) + { + spectrum_info.peak_right_ = 0; + spectrum_info.peak_right_valid_ = false; + } + + // transfer resolution - leave only 'resolution' number of bins + // + if(resolution < spectrum_info.size()) + { + spectrum_info.peak_left_ = double(spectrum_info.peak_left_) * resolution / spectrum_info.size(); + spectrum_info.peak_right_ = double(spectrum_info.peak_right_) * resolution / spectrum_info.size(); + ShrinkVector(spectrum_info, resolution); + } + + // choose transport bit resolution: 8, 16, 32 bit + // + if( GLOBALS::get().transport_data_type_ == GLOBALS::TransportDataType::kChar ) + SerializeSpectrum( spectrum_info, res_stream, (unsigned char*)0 ); + if( GLOBALS::get().transport_data_type_ == GLOBALS::TransportDataType::kShort ) + SerializeSpectrum( spectrum_info, res_stream, (unsigned short int*)0 ); + if( GLOBALS::get().transport_data_type_ == GLOBALS::TransportDataType::kFloat ) + SerializeSpectrum( spectrum_info, res_stream, (float*)0 ); + + return spectrum_info.size(); +} + + +// serialize demod +size_t DemodToStream(std::stringstream& res_stream, int resolution) +{ + std::vector demod_acc; + { + std::lock_guard _lock(GLOBALS::get().demod_accumulated_mtx_); + demod_acc = GLOBALS::get().demod_accumulated_; + } + if(demod_acc.size()) + { + ShrinkVector(demod_acc, resolution); + // choose transport datatype: 8, 16, 32 bit + if( GLOBALS::get().transport_data_type_ == GLOBALS::TransportDataType::kChar ) + SerializeDemodulation( demod_acc, res_stream, (unsigned char*)0 ); + if( GLOBALS::get().transport_data_type_ == GLOBALS::TransportDataType::kShort ) + SerializeDemodulation( demod_acc, res_stream, (unsigned short int*)0 ); + if( GLOBALS::get().transport_data_type_ == GLOBALS::TransportDataType::kFloat ) + SerializeDemodulation( demod_acc, res_stream, (float*)0 ); + } + + return demod_acc.size(); +} + +void DoSession(tcp::socket& i_socket) +{ + using namespace std; + + // allow just one session + static std::atomic close_session{false}; + static std::atomic session_running{false}; + + // close previous session + while(session_running) + { + close_session = true; + std::this_thread::sleep_for( ( std::chrono::duration(300) )); + } + + try { + websocket::stream ws{std::move(i_socket)}; + ws.accept(); + session_running = true; + // this line does not work + // ws.accept_ex([](websocket::response_type &m) { m.insert(beast::http::field::server, "habdec_server"); }); + + ws.auto_fragment(false); + + while(!G_DO_EXIT) + { + if(close_session) + { + cout<<"Closing Session."< 2 ) + { + stringstream res_stream; + res_stream<<"PWR_"; + if(SpectrumToStream( res_stream, stof(match[2]), stoi(match[1]) )) + { + ws.binary(true); + ws.write( boost::asio::buffer(res_stream.str()) ); + } + } + // demod=resolution + else if( regex_match(command, match, regex(R"_(cmd\:\:demod\:res=(\d+))_")) && match.size() > 1 ) + { + stringstream res_stream; + res_stream<<"DEM_"; + if( DemodToStream( res_stream, stoi(match[1]) ) ) + { + ws.binary(true); + ws.write( boost::asio::buffer(res_stream.str()) ); + } + } + // cmd::liveprint + else if( regex_match(command, match, regex(R"_(cmd\:\:liveprint)_")) && match.size() > 0 ) + { + string o_command = "cmd::info:liveprint=" + GLOBALS::get().decoder_.getRTTY(); + ws.text(true); + ws.write( boost::asio::buffer(o_command.c_str(), o_command.size()) ); + } + // cmd::**** + else if(command.size()>5 && command.substr(0,5) == "cmd::") + { + cout< sentences; + { + lock_guard _lock( GLOBALS::get().senteces_to_web_mtx_ ); + sentences = std::move(GLOBALS::get().senteces_to_web_); + } + for(auto& sentence : sentences) + { + string o_command = "cmd::info:sentence=" + sentence; + ws.text(true); + ws.write( boost::asio::buffer( o_command.c_str(), o_command.size()) ); + } + + // check for out commands + vector out_cmds; + { + lock_guard _lock( GLOBALS::get().out_commands_mtx_ ); + out_cmds = std::move(GLOBALS::get().out_commands_); + } + for(auto& cmd : out_cmds) + { + ws.text(true); + ws.write( boost::asio::buffer( cmd.c_str(), cmd.size()) ); + } + + } + } + catch(const boost::system::system_error& se) { + if(se.code() != websocket::error::closed) + cout << "Error: boost::system::system_error: " << se.code().message() << endl; + else + cout << "Session Closed. " << se.code().message() << endl; + + } + catch(const exception& e) { + cout << "Session Error: " << e.what() << endl; + } + + session_running = false; + cout << "Session END."<( command_port ); + + boost::asio::io_context ioc{1}; + tcp::acceptor acceptor{ioc, {address, port}}; + + while(!G_DO_EXIT) + { + + tcp::socket socket{ioc}; + acceptor.accept(socket); // Block until we get a connection + cout<(1000) )); + } + } +} \ No newline at end of file diff --git a/code/websocketServer/server.h b/code/websocketServer/server.h new file mode 100644 index 0000000..80678f3 --- /dev/null +++ b/code/websocketServer/server.h @@ -0,0 +1,26 @@ +/* + + Copyright 2018 Michal Fratczak + + This file is part of habdec. + + habdec is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + habdec 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 General Public License for more details. + + You should have received a copy of the GNU General Public License + along with habdec. If not, see . +*/ + +#pragma once + +#include +#include + +void RunCommandServer(const std::string command_host, const int command_port); diff --git a/webClientScreenshot.png b/webClientScreenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..01d066812dd060b5cbb9dfc347e9b3af8a1674df GIT binary patch literal 249086 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

Z}ln%r>b5wc4&i`_|@UZyT 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 B4i*Ibv}Y#yTn;GjRi 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 #s^cv@Qhr5WN%hlNx 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≠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