The WDC W65C134SXB is an affordable SBC based on the 65C02S processor. It's a very attractive package, but WDC's tool-chain is windows only. Luckily, it's not difficult to get it running under Linux. In this guide we'll go from plugging it into to running a simple Hello World type program. I'm using xUbuntu 19.10, these instructions should work for any of the Debian based distros, out of the box, and on other distros with only a little modifcation.

The first thing we need to do is get our software environment set up. We'll be using EasySXB to talk to the 134 over a USB port. EasySXB isn't available in the repositories, so we'll need to get it from Sourceforge.

https://sourceforge.net/projects/easysxb/files/

Other than EasySXB, we'll need CC65 which contains our assembler and linker and SRecord which will allow us to convert the binaries produced by CC65 to something we can send over the USB cable. This software can be installed with the command

Once the software is installed, we're ready to plug in the 134. Grab any old micro-usb cable and connect the 134 to your computer. Now, we need to find out what tty it has been assigned to. The 134 uses an FTDI chip to run it's USB port, so we can search through the system log to find it by typing the following

On my system the output looks like this

We can see that the 134 is on /dev/ttyUSB0.

Now, we're ready to fire up EasySXB and start talking to the 134. Start EasySXB. From the Options menu, chose Board Model and then select the 134. Now, from the File menu, choose Connect to SXB. You will be prompted to enter a device. Enter the port that we found in the previous step. Connect, then press the reset button on the 134. You should see something that looks like this

This is the Machine Code Monitor for the 134. You can type ? for a list of commands.

Now, we need to write some code and get it over to the 134. Here's a simple Hello World(ish) program

This uses two routines from the monitor rom on the 134. JSR $F00F prints the contents of A as an ASCII character to the tty. And, JSR $F012 prints a CR/LF to the tty. The code is located at 0x0800. WDC suggests that this is a good part of RAM for messing around. Save this as hi.asm and we'll get it over to the 134. Assemble and link the code with the commands

We're ignoring CC65s ability to generate relocatable code but for simple code that's ok. If you're going to do serious development for the 134 a ld65 compatible memory map would be very useful. (If I end up making one, I'll post it here)

Now, we need to convert the binary into a Motorola SRecord file so we can upload it to the 134. The following command will do the conversion as well as letting the 134 know where to load it into memory so that our jumps will match up with reality.

The most important thing here is that the --offset match up with the .org in the assembler source.

Finally, we can upload our code and run it. Switch back to EasySXB. If you've been messing around with the monitor, go ahead and reset the 134. Now, type e into the monitor. This will display and clear the error log. From the File menu, choose Upload Program. Browse to the folder that has hi.srec. You'll need to change the file type from hex to srec in the bottom. Once the file has uploaded, you will see several lines beginning with S then you should see the . prompt. Type g 0800. This will transfer control to the memory address containing the start of our program. If everything went according plan you should see something like this

And there you have it! I strongly suggest that you check out WDC's ROM documentation. It has almost everything you need to develop for the 134. You can snag it here

http://www.westerndesigncenter.com/wdc/documentation/134monrom.pdf

I'm a total beginner at this, so i'd love to hear any suggestions.

Hope this helps someone!

Great write-up, thanks!

That's an excellent write-up; thanks for that.

One thing I think should be added to your documentation: I the official home of of EasySXB appears to be https://github.com/JoeDavisson/EasySXB/. (Various bits of evidence point to the JoeDavisson account being the same joe_7 who did all the commits up to the start of 2017.)

That said, the releases page on GitHub has only source releases, not binaries, so I guess for whatever reason he's chosen to keep the binary releases on SourceForge only.

_________________
Curt J. Sampson - github.com/0cjs

Thanks for mentioning this! EasySXB is a great program and Joe deserves lots of credit for putting it out there.

Right, although my main thought was actually just that it's nice to know where the source is so one can poke through it to debug things, find out how WDC's protocol works, and so on.

_________________
Curt J. Sampson - github.com/0cjs