mirror of https://github.com/wb2osz/direwolf.git
				
				
				
			| this step unify the builing system for all platforms (windows, linux,
osx and *BSD)
* Requirements:
  - gcc/clang (C/C++ compiler) (in debian build-essential)
  - cmake (in debian cmake)
  - git if you build from source (in debian git)
  - posix threads
** Requirements on *BSD/macOS:
  - portaudio
** Optional Requirements:
  - gpsd (in debian libgps-dev)
  - libhamlib (in debian libhamlib-dev)
** Optional Requirements in Linux
  - udev (in debian libudev-dev)
  - alsa (in debian libasound2-dev)
* Main changes:
  - version is now set only on CMakeLists.txt and automatically used
    on the code
  - cpu flags are auto-discovered in the default build and it works
    on gcc/clang/msvc on x86/x86_64/arm; you can force cpu flags with
    -DFORCE_SSE=1 for example (see CMakeLists.txt on root)
  - use a more "complex" tag on generic.conf to facilitate parsing
    by cmake (not more platform dependent). Now it is %C% or %R% for
    example
  - target `tocalls-symbols` is now called `data-update`
  - created debian/ directory to contains files to use debuild
* Example to build:
mkdir build && cd build
cmake ..
make
make install
make install-conf
then you have the binary files on src/ and in the system directory
* CMake options (see the head of CMakeLists.txt)
  - FORCE_SSE force sse instruction
  - FORCE_SSSE3 force ssse3 instruction
  - FORCE_SSE41 force ssse4.1 instruction
  - OPTIONAL_TEST compile optional test (might be broken)
  - BUILD_TESTING enable tests (ctest framework)
  - CMAKE_INSTALL_PREFIX if you want to change your install path
    prefix
for example:
  cmake .. -DOPTIONAL_TEST=ON | ||
|---|---|---|
| .. | ||
| test_arm_neon.cxx | ||
| test_x86_avx.cxx | ||
| test_x86_avx2.cxx | ||
| test_x86_avx512.cxx | ||
| test_x86_sse2.cxx | ||
| test_x86_sse3.cxx | ||
| test_x86_sse41.cxx | ||
| test_x86_sse42.cxx | ||
| test_x86_ssse3.cxx | ||