+cubanismo Posted September 21, 2020 Share Posted September 21, 2020 (edited) I've tidied up most of the remaining issues with my attempt at an updated Jaguar SDK, and documented the outstanding problems in github issues. Here it is: https://github.com/cubanismo/jaguar-sdk See the README.md for cloning, setup, and general getting started instructions. If you have a skunkboard or a BJL cable and know enough to run bash scripts and make, you should be up and running "hello world" built from source in a few minutes. Beyond that, you're on your own. A good amount of Jaguar documentation is included (All the scanned Atari docs and the searchable tech ref PDF, plus all the docs from Belboz's SDK), so everything I used to get from "What's a Tom?" to "I'm writing my own RISC code and it works!" is there if you're willing to read it. This SDK includes all the original Atari samples and demos found in Belboz's old SDK/dev environment with cleaned up Makefiles that use rmac/rln by default (You can tweak the master Makefile helper files to substitute good ol' mac/aln if your system supports a.out binaries) and also converts them to end with infinite loops rather than "illegal" instructions to break into the debugger you probably don't have, meaning everything plays nicely with virtualjaguar and regular BJL/skunkboard HW setups out of the box. Couple gotchas if you're trying to build some of the cooler stuff, such as the Atari 3D demo (which is included there under jaguar/3d, working Makefile and all, as well as resurrected versions of the Atari tools that are required to build its data files, 3dsconv and the original tga2cry) : It only works on Linux right now. I've been meaning to add windows setup scripts a well, but haven't gotten around to it yet and didn't want to let that hold up releasing what I have so far. To build the 3D demo, you need to patch rmac. See the issue here: https://github.com/cubanismo/jaguar-sdk/issues/6 To build the cinepak demos, you need a patch to rln to support Alcyon-format object files that I haven't posted anywhere yet because I need to make a 2nd pass at it. I'll do that pretty soon, but again, didn't want to hold up release of everything else. This is needed because the Atari cinepak library is only available as an Alcyon object file with no source. Besides using this to build the included samples, I use it for all my other little projects as well. You can source in the env.sh file and then make calls to any of the included tools (rmac, rln, jcp, tga2cry, etc.) on the command line from anywhere, as well as write Makefiles in your project that use the included Makefile helper headers/footers to reduce Makefile clutter as well. For example, here's all the Makefile code needed for my simple lightgun test program that uses a mixture of C and assembly, and lives outside of the SDK itself: ALIGN=q include $(JAGSDK)/tools/build/jagdefs.mk CFLAGS += -mshort -Wall -fno-builtin OBJS = startup.o \ bullets.o \ lightgun.o \ font.o \ sprintf.o \ util.o RAW_DATA = -ii clr6x12.jft _fnt PROGS = bullets.cof bullets.cof: $(OBJS) clr6x12.jft $(LINK) $(LINKFLAGS) $(OBJS) -o $@ $(RAW_DATA) include $(JAGSDK)/tools/build/jagrules.mk I hope others find this useful. Half the difficulty in ramping up for me was just rounding up all the docs, utilities, and samples that I needed and getting them somewhere I could find and run them easily in a way that persisted across reboots. And of course, if something is broken, let me know, either here, or by filing an issue on github. I'll support it when I have free time, but hey, this is a hobby, so no guarantees. Edited September 21, 2020 by cubanismo Fixed typo in Makefile sample code 7 5 Quote Link to comment Share on other sites More sharing options...
Join the conversation
You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.