Changes

== General =Introduction =

There are various Z80 assemblers which Cross development is a development method where you can use another machine (the host) to develop games programs for the CPC(target).I always test on an emulator first then when the program This is complete I test it on interesting because you can make a real big program which sourcecode does not even fit on the CPCram.

Once you have your binary file you have two choices depending on if The main drawback is that transferring the game will compiled code to the CPC can be quite difficult. But there are pretty good emulators which you can use for cassette or disctesting.

* Use CPCFS or CPCXFS to put the binary files into [[Atari|Atari ST]] was a Disk Image file (DSK)* Then you can run the program common 16 bit computer actually used in cross development of games on the emulator the same way as you would run it on a real CPC.

The fastest way of testing your code on an emulator is by creating *[[ZX Spectrum]] was also a snapshotsource of cross development. Use CPCSnapshot to insert your assembled code into a snapshot file. Then just load the snapshot file into the emulator. Windows users may also try WinAPE's integrated assembler which assembles the code directly into the emulated CPCer... let's memorybetter say [[Speccy Port|Gross Development]] indeed.

=== Cross Assemblers =Integrated toolchains ==

An integrated cross-development toolchain is a time saver for development as it automates all necessary steps from a full set of source materials (source code, graphics, music, parameters in whatever format is practical for editing, etc) to one or several formats ready to run on the target machines. It also sometimes includes automatically launching or notifying an emulator or target device. See e.g. [http://en.wikipedia.org/wiki/Build_automation#Advantages Build Automation on wikipedia]. Such a design has several advantage:*allows the usage of any text/graphic editor of modern platforms* you can change anything in one or more source files and you get an updated build quickly without error-prone manual steps* allows arbitrary transform or generation of intermediary files (code or data).* makes easy to have specific builds (e.g. for automated tests like to check if a different compiler produces correct code, variant build for slightly different targets)* since most material are text files or small independent files, it benefits hugely from modern tools for revision control like [http://en.wikipedia.org/wiki/Git_%28software%29 Git] which makes sharing and merging code between developers much easier, increasing the time saved. An ideal toolchain does not force its user into specific ways of doing things but is flexible enough to let the user adjust for whatever specific needs (use different languages, compilers, linkers, etc). Along with a properly designed and structured source tree, this makes projects less dependent on specific tools used to build them, and be more resilient to [Pasmohttp://en.wikipedia.org/wiki/Bit_rot bit rot]due to [http://en.wikipedia.org/wiki/Software_rot#Environment_change software build environment change]. Please note that an integrated toolchain has little to do with anything visible on-screen. A good toolchain can be triggered by most flexible enough graphical environments and generally produces a text log of the work done. Nevertheless, the concept of toolchains is more natural to Linux/Unix way of thinking/doing things, and those environments are already full of reusable and combinable tools that ease the creation and maintenance of a toolchain. Windows users can generally use tools developed for Unix through the cygwin software adaptation layer but running a Linux distribution in a virtual machine may be more practical. There are some attempts at creating toolchains targeting the CPC. Active as of 2017-11: *ZMac'''[[CPCtelera]]''' integrates an out-of-the-box preconfigured build system, along with a game development library and tools and extensive configuration. It is also multiplatform, working on Linux, OSX and Windows. CPCtelera is a fork of [https://github.com/cpcitor/cpc-dev-tool-chain cpc-dev-tool-chain] tuned for 2D-sprite-oriented productions and extensive documentation. ''Recommended for beginners.''*Kio'''[https://github.com/cpcitor/cpc-dev-tool-chain cpc-dev-tool-chain]''' integrated C or ASM development toolchain for the Amstrad CPC platform (or emulator). '''Recommended for seasoned C programmers, Linux geeks, advanced users, general productions'''. Includes:** Designed for quick start on Linux (or similar) systems : '''get a copy, write a "hello_world.c", run "make dsk" and get a DSK ready to run into the emulator'''. On linux "make run" even runs the emulator! ** Automatically downloads and compiles tools as needed, no interference with user account or global system, no administrator permission needed.** Tools include:*** gfx2crtc (transform PNG into CPC screen data),*** png2cpcsprite (turn PNG into binary data formatted as ASM source code ''with metadata including palette'', zero run-time overhead),*** SDCC compiler, assembler and linker,*** hex2bin, addhead (prepare CPC binaries with AMSDOS header),*** cpcxfs and iDSK (prepare DSK disc image),*** rasm (Roudoudou's Z80 assembler)'''. *** 2cdt (transform CPC binary to tape image),*** playtzx (transform tape image into audio file to play to your CPC),*** caprice32 (emulator),*** cpcec (emulator),*** exomizer (high performance compressor, PC side),*** deexo (Z80 run-time exomizer decompression),** Made for Linux, also works with Windows (via cygwin or similar), and probably Mac OS X. Most project+build-oriented features claims by CPCTelera comes from cpc-dev-tool-chain.** Call firmware routines from clean C code! [https://rawgit.com/cpcitor/cpc-dev-tool-chain/master/cpclib/cfwi/coverage.html advanced coverage of the CPC firmware]** Extensible projects structure based on GNU make  * Not an integrated toolchain, but a collection of tools that can be strung together to make one, including a DockerFile. Mentioned on [http://www.cpcwiki.eu/forum/off-topic/cpc-sdk-for-linuxunix/ CPC SDK for Linux/Unix]. Appears to have moved to https://github.com/cpcsdk * 2012-11-12 [http://www.cpcwiki.eu/forum/programming/recommended-linux-cross-dev-tool-chain/ Recommended Linux cross-dev tool chain?] mentions a makefile-based toolchain targeting dsk images or tapes* 2009-06-16 [http://www.cpcwiki.eu/forum/emulators/my-new-cross-development-kit/new/#new My new cross-development kit] explain what is basically a toolchain but link is broken as of 2013-01-08 == Linux == === Cartridge management ===* [[buildcpr]] [http://www.cepece.info/amstrad/download/buildcpr.zip] === Cross assemblers === * [[basm|Benediction ASseMbler]] [https://cpcsdk.github.io/rust.cpclib/basm/]* [[naken_asm]] [https://www.mikekohn.net/micro/naken_asm.php]* [[pasmo]]* [[RASM]]* [[SjasmPlus]]* [[Sjasm|sjasm]]* [[Z80asm]] [http://savannah.nongnu.org/projects/z80asm]* [[Zasm]] [http://sourceforge.net/projects/zasm]* [[ZMac]]* GNU Binutils for z80 (z80-unknown-coff platform) === Cross compilers ===* [[ZXBasic]]* [[Turbo Rascal Syntax Error]] [http://turborascal.com]* [[ugBASIC]] [https://ugbasic.iwashere.eu] === Crunching ===* [[Exomizer]]* [[pucrunch]] [http://tj.gpa.free.fr/zip/sources/pucrunch.zip] === Disassemblers ===* [[dzasm]] [http://www.cepece.info/amstrad/download/dzasm.zip] === Disc management === * [[CPCTools]]* [[iDSK]]* [[cpcfs]] / [[cpcxfs]]* [[dsktools]]* [[cpmtools 2]] [http://www.moria.de/~michael/cpmtools/] === Editing === * scite* pico* xemacs* [[How to use VIM for CrossDev|Vim]]* pluma* gedit === Emulators ===* [[Arnold (Emulator)|Arnold]]* [[Caprice]] [http://sourceforge.net/projects/caprice32/]* [[cpcemu]] [http://www.cpc-emu.org/]* [[xcpc]] [http://xcpc.sourceforge.net/] === Tape management === * [[2cdt]] new version: [http://cpctech.cpc-live.com/download/2cdt.zip] — old version: [http://www.cepece.info/amstrad/download/2cdt.zip] * [[cdtcheck]] [http://www.cepece.info/amstrad/download/cdtcheck.zip]* [[cdttst]] [http://www.cepece.info/amstrad/download/cdttst.zip] * [[samp2]] [http://www.cepece.info/amstrad/download/samp2.zip]* [[UberCassette]] [http://www.retroreview.com/iang/UberCassette/] === Toolkits ===* [[CPCSDK]] toolkit which contains useful tools for cross-development under Linux - [http://code.google.com/p/cpcsdk/] === Useful scripts ======= Suppress header information of a file ====<pre>cat file_with_header | tail -c+129 > file_without_header</pre> === Needed Tools ===These tools have to not require a lot of requirement and most of them must work in command line without GUI. This will allowto use them with Makefile scripts. They have to be fast too, it will be disappointing to wait more when doing CrossDev than when doing code on a real CPC.A good thing (like most of CPCTools) is to have a portable code which compile on most platforms. * a good emulator which can be integrated in other tools. (Ramlaid first try to change Caprice is a good start)* an integration of Ramlaid's tools with Nautilus* ameliorations of Caprice in order to have similar functionalities than WinApe (disasm, asm, ...)* debug the libdsk which seems to work very bad on actual computers (writting fail a lot)* a lot of macros, or libraries for SJASMPlus shared by people in order to share code* share a generic Makefile able to be use for build CPC project* a lot of little command line utilities (could be add to CPCTools ?) really well done :** graphics tools :*** convert images from PC to CPC, or CPC to PC (cf. tools based on ImageMagick or GD)*** equivalent of Anoine's FontCatcher** 2 tools which work with BASIC :*** one for create BASIC AMSDOS files from ASCII or UTF-8 text files*** one for create ASCII or UTF-8 text files from BASIC AMSDOS files*** (this can already be done with manageDSK for files inside a DSK, maybe extract the code from there)** data manipulation tools :*** ability to arrange data files for example modify bytes order in a picture file by using Gray code capabilities for changing line with modifying 1 bit == Windows == === Cross Assemblers ===  * [[basm|Benediction ASseMbler]] [https://cpcsdk.github.io/rust.cpclib/basm/]* [[naken_asm]] [https://www.mikekohn.net/micro/naken_asm.php]*[[Tasm|tasm]] *[[Pasmo|Pasmo]] *[[RASM]]*[[WinApe|WinApe]]'s built in assembler*[[ZMac|ZMac]] *[http://little-bat.de/prog/ zasm] === Cross compilers (C) === Beginner warning: unless you want to rebuild an entire toolchain by hand, you probably don't want to just download a C cross-compiler alone. Most probably, what you're looking for is an [[#Integrated_toolchains|integrated toolchain]] instead. For a C tutorial, see http://www.cpcmania.com/Docs/Programming/Programming.htm by Mochilote * [[Z88DK]]* [[SDCC]], notably [[SDCC and CPC]] had hints and practical examples about the principles of writing in C for CPC.* [[PhrozenC]] === Cross compilers (Java) === WIP * [[JavaGrinder]] === Cross compilers (Pascal) === * [[Turbo Rascal Syntax Error]] [http://turborascal.com] === Graphics === *[[AMSprite|AMSprite]] - Sprite/Loading Screen Editor and graphics conversion tools === Sound === *[[WYZTracker|WYZTracker]]&nbsp;- Music tracker / Sound effects editor*[[Vortex Tracker]]

- Use * 2CDT to add the files to a Cassette Image File (CDT)* Tape2WAV to convert the Cassette Image file (CDT) into a WAV file.- * Then you can run the program on the emulator the same way as you would run it on a real CPC, or* Connect your CPC (CPC664 and CPC6128 have a cassette input) to the Line-Out output of your PC soundcard- * On the CPC type:   |TAPE:RUN"- * Start your WAV player- * Set the volume to maximum- * play the WAV file- * Wait for the program to load...

If your CPC has a 3.5" disc drive then the easiest method is * Use CPCFS or CPCXFS to transfer put the DSK to binary files into a 3.5" disc using Disk Image file (DSK)* Then you can run the PC.program on the emulator the same way as you would run it on a real CPC

- Then use CPCDiskXP If your CPC has a 3.5" disc drive then the easiest method is to transfer the DSK to a 3.5" disc using a PC with a 3.5" drive (internal, not USB). * Then write the DSK to a 3.5" disc drive, using dsktools (Linux) or CPCDiskXP (Windows).- * Put the disc into your CPC's 3.5" disc drive and type- |B: RUN "<&lt;gamename>&gt; == Snapshots == The fastest way of testing your code on an emulator is by creating a snapshot. Use [[CPCSnapshot]] to insert your assembled code into a snapshot file. Then just load the snapshot file into the emulator. Windows users may also try WinAPE's integrated assembler which assembles the code directly into the emulated CPC's memory.

* [http://ramlaid.free.fr/Amstrad/English/crossDev.htm CPC Cross Development tools by Ramlaid] (Link broken as 2012-01-08. If you can help, please update.) [[Category:Programming]] [[Category:CrossDev]]