[sigrok-util.git] / cross-compile / mingw / README

-------------------------------------------------------------------------------
README
-------------------------------------------------------------------------------

This is a small script for cross-compiling sigrok and its dependencies
for MinGW-w64/Windows systems.


Status
------

Working.


Requirements
------------

 - bash
 - gcc
 - make
 - cmake
 - git
 - wget
 - p7zip
 - unzip
 - pkg-config (>= 0.22)
 - sdcc (needed for building the fx2lafw firmware)
 - nsis
 - MXE (*-w64-*.posix targets; *-pc-* and non-posix targets are not supported)


MXE setup
---------

First, get the MXE cross-compile environment for MinGW-w64/Windows:

 $ cd $HOME
 $ git clone https://github.com/mxe/mxe.git mxe-git
 $ cd mxe-git

Apply some fixes that are currently required for a proper build:

 $ patch -p1 < mxe_fixes.patch

Build all required packages:

 $ make MXE_TARGETS=i686-w64-mingw32.static.posix \
   MXE_PLUGIN_DIRS=plugins/examples/qt5-freeze \
   gcc glib libzip libusb1 libftdi1 hidapi glibmm qtbase qtimageformats
   qtsvg qttranslations boost check gendef qtbase_CONFIGURE_OPTS='-no-sql-mysql'

This will take a while.

You can also use "MXE_TARGETS=x86_64-w64-mingw32.static.posix" to build
64-bit installers instead.

See http://mxe.cc for details on MXE.

Note: We're "freezing" the Qt5 version to Qt 5.7.x, since that's the last
version that supports Windows XP (which we currently still want to support).


Building
--------

 $ ./sigrok-cross-mingw

Per default it expects MXE in:

 $HOME/mxe-git

Per default it will install the cross-compiled packages in:

 $HOME/sr_mingw_release_32

This depends on whether you're doing a 64-bit or 32-bit build, and whether
you enabled debug builds or not.

Please edit the script if you want to change any settings.
Commit	Line	Data
	1	-------------------------------------------------------------------------------
	2	README
	3	-------------------------------------------------------------------------------
	4
	5	This is a small script for cross-compiling sigrok and its dependencies
	6	for MinGW-w64/Windows systems.
	7
	8
	9	Status
	10	------
	11
	12	Working.
	13
	14
	15	Requirements
	16	------------
	17
	18	- bash
	19	- gcc
	20	- make
	21	- cmake
	22	- git
	23	- wget
	24	- p7zip
	25	- unzip
	26	- pkg-config (>= 0.22)
	27	- sdcc (needed for building the fx2lafw firmware)
	28	- nsis
	29	- MXE (-w64-.posix targets; -pc- and non-posix targets are not supported)
	30
	31
	32	MXE setup
	33	---------
	34
	35	First, get the MXE cross-compile environment for MinGW-w64/Windows:
	36
	37	$ cd $HOME
	38	$ git clone https://github.com/mxe/mxe.git mxe-git
	39	$ cd mxe-git
	40
	41	Apply some fixes that are currently required for a proper build:
	42
	43	$ patch -p1 < mxe_fixes.patch
	44
	45	Build all required packages:
	46
	47	$ make MXE_TARGETS=i686-w64-mingw32.static.posix \
	48	MXE_PLUGIN_DIRS=plugins/examples/qt5-freeze \
	49	gcc glib libzip libusb1 libftdi1 hidapi glibmm qtbase qtimageformats
	50	qtsvg qttranslations boost check gendef qtbase_CONFIGURE_OPTS='-no-sql-mysql'
	51
	52	This will take a while.
	53
	54	You can also use "MXE_TARGETS=x86_64-w64-mingw32.static.posix" to build
	55	64-bit installers instead.
	56
	57	See http://mxe.cc for details on MXE.
	58
	59	Note: We're "freezing" the Qt5 version to Qt 5.7.x, since that's the last
	60	version that supports Windows XP (which we currently still want to support).
	61
	62
	63	Building
	64	--------
	65
	66	$ ./sigrok-cross-mingw
	67
	68	Per default it expects MXE in:
	69
	70	$HOME/mxe-git
	71
	72	Per default it will install the cross-compiled packages in:
	73
	74	$HOME/sr_mingw_release_32
	75
	76	This depends on whether you're doing a 64-bit or 32-bit build, and whether
	77	you enabled debug builds or not.
	78
	79	Please edit the script if you want to change any settings.
	80