7 replies to this topic

[JagChris]

These are the steps I took to get up and running with BJL and the Atari development setup from Belboz's website. My dev setup is using an old Pentium ONE system with Windows 95 installed. Using and old 95/98 DOS based OS with a low end Pentium One or Two setup is recommended for using the BJL setup and the Atari Jaguar development setup. These steps assume you already have BJL and the adapter with an appropriate cable and know how to use them.

I have a shortcut to DOS on my desktop. I call it JaguarGCC.



When I click on that It's all setup to run the Jag.bat file I have with the Jag dev enviroment variables and starts me out in the 'Jag' dev setup directory. Here is what the Jag.bat text file looks like:

@ECHO OFF
set PATH=%PATH%;C:\JAGUAR\BIN
set RDBRC=C:\JAGUAR\BIN\RDB.RC
set DBPATH=C:\JAGUAR\BIN
set ALNPATH=C:\JAGUAR\BIN
set MACPATH=C:\JAGUAR\INCLUDE
set GCC_EXEC_PREFIX=C:/JAGUAR/BIN

Also included is an image of where it is in the 'Jaguar' dev setup directory.(It's in the root directory).



So in order, this is what I did to get my dev. setup working on my PC.

1.) Unzipped Belboz's Official Atari Jaguar development pack into a Folder/directory on my HD I created that I called "Jaguar". I might as well put the Link to Belboz's website HERE. Go to his download area and get the Jaguar developer tools.

2.) Created .bat file(It's just a text file) called Jaguar.bat in the root directory of 'Jaguar' with the necessary enviroment variables I needed to run the development enviroment which are posted above.

3.) Created a DOS shortcut on the desktop I named "JaguarGCC" with the 'Program' properties modified like in this image.



4.) Created a directory inside the "Jaguar" dev root directory I called 'MyStuff' to hold programs/files I may be working with, compiling and uploading to BJL.

5.) Replaced the original video.s file in the *3d/LIB directory of the Jag tools with the attached video.s file[zipped up] (So BJL video will work properly with the stuff you compile and upload to it, otherwise you'll just get a blank black screen.) Thanks again to Belboz for figuring out the problem and creating this fix for BJL users.

 VIDEO.zip   2.64K   139 downloads

6.) Got rid of the shitty and very broken make.exe that comes with Atari's dev setup and am using M$ NMAKE 1.5 in its place.

Now when I want to work with the Jag dev stuff (mostly compiling and uploading) I click on my JaguarGCC DOS shortcut. It takes me right to the Jag/Mystuff directory in a DOS Window, with all the appropriate enviroment variables all set up, and I'm ready to go.

I hope this helps anyone who is wandering around here looking to get started using the Atari dev setup and BJL.

Edited by JagChris, Mon Feb 12, 2007 3:13 PM.

[JagChris]

* Correction to above post. The Video.s file that gets replaced is in the 3d/Lib directory.

So in the above example the video.s file would be in C:/Jaguar/3d/LIB.

Also the fix for BJL users does not affect Alpine users at all. It can be put in no matter what you use for Jaguar development, whether Alpine or BJL, to insure compatibility with both.

Sorry about any confusion that may have caused.

I think now Belboz has put the modded video.s file in his download package so it automatically works with all setups.

Edited by JagChris, Tue Jan 8, 2008 6:16 PM.

[JagChris]

Further notes on the Atari dev setup.

It would be best to be a fairly knowledgable programmer or have some kind of tutor/instructor for using the Jag dev system. You cannot just compile C code and upload it to the Jaguar. A mistake I made that had me going wtf for quite a bit at first.

You have to create an Assembly language startup file and then use the MAKE files to have MADMAC and ALN wrap the C and Assembly code all up together into a neat little binary package the Jaguar can understand before it can be uploaded.

Edited by JagChris, Thu Jan 18, 2007 5:22 PM.

[JagChris]

Replacing the included Atari development make.exe with M$ Nmake 1.5 quick and easy. If you don't, you are likely to have trouble right away.

Belboz said:

You want to download nmake15.exe and put it in your \jaguar\bin directory

Then go to a dos prompt and type this

cd \jaguar\bin

nmake15

copy nmake.exe make.exe

del nmake15.exe

you may get an overwrite warning on the copy command.

Then you should be good to go.

Edited by JagChris, Thu Jan 18, 2007 10:31 PM.

[walter_J64bit]

Good work JagChris it looks like you have brought life to the Jag Development here at AA. With the user base here someone is going to give the Jag Development a shot.

[JagChris]

walter_J64bit, on Thu Mar 1, 2007 6:54 PM, said:

Good work JagChris it looks like you have brought life to the Jag Development here at AA. With the user base here someone is going to give the Jag Development a shot.

Hopefully Walter.

It's just surprising that no one has ever attempted to lay out what was required to program the Jaguar, or responded to the posts here for so long.

Hopefully, at least one person will indeed do something with this knowledge.

[JagChris]

Update. A problem Belboz helped EmOneGarand with when his dev setup would hang in Windows 98 when it hit the linker upon executing MAKE.

'Belboz' said:

It was the himem.sys and/or emm386.exe drivers.

My default Windows 98 installs don't have anything in the config.sys and I have seen problems like he found with emm386.

Himem may be okay to load, but I just recommended rem'ing out those two lines and he was good to go!

You shouldn't need either of them for Windows 98.

So if anyone has problems be sure to REM these lines out in your config.sys file. Probably a good idea to REM them out anyway before anyone has any problems.

Edited by JagChris, Sat Jul 21, 2007 10:25 PM.

[JagChris]

Belboz also has a video he created going through the setup process.

You can find it on this page. Go down to the Atari Jaguar downloads section and you'll see the video. You need the xvid codecs to play it.

http://www.hillsoftw...oads/index.html