2011-06-20 01:12:35 +00:00
|
|
|
#!/bin/bash
|
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# Builds Hamlib 3.x W64 binary distribution.
|
2012-10-07 13:31:10 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# A script to build a set of W64 binary DLLs from a Hamlib tarball.
|
2011-06-20 01:12:35 +00:00
|
|
|
# This script assumes that the Hamlib tarball has been extracted to the
|
2013-10-31 03:29:50 +00:00
|
|
|
# directory specified in $BUILD_DIR and that libusb-win32-bin-1.x.y.z has also
|
|
|
|
# been extracted to $BUILD_DIR. The MS VC++Toolkit must also be installed
|
|
|
|
# and working with Wine.
|
2011-06-20 01:12:35 +00:00
|
|
|
#
|
2018-07-30 02:56:55 +00:00
|
|
|
# Requires libusb-1.0 to be accessible for USB backends to be built.
|
|
|
|
|
|
|
|
# See README.build-w64 for complete details.
|
2011-06-20 01:12:35 +00:00
|
|
|
|
|
|
|
|
|
|
|
# Set this to a desired directory
|
|
|
|
BUILD_DIR=~/builds
|
|
|
|
|
|
|
|
# Set this to LibUSB archive extracted in $BUILD_DIR
|
2018-07-30 02:56:55 +00:00
|
|
|
LIBUSB_VER=libusb-1.0.20
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2013-10-31 03:29:50 +00:00
|
|
|
# uncomment the correct HOST_ARCH= line for your minGW installation
|
2018-07-30 02:56:55 +00:00
|
|
|
HOST_ARCH=x86_64-w64-mingw32
|
2013-10-31 03:29:50 +00:00
|
|
|
|
|
|
|
# Set to the strip name for your version of minGW
|
2018-07-30 02:56:55 +00:00
|
|
|
HOST_ARCH_STRIP=x86_64-w64-mingw32-strip
|
2011-06-20 01:12:35 +00:00
|
|
|
|
|
|
|
# Error return codes. See /usr/include/sysexits.h
|
|
|
|
EX_USAGE=64
|
|
|
|
EX_NOINPUT=66
|
|
|
|
|
|
|
|
|
|
|
|
# Pass name of Hamlib archive extracted in $BUILD_DIR
|
|
|
|
if [ $# -ne 1 ]; then
|
|
|
|
echo -e "\nUsage: `basename $0` hamlib-version\n"
|
2018-07-30 02:56:55 +00:00
|
|
|
echo -e "See README.build-w64 for more information.\n"
|
|
|
|
exit ${EX_USAGE}
|
2011-06-20 01:12:35 +00:00
|
|
|
fi
|
|
|
|
|
|
|
|
# Make sure the Hamlib archive is where we expect
|
|
|
|
if [ -d ${BUILD_DIR}/$1 ]; then
|
2018-07-30 02:56:55 +00:00
|
|
|
echo -e "\nBuilding w64 binaries in ${BUILD_DIR}/$1\n\n"
|
2011-06-20 01:12:35 +00:00
|
|
|
cd ${BUILD_DIR}/$1
|
|
|
|
else
|
|
|
|
echo -e "\nBuild directory, ${BUILD_DIR}/$1 not found!\nCheck path for $1 or correct the version number.\n"
|
|
|
|
exit $EX_NOINPUT
|
|
|
|
fi
|
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
RELEASE=`/usr/bin/awk 'BEGIN{FS="["; RS="]"} /\[3\./ {print $2;exit}' ./configure.ac`
|
|
|
|
HL_FILENAME=hamlib-w64-${RELEASE}
|
|
|
|
INST_DIR=`pwd`/mingw64-inst
|
|
|
|
ZIP_DIR=`pwd`/${HL_FILENAME}
|
|
|
|
LIBUSB_1_0_BIN_PATH=${BUILD_DIR}/${LIBUSB_VER}
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# Create W64 specific README.w64-bin file
|
|
|
|
cat > README.w64-bin <<END_OF_README
|
2011-06-21 02:35:06 +00:00
|
|
|
What is it?
|
|
|
|
===========
|
|
|
|
|
2012-10-07 13:31:10 +00:00
|
|
|
This ZIP archive or Windows installer contains a build of Hamlib-$RELEASE
|
2018-07-30 02:56:55 +00:00
|
|
|
cross-compiled for MS Windows 64 bit using MinGW under Debian GNU/Linux 8
|
2013-10-31 03:29:50 +00:00
|
|
|
(nice, heh!).
|
2011-06-21 02:35:06 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
NB: This Windows 64 bit release is EXPERIMENTAL! Some features such as USB
|
|
|
|
backends have been disabled at this time. Please report bugs, failures, and
|
|
|
|
success to the Hamlib mailing list below.
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
This software is copyrighted. The library license is LGPL, and the *.EXE
|
|
|
|
files licenses are GPL. Hamlib comes WITHOUT ANY WARRANTY. See the
|
|
|
|
LICENSE.txt, COPYING.txt, and COPYING.LIB.txt files.
|
|
|
|
|
2018-08-02 12:57:52 +00:00
|
|
|
A draft user manual in HTML format is included in the doc directory. Supporting
|
|
|
|
documentation in the form of Unix manual pages have also been included after
|
|
|
|
being converted to HTML.
|
2013-04-27 03:37:16 +00:00
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
|
|
|
|
Installation and Configuration
|
|
|
|
==============================
|
|
|
|
|
|
|
|
Extract the ZIP archive into a convenient location, C:\Program Files is a
|
|
|
|
reasonable choice.
|
|
|
|
|
|
|
|
Make sure *all* the .DLL files are in your PATH (leave them in the bin
|
|
|
|
directory and set the PATH). To set the PATH environment variable in
|
2018-07-30 02:56:55 +00:00
|
|
|
Windows 2000, Windows XP, and Windows 7 (need info on Vista and Windows 8/10)
|
2013-10-31 03:29:50 +00:00
|
|
|
do the following:
|
2012-10-07 13:31:10 +00:00
|
|
|
|
|
|
|
* W2k/XP: Right-click on "My Computer"
|
|
|
|
Win7: Right-click on "Computer"
|
|
|
|
|
|
|
|
* W2k/XP: Click the "Advanced" tab of the "System Properties" dialog
|
|
|
|
Win7: Click the "Advanced system settings" link in the System dialog
|
|
|
|
|
|
|
|
* Click the "Environment Variables" button of the pop-up dialog
|
2011-06-21 02:35:06 +00:00
|
|
|
|
|
|
|
* Select "Path" in the "System variables" box of the "Environment Variables"
|
|
|
|
dialog
|
2012-10-07 13:31:10 +00:00
|
|
|
|
|
|
|
NB: If you are not the administrator, system policy may not allow editing
|
|
|
|
the path variable. The complete path to an executable file will need to
|
|
|
|
be given to run one of the Hamlib programs.
|
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
* Click the Edit button
|
2012-10-07 13:31:10 +00:00
|
|
|
|
|
|
|
* Now add the Hamlib path in the "Variable Value:" edit box. Be sure to put
|
2011-06-21 02:35:06 +00:00
|
|
|
a semi-colon ';' after the last path before adding the Hamlib path (NB. The
|
|
|
|
entire path is highlighted and will be erased upon typing a character so
|
|
|
|
click in the box to unselect the text first. The PATH is important!!)
|
2018-07-30 02:56:55 +00:00
|
|
|
Append the Hamlib path, e.g. C:\Program Files\hamlib-w64-3.0~git\bin
|
2012-10-07 13:31:10 +00:00
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
* Click OK for all three dialog boxes to save your changes.
|
|
|
|
|
|
|
|
|
|
|
|
Testing with the Hamlib Utilities
|
|
|
|
=================================
|
|
|
|
|
|
|
|
To continue, be sure you have read the README.betatester file, especially
|
|
|
|
the "Testing Hamlib" section. The primary means of testing is by way of the
|
|
|
|
rigctl utility for radios and rotctl utility for rotators. Each is a command
|
|
|
|
line program that is interactive or can act on a single command and exit.
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2011-06-21 18:38:39 +00:00
|
|
|
Documentation for each utility can be found as a PDF in the pdf/ directory.
|
2011-06-21 02:35:06 +00:00
|
|
|
|
|
|
|
In short, the command syntax is of the form:
|
|
|
|
|
|
|
|
rigctl -m 120 -r COM1 -vvvvv
|
|
|
|
|
2012-10-07 13:31:10 +00:00
|
|
|
-m -> Radio model 120, or Yaesu FT-817 (use 'rigctl -l' for a list)
|
2011-06-21 02:35:06 +00:00
|
|
|
-r -> Radio device, in this case COM1
|
|
|
|
-v -> Verbosity level. For testing four or five v characters are required.
|
2012-10-07 13:31:10 +00:00
|
|
|
Five 'v's set a debug level of TRACE which generates a lot of screen
|
2011-06-21 02:35:06 +00:00
|
|
|
output showing communication to the radio and values of important
|
2011-06-21 18:38:39 +00:00
|
|
|
variables. These traces are vital information for Hamlib rig backend
|
|
|
|
development.
|
2011-06-21 02:35:06 +00:00
|
|
|
|
|
|
|
To run rigctl or rotctl open a cmd window (Start|Run|enter 'cmd' in the dialog).
|
|
|
|
If text scrolls off the screen, you can scroll back with the mouse. To copy
|
|
|
|
output text into a mailer or editor (I recommend Notepad++, a free editor also
|
|
|
|
licensed under the GPL), highlight the text as a rectangle in the cmd window,
|
|
|
|
press <Enter> (or right-click the window icon in the upper left corner and
|
|
|
|
select Edit, then Copy), and paste it into your editor with Ctl-V (or
|
|
|
|
Edit|Paste from the typical GUI menu).
|
|
|
|
|
|
|
|
All feedback is welcome to the mail address below.
|
|
|
|
|
|
|
|
|
2012-10-07 13:31:10 +00:00
|
|
|
Uninstall
|
|
|
|
=========
|
|
|
|
|
|
|
|
To uninstall, simply delete the Hamlib directory. You may wish to edit the
|
|
|
|
PATH as above to remove the Hamlib bin path, if desired.
|
|
|
|
|
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
Information for w64 Programmers
|
2011-06-21 02:35:06 +00:00
|
|
|
=================================
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2011-06-21 18:38:39 +00:00
|
|
|
As the source code for the library DLLs is licensed under the LGPL, your
|
|
|
|
program is not considered a "derivative work" when using the published
|
|
|
|
Hamlib API and normal linking to the front-end library, and may be of a
|
|
|
|
license of your choosing. The published Hamlib API may be found at:
|
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
http://hamlib.sourceforge.net/manuals/1.2.15/index.html
|
|
|
|
|
|
|
|
(The 3.0 API is unchanged although new documentation will be forthcoming.)
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
|
|
|
|
Thank You!
|
|
|
|
==========
|
|
|
|
|
2011-06-20 01:12:35 +00:00
|
|
|
Patches, feedback, and contributions are welcome.
|
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
Please report problems or success to hamlib-developer@lists.sourceforge.net
|
2011-06-20 01:12:35 +00:00
|
|
|
|
|
|
|
Cheers,
|
|
|
|
Stephane Fillod - F8CFE
|
|
|
|
Nate Bargmann - N0NB
|
|
|
|
http://www.hamlib.org
|
|
|
|
|
|
|
|
END_OF_README
|
|
|
|
|
2011-06-21 02:35:06 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# Configure and build hamlib for x86_64-w64-mingw32, with libusb-1.0
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2013-10-31 03:29:50 +00:00
|
|
|
./configure --host=${HOST_ARCH} \
|
2018-07-30 02:56:55 +00:00
|
|
|
--prefix=${INST_DIR} \
|
2011-06-20 01:12:35 +00:00
|
|
|
--without-cxx-binding \
|
2013-10-31 03:29:50 +00:00
|
|
|
--disable-static \
|
2018-07-30 02:56:55 +00:00
|
|
|
CPPFLAGS="-I${LIBUSB_1_0_BIN_PATH}/include" \
|
|
|
|
LDFLAGS="-L${LIBUSB_1_0_BIN_PATH}/MinGW64/dll"
|
2013-10-31 03:29:50 +00:00
|
|
|
|
2011-06-20 01:12:35 +00:00
|
|
|
|
|
|
|
make install
|
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
mkdir -p ${ZIP_DIR}/bin ${ZIP_DIR}/lib/gcc ${ZIP_DIR}/include ${ZIP_DIR}/doc ${ZIP_DIR}/lib/msvc # ${ZIP_DIR}/pdf
|
2011-06-20 01:12:35 +00:00
|
|
|
cp -a src/libhamlib.def ${ZIP_DIR}/lib/msvc/libhamlib-2.def; todos ${ZIP_DIR}/lib/msvc/libhamlib-2.def
|
|
|
|
cp -a ${INST_DIR}/include/hamlib ${ZIP_DIR}/include/.; todos ${ZIP_DIR}/include/hamlib/*.h
|
2013-04-27 03:37:16 +00:00
|
|
|
cp -a doc/Hamlib_design.png ${ZIP_DIR}/doc
|
|
|
|
cp -a doc/hamlib.html ${ZIP_DIR}/doc
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# C++ binding is useless on w64 because of ABI
|
2011-06-20 01:12:35 +00:00
|
|
|
rm ${ZIP_DIR}/include/hamlib/{rig,rot}class.h
|
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
for f in AUTHORS ChangeLog COPYING COPYING.LIB LICENSE README README.betatester README.w64-bin THANKS ; do \
|
2012-10-11 14:17:58 +00:00
|
|
|
cp -a ${f} ${ZIP_DIR}/${f}.txt ; todos ${ZIP_DIR}/${f}.txt ; done
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# Generate HTML documents from nroff formatted man files
|
2018-08-02 12:57:52 +00:00
|
|
|
for f in doc/man1/*.1 doc/man7/*.7; do \
|
2018-07-30 02:56:55 +00:00
|
|
|
/usr/bin/groff -mandoc -Thtml >${f}.html ${f}
|
|
|
|
cp -a ${f}.html ${ZIP_DIR}/doc/. ; done
|
2011-06-21 18:38:39 +00:00
|
|
|
|
|
|
|
cd ${BUILD_DIR}/$1
|
|
|
|
|
2011-06-20 01:12:35 +00:00
|
|
|
# Copy build files into specific locations for Zip file
|
|
|
|
cp -a ${INST_DIR}/bin/{rigctld.exe,rigctl.exe,rigmem.exe,rigsmtr.exe,rigswr.exe,rotctld.exe,rotctl.exe} ${ZIP_DIR}/bin/.
|
|
|
|
cp -a ${INST_DIR}/bin/libhamlib-?.dll ${ZIP_DIR}/bin/.
|
|
|
|
cp -a ${INST_DIR}/lib/libhamlib.dll.a ${ZIP_DIR}/lib/gcc/.
|
|
|
|
|
2013-10-31 03:29:50 +00:00
|
|
|
# NB: Strip Hamlib DLLs and EXEs
|
|
|
|
${HOST_ARCH_STRIP} ${ZIP_DIR}/bin/*.exe ${ZIP_DIR}/bin/*hamlib-*.dll
|
|
|
|
|
|
|
|
# Copy needed third party DLLs
|
2018-07-30 02:56:55 +00:00
|
|
|
cp -a /usr/x86_64-w64-mingw32/lib/libwinpthread-1.dll ${ZIP_DIR}/bin/.
|
|
|
|
cp -a ${LIBUSB_1_0_BIN_PATH}/MinGW64/dll/libusb-1.0.dll ${ZIP_DIR}/bin/libusb-1.0.dll
|
2011-06-20 01:12:35 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
# Required for MinGW with GCC 4.9
|
|
|
|
cp -a /usr/lib/gcc/x86_64-w64-mingw32/4.9-posix/libgcc_s_seh-1.dll ${ZIP_DIR}/bin/libgcc_s_seh-1.dll
|
2013-10-31 03:29:50 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
## Need VC++ free toolkit installed (default Wine directory installation shown)
|
|
|
|
( cd ${ZIP_DIR}/lib/msvc/ && wine ~/.wine/drive_c/Program\ Files/Microsoft\ Visual\ C++\ Toolkit\ 2003/bin/link.exe /lib /machine:amd64 /def:libhamlib-2.def )
|
2012-10-07 13:31:10 +00:00
|
|
|
|
2018-07-30 02:56:55 +00:00
|
|
|
zip -r ${HL_FILENAME}.zip `basename ${ZIP_DIR}`
|