CPC M4 xfer tool

From CPCWiki - THE Amstrad CPC encyclopedia!
Jump to: navigation, search

Command-line tool that allow to send files and receive from an M4 Board. Possibility to add an AMSDOS header too.

Current version : 2.0.3

Windows Executable : https://github.com/M4Duke/cpcxfer/raw/master/xfer.exe

Repository : https://github.com/M4Duke/cpcxfer


Command Effect
xfer -u ipaddr file path opt Upload file, opt 0: no header add, 1: add ascii header, 2: add binary header (specify start and exec addr. in hex)
xfer -d ipaddr file path opt Download file, opt 0: leave header, 1: remove header
xfer -f ipaddr file slot name Upload rom
xfer -c ipaddr file Upload cartridge image (.CPR/.BIN)
xfer -x ipaddr path+file Execute file on CPC
xfer -y ipaddr local_file Upload file on CPC and execute it immediatly (the sd card must contain folder '/tmp')
xfer -p ipaddr Start (plus) cartridge
xfer -s ipaddr Reset CPC
xfer -r ipaddr Reboot M4

Example : If your m4 has IP number, the following code will run zynaps from given directory.

xfer -x /games/zynaps/zynapsex.bas

Want to leave it again you could reset the cpc by:

xfer -s

In a development environment the idea is you ie. do the following to your makefile :

xfer -u mycode.bin / 0 (to upload the file after compilation, additional files could be uploaded too)

xfer -x /mycode.bin (to execute it)

Remote files can be basic/binary or SNA (emulator snapshot format).

If you are deving roms, they can be remotely uploaded too :

xfer -f yancc.rom 3 "YANCC" (upload to slot 3)

xfer -f launcher.rom 4 "The Launcher" (upload to slot 4)

xfer -r (Reboot M4 for changes to take effect)