Hamlib/android/README.android

Update Note:
These Android NDK scripts can compile the 4.3 version of hamlib normally, but they may be corrupted as the master branch code is updated. If you encounter compile-time errors, please try to fix them, or choose to recompile with version 4.3.

This is android port of hamlib
(C) 2012 Ladislav Vaiz <ok1zia@nagano.cz>

Notes:
* use hamlib-compile script to build hamlib for android
* script deletes file include/config.h, it conflicts with android/config.h
* android port implements ltdl interface and calls dlfcn functions directly
* RPC is not present on android
* ARS backend is compiled without pthreads because of deprecated pthread_cancel
* I don'k know how to connect to real radio:
** Bluetooth API is available only under Java, not from native code
** FTDI USB to serial converter driver is not included in standard kernel. It should work on rooted device.
** But NET rigctl works fine
* Backends are named libhamlib-vendor.so, I don't know how to include libraries without lib prefix into APK
* Check the location of libusb.h and define the corresponding macro accordingly in config.h.
* Had to build without libusb as ndk did not contain it
** comment out HAVE_LIBUSB_H in android/config.h if you get libusb errors

Happy hacking
73 Lada, OK1ZIA
Update README.android 2021-09-07 15:07:41 +00:00			`Update Note:`
			`These Android NDK scripts can compile the 4.3 version of hamlib normally, but they may be corrupted as the master branch code is updated. If you encounter compile-time errors, please try to fix them, or choose to recompile with version 4.3.`

Add Android build support Android makefile fragments are distributed as extra distribution files by the GNU build system but are otherwise ignored. The Android build support is independent and does not rely on the GNU build system. See android/README.android for more info. Signed-off-by: Nate Bargmann <n0nb@n0nb.us> 2012-12-19 11:59:59 +00:00			`This is android port of hamlib`
			`(C) 2012 Ladislav Vaiz <ok1zia@nagano.cz>`

			`Notes:`
			`* use hamlib-compile script to build hamlib for android`
			`* script deletes file include/config.h, it conflicts with android/config.h`
			`* android port implements ltdl interface and calls dlfcn functions directly`
			`* RPC is not present on android`
			`* ARS backend is compiled without pthreads because of deprecated pthread_cancel`
			`* I don'k know how to connect to real radio:`
			`** Bluetooth API is available only under Java, not from native code`
			`** FTDI USB to serial converter driver is not included in standard kernel. It should work on rooted device.`
			`** But NET rigctl works fine`
			`* Backends are named libhamlib-vendor.so, I don't know how to include libraries without lib prefix into APK`
Check for libusb-1.0/libusb.h Some distributions--Debian and Alpine tested--put libusb.h under the libusb-1.0 directory. Test for its presence and if found define HAVE_LIBUSB_1_0_LIBUSB_H. Also test for HAVE_LIBUSB or HAVE_LIBUSB_1_0_LIBUSB_H and conditionally include the correct header file in the sources. 2016-02-15 14:10:07 +00:00			`* Check the location of libusb.h and define the corresponding macro accordingly in config.h.`
Android NDK now builds -- check README.android for info on libusb https://github.com/Hamlib/Hamlib/issues/546 2021-02-28 14:50:36 +00:00			`* Had to build without libusb as ndk did not contain it`
			`** comment out HAVE_LIBUSB_H in android/config.h if you get libusb errors`
Add Android build support Android makefile fragments are distributed as extra distribution files by the GNU build system but are otherwise ignored. The Android build support is independent and does not rely on the GNU build system. See android/README.android for more info. Signed-off-by: Nate Bargmann <n0nb@n0nb.us> 2012-12-19 11:59:59 +00:00
			`Happy hacking`
			`73 Lada, OK1ZIA`