UDPSlave

A minimal network transfer utility for RR-Net.

UDPSlave is a transfer utility that lets you send over PRG files from a PC (or Mac, or Unix box) to a C64 with an RR-Net interface. The main features are that the program is small enough to be typed in, and doesn't require anything except a cartridge with a clockport and RR-Net.

To get started, either trainsfer udpslave.prg to your C64 using another transfer system (X cable, 1581Copy, SerialSlave, or what have you), or type in the basic listing for minislave. Minislave is a stripped down version that doens't support pinging. After the slave has been started on the C64, you can send files over with sendudp.

The programs have been tested successfull with RetroReply + RR-Net, MMC64 + RR-Net, SuperSnapshot + RR-Net, and VICE (thank you, Jason). It also works with RR and SS plugged into MMC64, as long as the RR-Net is connected to the MMC64's clock port.

Download

udpslave-0.91.zip source and binaries.

udpslave-20080618.zip latest source snapshot.

Usage

sendudp [-r | -j address] server [filename.prg]

-r	Run program. Not supported with minislave.
-j address	Execute program at address. Use 0x prefix for hex addresses.
server	IP or hostname of C64 running the slave. Default is 192.168.0.64 (see below on how to change it).
filename.prg	Program file to send over.

Hints

If you type in minislave, save it before you start it! You don't want to type it in again if the computer hangs...
The program end address is set to the last byte of the last program you loaded. You can stop udpslave and SAVE the transferred program to disk instead of running it. To stop udpslave, press any key. To stop minislave, press run/stop+restore.

Setting the C64's IP address

To set the IP address of minislave, POKE the four values to the addresses printed after the basic program finishes:

 37
 38
 39
POKE 52903 TO 52906 TO SET IP, SYS 52224
 TO START

READY.
POKE 52903,217
POKE 52904,28
POKE 52905,206
POKE 52906,139
SYS 52224

This sets the address to 217.28.206.139.

To set the IP address of udpslave, stop the program with any key, POKE the four values from 53178 to 53181, and restart with SYS 52224:

LOADING"UDPSLAVE"
READY.
RUN
OK

READY.
POKE 53178,217
POKE 53179,28
POKE 53180,206
POKE 53181,139
SYS 52224

Examples

% sendudp -r 192.168.0.64 kendo_warrior_ntsc.prg
Sending kendo_warrior_ntsc.prg to $0801
Running: Send over and run Kendo Warrior.
% sendudp 192.168.0.64 graphics.prg
Sending graphics.prg to $4000
% sendudp 192.168.0.64 music.prg
Sending music.prg to $1000
% sendudp -j 0xc000 192.168.0.64 code.prg
Sending code.prg to $c000
Jumping to $c000: Send over graphics, music, and code, then jump to $c000.

Troubleshooting

In case it's not working, here's a checkist:

If the screen flashes the C64 is receiving data. If the program you're sending over doesn't work, make sure it's not overwriting udpslave itself ($ca00-$cfff).
Minislave doesn't handle basic programs correctly. Run/stop-restore, save the program to disk, reset, and load it back in before running.
Check if the C64 responds to ping commands (only with udpslave, minislave doesn't support ping).
Check if the C64 responds to ARP requests. List the ARP table with arp -a. There should be an entry matching the C64's IP address. Sometimes it helps to flush the ARP table; do this with arp -d 192.168.0.64.
If all else fails, grab Ethereal (or another network sniffer) and see what happens on the network. Use a filter like udp || arp to weed out traffic that isn't interesting.

History

UDPSlave 0.9, 2006-10-10
- Initial release.
UDPSlave 0.91, 2006-10-17
- Optimized incoming packet code, reduced size significantly.
- Base64 decoder for minislave, reducing type-in code from 57 lines of hex to 38 lines of base-64.
- Better checksum algorithm catches missing lines.
- Exit gracefully when a key is pressed in udpslave.

Contact

Send love, hate, and bug reports to magervalp@fastmail.fm.

License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.