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

Latest Forum Discussions

See All

Pack a magnifying glass and practice you...
Somehow it has already been a year since Torchlight: Infinite launched, and XD Games is celebrating by blending in what sounds like a truly fantastic new update. Fans of Cthulhu rejoice, as Whispering Mist brings some horror elements, and tests... | Read more »
Summon your guild and prepare for war in...
Netmarble is making some pretty big moves with their latest update for Seven Knights Idle Adventure, with a bunch of interesting additions. Two new heroes enter the battle, there are events and bosses abound, and perhaps most interesting, a huge... | Read more »
Make the passage of time your plaything...
While some of us are still waiting for a chance to get our hands on Ash Prime - yes, don’t remind me I could currently buy him this month I’m barely hanging on - Digital Extremes has announced its next anticipated Prime Form for Warframe. Starting... | Read more »
If you can find it and fit through the d...
The holy trinity of amazing company names have come together, to release their equally amazing and adorable mobile game, Hamster Inn. Published by HyperBeard Games, and co-developed by Mum Not Proud and Little Sasquatch Studios, it's time to... | Read more »
Amikin Survival opens for pre-orders on...
Join me on the wonderful trip down the inspiration rabbit hole; much as Palworld seemingly “borrowed” many aspects from the hit Pokemon franchise, it is time for the heavily armed animal survival to also spawn some illegitimate children as Helio... | Read more »
PUBG Mobile teams up with global phenome...
Since launching in 2019, SpyxFamily has exploded to damn near catastrophic popularity, so it was only a matter of time before a mobile game snapped up a collaboration. Enter PUBG Mobile. Until May 12th, players will be able to collect a host of... | Read more »
Embark into the frozen tundra of certain...
Chucklefish, developers of hit action-adventure sandbox game Starbound and owner of one of the cutest logos in gaming, has released their roguelike deck-builder Wildfrost. Created alongside developers Gaziter and Deadpan Games, Wildfrost will... | Read more »
MoreFun Studios has announced Season 4,...
Tension has escalated in the ever-volatile world of Arena Breakout, as your old pal Randall Fisher and bosses Fred and Perrero continue to lob insults and explosives at each other, bringing us to a new phase of warfare. Season 4, Into The Fog of... | Read more »
Top Mobile Game Discounts
Every day, we pick out a curated list of the best mobile discounts on the App Store and post them here. This list won't be comprehensive, but it every game on it is recommended. Feel free to check out the coverage we did on them in the links below... | Read more »
Marvel Future Fight celebrates nine year...
Announced alongside an advertising image I can only assume was aimed squarely at myself with the prominent Deadpool and Odin featured on it, Netmarble has revealed their celebrations for the 9th anniversary of Marvel Future Fight. The Countdown... | Read more »

Price Scanner via MacPrices.net

Every model of Apple’s 13-inch M3 MacBook Air...
Best Buy has Apple 13″ MacBook Airs with M3 CPUs in stock and on sale today for $100 off MSRP. Prices start at $999. Their prices are the lowest currently available for new 13″ M3 MacBook Airs among... Read more
Sunday Sale: Apple iPad Magic Keyboards for 1...
Walmart has Apple Magic Keyboards for 12.9″ iPad Pros, in Black, on sale for $150 off MSRP on their online store. Sale price for online orders only, in-store price may vary. Order online and choose... Read more
Apple Watch Ultra 2 now available at Apple fo...
Apple has, for the first time, begun offering Certified Refurbished Apple Watch Ultra 2 models in their online store for $679, or $120 off MSRP. Each Watch includes Apple’s standard one-year warranty... Read more
AT&T has the iPhone 14 on sale for only $...
AT&T has the 128GB Apple iPhone 14 available for only $5.99 per month for new and existing customers when you activate unlimited service and use AT&T’s 36 month installment plan. The fine... Read more
Amazon is offering a $100 discount on every M...
Amazon is offering a $100 instant discount on each configuration of Apple’s new 13″ M3 MacBook Air, in Midnight, this weekend. These are the lowest prices currently available for new 13″ M3 MacBook... Read more
You can save $300-$480 on a 14-inch M3 Pro/Ma...
Apple has 14″ M3 Pro and M3 Max MacBook Pros in stock today and available, Certified Refurbished, starting at $1699 and ranging up to $480 off MSRP. Each model features a new outer case, shipping is... Read more
24-inch M1 iMacs available at Apple starting...
Apple has clearance M1 iMacs available in their Certified Refurbished store starting at $1049 and ranging up to $300 off original MSRP. Each iMac is in like-new condition and comes with Apple’s... Read more
Walmart continues to offer $699 13-inch M1 Ma...
Walmart continues to offer new Apple 13″ M1 MacBook Airs (8GB RAM, 256GB SSD) online for $699, $300 off original MSRP, in Space Gray, Silver, and Gold colors. These are new MacBook for sale by... Read more
B&H has 13-inch M2 MacBook Airs with 16GB...
B&H Photo has 13″ MacBook Airs with M2 CPUs, 16GB of memory, and 256GB of storage in stock and on sale for $1099, $100 off Apple’s MSRP for this configuration. Free 1-2 day delivery is available... Read more
14-inch M3 MacBook Pro with 16GB of RAM avail...
Apple has the 14″ M3 MacBook Pro with 16GB of RAM and 1TB of storage, Certified Refurbished, available for $300 off MSRP. Each MacBook Pro features a new outer case, shipping is free, and an Apple 1-... Read more

Jobs Board

*Apple* Systems Administrator - JAMF - Activ...
…**Public Trust/Other Required:** None **Job Family:** Systems Administration **Skills:** Apple Platforms,Computer Servers,Jamf Pro **Experience:** 3 + years of Read more
IT Systems Engineer ( *Apple* Platforms) - S...
IT Systems Engineer ( Apple Platforms) at SpaceX Hawthorne, CA SpaceX was founded under the belief that a future where humanity is out exploring the stars is Read more
Nurse Anesthetist - *Apple* Hill Surgery Ce...
Nurse Anesthetist - Apple Hill Surgery Center Location: WellSpan Medical Group, York, PA Schedule: Full Time Sign-On Bonus Eligible Remote/Hybrid Regular Apply Now Read more
Housekeeper, *Apple* Valley Village - Cassi...
Apple Valley Village Health Care Center, a senior care campus, is hiring a Part-Time Housekeeper to join our team! We will train you for this position! In this role, Read more
Sublease Associate Optometrist- *Apple* Val...
Sublease Associate Optometrist- Apple Valley, CA- Target Optical Date: Apr 20, 2024 Brand: Target Optical Location: Apple Valley, CA, US, 92307 **Requisition Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.