notaz cc68a136aa initial import 17 years ago
..
license_gpl.txt cc68a136aa initial import 17 years ago
license_mame.txt cc68a136aa initial import 17 years ago
readme.txt cc68a136aa initial import 17 years ago

readme.txt



Compiling Symbian ports
-----------------------
First note: there is no WINS support, because I use assembly code in some
places and I don't think emulator is useful for this project because of it's
too different behaviour compared to real device. If you need wins support,
you will have to add it yourself. In that case, you will have to use a68k
instead of Cyclone and mz80 instead of DrZ80. Emulator does have support
for these, also there is equivalent c code for the asm stuff, but you will
have to dig the sources and figure everything out yourself.

Exe:
Before building the exe you will need to compile Cyclone, use the included
vc6 project or see Cyclone.txt for more info.

I don't use standard Symbian build methods for exe, because I use ARM
assembly files (*.s) and different compiler options for different files,
and this is difficult to achieve with .mmp files. Also I use Cylone
patcher, check \cyclone\epoc\ for more info. So I use custom makefile
instead, but to use it, UIQROOT2 environmental variable must be set to
the root of your UIQ SDK. So to build, you need to type something like
this in console window:
> SET UIQROOT2=C:\UIQ_21\
> make -f picosmall.armi noecompxl=1
(To use ECompXL, you must rename ECompXL's petran.exe to petran_.exe or
edit the makefile).

Launcher:
There should be far less problems building that. Simply typing
> makmake PicodriveN.mmp armi
> make -f PicodriveN.armi
in console window with launcher directory set should build it without
problems.


Compiling GP2X port
-------------------
If you use devkitGP2X with gcc 4.0.2 and your paths are set correctly, running
'make' should be enough. If you are under Linux, you may need do some
adjustments, like changing case of filenames or setting up paths. I am sure
you will figure out yourself :)


License mess
------------
The launcher for Symbian OS is based on Peter van Sebille's projects,
which are released under GPL (license_gpl.txt).

YM2612 and sn76496 sound cores were taken from the MAME project, which is
under it's own license (license_mame.txt).

Dave's Cyclone 68000 core, Pico library are under simple
"Free for non-commercial use, For commercial use, separate licencing
terms must be obtained" license.

As far as I checked, both "Free for non-commercial use" and MAME licenses
might be incompatible with GPL, because GPL DOES allow commercial distribution.
But I don't think the original copyright holders (Peter, Dave, Reesy or the
MAME devs) would get very upset about this "violation", as this is both free
and open-source project. However, the whole project most likely falls under
GPL now (I don't know for sure as I'm just another coder, not a lawyer).
Alternatively, the launcher and exe can be viewed as separate programs
(technically this is true, they both use separate binaries, only protocol
is shared), so I hope nobody sees a problem here.


Contact
-------
My e-mail: notasas(atsymbol)gmail.com