TweetFollow Us on Twitter

Net Yaroze on the Mac OS

Volume Number: 13 (1997)
Issue Number: 12
Column Tag: Alternative Environments

Net Yaroze on the Macintosh OS

by Ed Ringel, with Jeremy Vineyard

Is game console development for you? MacTech takes a lightning tour of Net Yaroze on the Mac OS

Introduction

Most of us like to play games, and some of us would also like to write our own. Besides desktop computers, there are console systems on the market specifically designed for playing games. Nintendo, Sega, Sony, and Atari are just a few manufacturers of these systems. Until recently, game console game development has been the exclusive domain of commercial developers. Presumably, in this way only the best quality games will be created for their systems, and will thus most effectively promote their product. Sony has created a different option, a way for hobbyists to create games for the Sony PlayStation, without participating in the professional developers program. This program is called "Net Yaroze," pronounced Yah-RO-zay.

Net Yaroze

What it is

Net Yaroze is Sony's development package that gives hobbyist developers access to the PlayStation OS. Net Yaroze comes with a Net Yaroze member's PlayStation, a special Net Yaroze access card, a boot CD for the PlayStation, a software development CD containing sample code and libraries, and paper documentation. Net Yaroze is also referred to as Yaroze. Hobbyists can subscribe to the Yaroze program for approximately $750 by contacting Sony.

What it needs

The Net Yaroze member's PlayStation is a special black PlayStation with an added port in the back for connecting to a PC. In addition to development, the Yaroze member's PlayStation can play any PlayStation game. The Net Yaroze developer kit was designed for IBM compatibles, so it uses a connection that is not directly compatible with any of the Mac I/O ports. To connect a Mac to Net Yaroze, you need a DB-9 adapter cable, also known as a modem cable (around $ 5-10). [Note that the connection is DB-9, not DB-25. --Ed.] CodeWarrior for PlayStation does not come with Net Yaroze and must be purchased separately for around $300.

The Net Yaroze development system uses a serial port, so if both a printer and a modem are already hooked up to the Mac, a serial port switch box or PortJuggler may be an excellent investment. These devices range in price from $20 to $130 depending on their capabilities.

To debug (and play) Net Yaroze games some sort of video system is necessary. Generally, this means an external monitor, an RCA video input (AV Mac's), or a TV/video capture card. There is no "right" decision here. I have been using TurboTV- a cross-platform PCI TV card for either Mac or PC, but I was disappointed by the extra compatibility problems introduced when I installed the card. It can make the computer somewhat unstable, and virtual memory must be off for systems before 7.6. Unless you already have video input capabilities in your Mac, an extra cheap television may actually be a better purchase than a TV card. A "real" TV has the advantage of showing what the images will really to look like, but the computer screen TV image is dithered and interlaced, even in millions of colors. Also, TV cards are convenient and make it easy to capture screenshots and QuickTime movies of your games. Why the extra TV? Although most people already have a television at their disposal, they may not be willing to dedicate it solely to the purpose of debugging and playing Yaroze games.

What it isn't

Net Yaroze is very different from commercial PlayStation development. The vision of Sony in creating this program is that of a worldwide group of talented, programming hobbyists developing games to play and share amongst themselves, connected by the Internet under the help, care, and guidance of Sony. This is not a low end, alternative entry point into commercial programming, but a hobbyist's club with many safeguards (or obstacles, depending upon how you see it) to prevent the dissemination of hobbyist developed games into the protected, quality controlled end user market.

Net Yaroze games will run only on Net Yaroze consoles; they will not run on commercial PlayStations. Obviously, this is Sony's main firewall between the Net Yaroze and commercial development programs. Conversely, commercial games will happily run on Yaroze units. In fact, one perk of being a Yarozian is that any commercial game for any of the target markets will run on a Net Yaroze box; there is no geographical lockout as with commercial games units. (PlayStations marketed for North America, for example, will only run games marketed for North America.)

Another difference is that the code libraries provided are a subset of the commercial development libraries. Also among the main differences is a ceiling on code size for Net Yaroze development. The licensing program, although reasonable, appears to be no nonsense in character and would probably not be tolerant of efforts to breach the hobbyist/commercial separation. The reader is recommended to the web sites mentioned at the end of the article for some excellent FAQ pages that help delineate the specifics of the program.

Thus, although PlayStation development may hold considerable interest for the hobbyist game developer, the up-front cost may be substantial. Furthermore, there may be several hassle factors: loss of a port, Mac OS specific costs, and the pros and cons of various video output solutions.

Learning To Program for Net Yaroze

The Net Yaroze package comes with three manuals: a startup guide that shows you how to set up the Net Yaroze and run sample programs (for IBM PC's); a user guide that explains the various components of the PlayStation OS; and a library reference manual that contains descriptions of library functions that can be accessed when writing Yaroze software.

The manuals are thorough, but they describe a complex environment. PlayStation game developers must deal with most of the same problems as do game developers for PC's; game console development is far from easy. Proficiency in C or C++ is required to be able to understand the documentation and sample code. C is strongly recommended as the development language by Sony. C++ is not officially supported, although can be used.

Net Yaroze has its own web site specifically designed for Net Yaroze developers. This web site contains sample programs written by other Net Yaroze users or by Sony, documentation concerning PlayStation data formats, and other useful information concerning Net Yaroze development. The web site also contains utility programs for Net Yaroze developers, but for now they are mostly only for IBM PC's.

Net Yaroze on Macintosh

Setting up the system

To set up Net Yaroze for Macintosh, the prospective developer needs to follow a few simple steps. First, insert the Net Yaroze access card into the PlayStation. Next, connect the PlayStation to the Macintosh serial port using the DB-9 adapter cable. Then, install CodeWarrior for PlayStation and the supporting Yaroze libraries. Finally, boot the PlayStation with the Net Yaroze boot CD. After following these steps, programs and data files can be downloaded to the PlayStation. Let's take a moment to look at the Mac OS specific development system, CodeWarrior for PlayStation.

CodeWarrior for PlayStation

CodeWarrior for PlayStation is a plugin for the CodeWarrior IDE environment. By maintaining a standard interface, developers familiar with the CodeWarrior IDE will have little trouble writing code for the PlayStation. The CodeWarrior for PlayStation package includes the IDE and plugin for both Mac and Windows platforms along with on-line documentation explaining how to target the PlayStation platform. It also includes a tool for converting graphics to TIM, the PlayStation graphics format, and one sample program for Net Yaroze.

CodeWarrior for PlayStation is still in its early DR stages, so developers should be cautious when considering a purchase of this product. The environment itself is stable, but the tools are sparse and not very well developed at this point. Fortunately, Metrowerks is working on improving tools for PlayStation development.

Currently, it is impossible to run many of the sample programs that are posted on the Net Yaroze web pages because source code is not available, but Metrowerks plans to fix this shortcoming in the near future.

PlayStation technical support was variable. I posted several technical questions on comp.sys.mac.programmer.codewarrior and had replies from several

people that same day. An e-mail to tech support however, received no response.

Let's Write Some Games!

To write games for the PlayStation, a developer must understand the PlayStation OS and libraries which are described in the reference manuals included along with the Net Yaroze environment. The developer must then convert any graphics or sound data to the appropriate PlayStation data formats using the tools provided with CodeWarrior for PlayStation. Conversion tools can also be found on the web. After the PlayStation code has been written in C or C++, it can be compiled into a PlayStation executable file which is then opened into the Metrowerks debugger (the release that comes with CodeWarrior for PlayStation must be used). Once a PlayStation file is opened in the debugger, it can be downloaded to the PlayStation. At this point, you will be playing your very own, custom-made PlayStation game! Now, let's stamp out the bugs.

Figure 1. Net Yaroze Sample Program.

Debugging PlayStation Games

Cross platform development can tax even high end host computers. Environment limits are especially noticeable during the Net Yaroze debugging process. Because the debugger must communicate with the PlayStation through a serial cable, the debugging process, even at its fastest terminal speed, can be painful. Stepping through in the debugger is slow even on a 200 MHz Mac. It is not possible to switch programs after one has started running. Instead, the PlayStation must be reset manually every time a new program is to be run or the same program is to be rerun. This is particularly inefficient and slow because of Sony's startup advertisements. Metrowerks plans to fix this in an upcoming release.

Perhaps the most serious problem with the debugging process is that breakpoints cannot be set or edited while the PlayStation program is running. The implications of this are that developers must decide exactly where they want their breakpoints before starting debugging, something that is difficult to do with larger projects. According to Metrowerks, this is a hardware limitation and cannot be fixed.

Summary

Net Yaroze provides hobbyists with the opportunity to write authentic console games. Until now, that has been difficult to accomplish. Metrowerks is currently working on new tools that will make Macintosh Net Yaroze development much easier in the near future. The would-be console game programmer should be aware of the limitations of the system, the steep learning curve, and the costs involved. Nonetheless, Net Yaroze development might be a new and satisfying undertaking for the hobbyist, and give the would-be professional a chance to test the waters.

Products Reviewed

Net Yaroze, Sony Corporation. See URL's for contact information. CodeWarrior for PlayStation/Net Yaroze. See URL's for contact information.

Useful URL's

http://www.scea.sony.com/net/index.html is Sony's home page for Net Yaroze information. The interested reader is strongly recommended to this page. In particular, the FAQ page can really help you make a decision regarding purchase.

http://www.Metrowerks.com/products/cw/playstation/cwps/index.html and http://www.Metrowerks.com/products/cw/playstation/netyaroze/index.html are two pages are Metrowerks index pages into CodeWarrior for PlayStation and CodeWarrior for Net Yaroze. Again, the interested reader is vigorously recommended to these pages. Both the Sony and Metrowerks pages have links to related sites, email contacts, registration forms, etc.


Ed Ringel, eringel@mint.net, is Contributing Editor for product reviews for MacTech Magazine. In his spare time, he is a respiratory and critical care physician in Waterville, Maine.

Jeremy Vineyard, jeremyv@screenplay.com, is a software engineer at Screenplay Systems. His interests include developing games, software utilities, and application class libraries.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Is there cross-platform play in slither....
So you've sunken plenty of hours into crawling around in slither.io on your iPhone or iPad. You've got your stories of tragedy and triumph, the times you coiled four snakes at one time balanced out by the others when you had a length of more than... | Read more »
Rodeo Stampede guide to running a better...
In Rodeo Stampede, honing your skills so you can jump from animal to animal and outrun the herd as long as possible is only half the fun. Once you've tamed a few animals, you can bring them home with you. [Read more] | Read more »
VoxSyn (Music)
VoxSyn 1.0 Device: iOS Universal Category: Music Price: $6.99, Version: 1.0 (iTunes) Description: VoxSyn turns your voice into the most flexible vocal sound generator ever. Instantly following even subtle modulations of pitch and... | Read more »
Catch Battleplans on Google Play from Ju...
Real-time strategy title Battleplans is due for release on Google Play on June 30th, following its release for iOS systems last month. With its simple interface and pretty graphics, the crowd-pleaser brings a formerly overlooked genre out for the... | Read more »
iDoyle: The interactive Adventures of Sh...
iDoyle: The interactive Adventures of Sherlock Holmes - A Scandal in Bohemia 1.0 Device: iOS Universal Category: Books Price: $1.99, Version: 1.0 (iTunes) Description: Special Release Price $1.99 (Normally $3.99) | Read more »
Five popular free apps to help you slim...
Thanks to retail and advertising, we're used to thinking one season ahead. Here we are just a week into the summer and we're conditioned to start thinking about the fall. [Read more] | Read more »
How to ride longer and tame more animals...
It's hard to accurately describe Rodeo Stampede to people who haven't seen it yet. It's like if someone took Crossy Roadand Disco Zoo and put them in a blender, yet with a unique game mechanic that's still simple and fun for anyone. [Read more] | Read more »
Teeny Titans - A Teen Titans Go! Figure...
Teeny Titans - A Teen Titans Go! Figure Battling Game 1.0.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.0 (iTunes) Description: Teeny Titans, GO! Join Robin for a figure battling RPG of epic proportions! TEENY... | Read more »
NinjAwesome: Tips and tricks to be a mor...
Sorry about that headline, but I'm going to go ahead and assume that GameResort would not have named its game NinjAwesome without expecting some of that. It is, in fact, pretty awesome the way it combines an endless runner and old school arcade... | Read more »
Into Mirror (Games)
Into Mirror 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: "Is all that we see or seem, but a dream within a dream?"- Edgar Allan Poe New game by Lemon Jam Studio, the team behind Pursuit... | Read more »

Price Scanner via MacPrices.net

15-inch Retina MacBook Pros on sale for $200-...
B&H Photo has 15″ Retina MacBook Pros on sale for up to $210 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799.99 $200 off MSRP - 15″ 2.5GHz... Read more
Mac minis on sale for up to $100 off MSRP
B&H Photo has Mac minis on sale for up to $100 off MSRP including free shipping plus NY sales tax only: - 1.4GHz Mac mini: $449 $50 off MSRP - 2.6GHz Mac mini: $649 $50 off MSRP - 2.8GHz Mac mini... Read more
Clearance 2015 13-inch MacBook Airs available...
B&H Photo has clearance 2015 13″ MacBook Airs available for $300 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/4GB/128GB MacBook Air (MJVE2LL/A): $799.... Read more
Apple refurbished Mac minis available for up...
Apple has Certified Refurbished Mac minis available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz Mac mini: $419 $80 off MSRP - 2.6GHz Mac... Read more
ABBYY TextGrabber: 1,000,000 Installs in 5 Da...
ABBYY, an international OCR technologies provider, has announced that their image-to-text application TextGrabber, got installed 1,000,000 times in just five days while being featured by the App... Read more
New SkinIt Waterproof Case For iPhone 6
With its impact and waterproof design, the Skinit Waterproof case provides security and protection to guarantee your phone will get you through even the most demanding outdoor conditions. The impact-... Read more
iMacs on sale for up to $150 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $150 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2181.11 $118 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $1949... Read more
12-inch 1.1GHz Retina MacBooks on sale for $5...
B&H Photo has 2016 12″ 1.1GHz/256GB Retina MacBooks on sale for up to $50 off MSRP. Shipping is free, and B&H charges NY tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1249 $50 off MSRP... Read more
WWDC Announcements Revisited Still Underwhelm...
I was disappointed that no new MacBook hardware was announced at this year’s all-software World Wide Developer’s Conference. Not even a hint about what’s in the development pipeline. Of course, we... Read more
Twelve South Compass 2 iPad Stand Now Availab...
Twelve South has updated its most popular iPad stand, Compass 2, with the introduction of two new colors — Gold and Rose Gold. These new color options n perfectly complement the new Rose Gold iPad... Read more

Jobs Board

*Apple* iPhone 6s and New Products Tester Ne...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
Music Marketing Lead, iTunes & *Apple*...
…Music Marketing Lead is responsible for developing robust marketing campaigns and programs for Apple Music and iTunes across the whole of Apple ecosystem. This Read more
*Apple* Valley Medical Clinic is Hiring - AP...
Apple Valley Medical Clinic is Hiring! Apple Valley Medical Clinic is an independently owned practice operating a Family Medicine Clinic, a 24/7 Urgent Care, Read more
*Apple* New Products Testers Needed - Apple...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
*Apple* Solutions Consultant - APPLE (United...
Job Summary As an Apple Solutions Consultant, you'll be the link between our future customers and our products. You'll showcase your entrepreneurial spirit as you Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.