DIY Compiling WinUAE 2.0.x

[gilgamesh]

This is a recipe for those who want to build WinUAE 2.0.x from the ground up. Using Toni's libs&headers packs will make things a lot easier. I used the sources of a 2.0.2 beta.


The Tools

I used Visual Studio 2008 Express. You'll need the DirectX SDK, WDK, and Windows 7 SDK. Last but not least go and install Nasm.


Preparations

Install WinPcap, OpenAL and some Wacom driver for the wintab32.dll on your system.


Getting the Dependencies

The dependencies didn't change very much in comparison to the last version. Enet was introduced in adddition to

Originally Posted by gilgamesh

• OpenAL SDK
• zlib
• UnRAR Developer Files
• WinPcap Developer's Pack
• Freetype Developer's Files
• libpng-lib
• OpenGL *ext.h headers (go to gl/)
• TVPicPort
• Catweasel Driver
• Ghostscript+Source 8.70
• Portaudio
• FDRawCmd+Header
• G15 LCD SDK (get Driver Pack)
• Wacom Tablet SDK
• WinIO
• ParaPort.h (registration failed!)
• ASPI Header

(You may want to have a look at this.)

Fetch the stuff and create the directories winuae_include and winuae_libs. Install/unzip all you've got. I assume that you are going to extract all the necessary headers and libs into special folders, so that you don't have to manage each and everything inside VisualStudio.

Copy the following headers and directories to winuae_include

${Enet}/enet/  
 ${PortAudio}/include/*.h  
 ${zlib}/src/zlib/1.2.3/zlib-1.2.3/*.h  
 ${libpng}/*.h  
 ${WinIO}/WinIo/Source/Dll/WinIo.h  
 ${WacomTablet}/wactab/*.h  
 ${Catweasel}/devel/*.h  
 ${Freetype}/include/*.h  
 ${Freetype}/include/freetype2/freetype/ 
 ${TVicPort}/Examples/MSVC/TVicPort.h  
 ${UnrarDll}/unrar.h  
 ${OpenAL SDK}/include/*.h  
 ${WpdPack}/Include/*.h  
 ${WpdPack}/Include/pcap  
 ${OpenGL}/glext.h  
 ${OpenGL}/glxext.h  
 ${wnaspi3.dll}/wnaspi.h  
 ${ParaPort}/ParaPort.h  
 ${G15 LCDSDK}/LCDSDK/Src/lglcd.h

and into the subdirectory winuae_include/Ghostscript goes
EDIT:

 ${Ghostscript}/base/*.h
 ${Ghostscript}/imdi/*.h  
 ${Ghostscript}/psi/*.h
${Ghostscript}/psi/iapi.h
${Ghostscript}/psi/ierror.h

WinUAE's calling convention is _stdcall. For compatibility you'll have to adapt some headers.

• Add _cdecl right of * or after FT_EXPORT( void ) in the files pcap.h, remote-ext.h, freetype.h and packet32.h.
• Remove the lines referring to extern "C" { and BOOL in WinIO.h.

Building the Libaries

Build the libraries zlib, libpng, enet and portaudio first.

• Set the calling convention to _stdcall in each project's settings, so that you don't have to edit the headers.
• For zlib you'll probably want to set the flag HAVE_UNISTD to 0 manually in zconf.h. Build a static library and rename it to zlibstat.lib.
• libpng.lib wants a copy of zlib in its source tree. Set the option multithreaded (/MT) in its settings. Otherwise there will be unsatisfied references because of the /NODEFAULTLIB (see below).
• There is a nice tutorial for compiling portaudio (especially for compiling without ASIO).

winuae_libs should contain by now enet.lib, libpng.lib, portaudio_x86.lib, WINTAB32.LIB, freetype.lib, OpenAL32.lib, wpcap.lib, lglcd.lib, Packet.lib, WinIo.lib, zlibstat.lib and later will come prowizard.lib.


Building WinUAE

Before compilation you'll have to modify some of the files:

• EDIT:Add includes for ghost.h, imain.h and ierrors.h Replace all occurences of gs_main_instance with void in parser.c.
• Remove all references to getPortInfo in ioport.c
• Remove _cdecl before portAudioCallback in sound.c.

Now you are almost ready for building the subprojects.

• Within Nasm's shell execute asm.cmd for compiling hq_x__.obj.
• Choose a convenient output directory in the project's settings .
• Set the include paths (order is important).
• Set the library paths.
• In the linker's options add /NODEFAULTLIB:MSVCRT.lib. (Btw, you can also remove some DLLs.)

Compile (in this order) build86k, gencpu, genlinetoscr, genblitter, gencomp and prowizard.
gencomp will only compile as release.
Copy prowizard.lib from c:\dev\lib to winuae_libs.

Compile winuae and copy portaudio_x86.dll, freetype6.dll and zlib1.dll to the output directory.


Run WinUAE

[andreas]

Very nice work.
One basic question:

Before compilation you'll have to modify some of the files:

* Add includes for ghost.h, imain.h and ierrors.h in parser.c.
* Remove all references to getPortInfo in ioport.c
* Remove _cdecl before portAudioCallback in sound.c.

Where is the point that these #include lines have to be added manually?
Shouldn't they be in the WinUAE source code by default?

[gilgamesh]

Yes, I think so. Toni probably uses an older version of Ghostscript and some of the other dependencies.

[Ian]

Nice guide just what I've always wanted, shame I uninstalled Visual Studio 10 when MAME switched to mingw64. I might try again if they release a 3rd beta.

Nice Guide... Will be giving it a go over the next few days when I have a bit of time... Will let you know how I get on.

Cheers

LOGIK123

[Toni Wilen]

Nice guide but unfortunately I found some issues as usual

Originally Posted by gilgamesh

[/code] and into the subdirectory winuae_include/Ghostscript goes
[code]
${Ghostscript}/base/*.h
${Ghostscript}/imdi/*.h
${Ghostscript}/psi/*.h

No, only iapi.h (API headers) and ierrors.h is needed. (Other headers are only needed when building ghostscript, not for API usage)

(you are right that API has changed: parser.c gs_main_instance needs to be replaced with void)

Remove _cdecl before portAudioCallback in sound.c.

Portaudio's (internal) calling convention is_cdel so this callback needs to be _cdecl. (Did you test it really workds?)

[andreas]

Originally Posted by Toni Wilen

Nice guide but unfortunately I found some issues as usual

Is that bad?

Well, if we can expect some future source fixes in return that may make some of those ... uh ... kludges obsolete, it was worth it
Even those freaks compiling their stuff themselves should not need to mess around in the given code too much to get things compiled...
(IMHO && YMMV)

[gilgamesh]

Thank you all for your comments. But now to the issues

Originally Posted by Toni Wilen

No, only iapi.h (API headers) and ierrors.h is needed. (Other headers are only needed when building ghostscript, not for API usage)

That doesn't work for me, I'm afraid. Do you use Ghostscript 8.70? "*.h" might be narrowed, but not omitted. I also definitely need additional #include statements, too (see first point under "Building WinUAE").

Originally Posted by Toni Wilen

Portaudio's (internal) calling convention is_cdel so this callback needs to be _cdecl.

The "_cdecl" results in a C2440 error. Portaudio (like all the other libraries I recompiled) was set to use _stdcall (see first point under "Building the Libraries").

Originally Posted by Toni Wilen

(Did you test it really workds?)

Yes, if you consider Turrican II a test?

[Toni Wilen]

Originally Posted by gilgamesh

Thank you all for your comments. But now to the issues

That doesn't work for me, I'm afraid. Do you use Ghostscript 8.70? "*.h" might be narrowed, but not omitted. I also definitely need additional #include statements, too (see first point under "Building WinUAE").

Yes, my ghostscript header directory only contains iapi.h and ierrors.h (says "/* $Id: iapi.h 9043 2008-08-28 22:48:19Z giles $ */" in iapi.h, copied from 8.70 psi-directory)

The "_cdecl" results in a C2440 error. Portaudio (like all the other libraries I recompiled) was set to use _stdcall (see first point under "Building the Libraries").

Ah ok, but now there will be issues if you use official portaudio dlls.. (if/when there is official available)

[gilgamesh]

Originally Posted by Toni Wilen

Yes, my ghostscript header directory only contains iapi.h and ierrors.h (says "/* $Id: iapi.h 9043 2008-08-28 22:48:19Z giles $ */" in iapi.h, copied from 8.70 psi-directory)

I have the very same ID in my ierrors.h. Now this is strange. Where do you get the type gs_main_instance from? Not from imain.h?

This is the dilemma: Without imain.h I get syntax and undeclared identifier errors, e.g. C2143 in line 85 parser.c, C2065 for GSAPI_NEW_INSTANCE, GSAPI_DELETE_INSTANCE, etc. (71 errors in parser.c). gmain.h depends on ghost.h. ghost.h depends on several Ghostscript headers.

(My method works for me anyway, but I'd like to understand what went wrong.)

[Toni Wilen]

Originally Posted by gilgamesh

I have the very same ID in my ierrors.h. Now this is strange. Where do you get the type gs_main_instance from? Not from imain.h?

See above.

gs_main_instance needs to be replaced with void

[gilgamesh]

Wow, now I see. Thanks. I have included this into the document. This saves more than 500 include files.

[andreas]

... and makes building the thing now a walk in the park! Awesome, guys!

[Heiroglyph]

I can build 2100, but not 2200.

Is anyone else getting a slew of these with 2200?

Error 3 error LNK2001: unresolved external symbol "void __fastcall op_c108_23_ff(unsigned int)" (?op_c108_23_ff@@YIXI@Z) winuae cpustbl.obj

[Toni Wilen]

Are you using MSVC 2010 or older? Old MSVC project files are out of date.

[Heiroglyph]

I started with my VS2008 Pro, then installed vc2010 Express with the same error.

I'd rather not use 2010 (I use 2008 for work). I'm not a fan of the per project vc directories, among other things.

Thanks,
John

[Toni Wilen]

Originally Posted by Heiroglyph

I started with my VS2008 Pro, then installed vc2010 Express with the same error.

I'd rather not use 2010 (I use 2008 for work). I'm not a fan of the per project vc directories, among other things.

Thanks,
John

op_c108_23 is in cpuemu_21.c (68030+ "cycle exact" core), you sure you recompiled build68k and gencpu?

Delete all cpuemu*.c files and rebuild build68k and all gen* projects.

(and as usual, I don't support old versions, whatever the program )

[Heiroglyph]

Yes, I did that repeatedly after looking at the build steps for those projects and finding the build order. I even deleted and replaced the source archive multiple times to make sure I didn't unintentionally change something.

For now I'm just going to stick with 2100, it's fine for what I'm doing at the moment.

I'm mainly trying to familiarize myself with how it works, mostly turning off features to simplify the code path and stepping through it.

You probably know this, but a lot of the #defines can't be turned off without adding quite a few #ifdefs. You're welcome to my changes if you want, but I thought I read somewhere that you weren't a fan of lots of #ifdefs.

Thanks, it's awesome work.
John

[Toni Wilen]

Originally Posted by Heiroglyph

You probably know this, but a lot of the #defines can't be turned off without adding quite a few #ifdefs. You're welcome to my changes if you want, but I thought I read somewhere that you weren't a fan of lots of #ifdefs.

No one is maintaining those. I only build "all-in-one" versions anyway
(perhaps your problem was missing #define CPUEMU_21)

[Heiroglyph]

I double checked that just now and all the CPU defines are there, I wanted those.

What I've removed are just defines for emulated hardware I don't ever intend to use (Arcadia, Akiko, parallel and serial ports, SCSI hardware, etc). This also had the bonus of removing a lot of the dependencies.

It's a little overwhelming with everything enabled and fixing those ifdefs actually gave me a better understanding of the code.