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

Apple iOS 9.3.5 - The latest version of...
iOS is the world’s most advanced mobile operating system, and it’s the foundation of iPhone, iPad, and iPod touch. It comes with a collection of apps and features that let you do the everyday things... Read more
Parallels Desktop 12.0.0 - Run Windows a...
Parallels allows you to run Windows and Mac applications side by side. Choose your view to make Windows invisible while still using its applications, or keep the familiar Windows background and... Read more
Spotify 1.0.36.124. - Stream music, crea...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
Firefox 48.0.2 - Fast, safe Web browser.
Firefox offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and casual... Read more
BBEdit 11.6.1 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
OmniGraffle Pro 6.6.1 - Create diagrams,...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
OmniGraffle 6.6.1 - Create diagrams, flo...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
Dropbox 8.4.21 - Cloud backup and synchr...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
BetterTouchTool 1.84 - Customize Multi-T...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
ScreenFlow 6.1 - Create screen recording...
ScreenFlow is powerful, easy-to-use screencasting software for the Mac. With ScreenFlow you can record the contents of your entire monitor while also capturing your video camera, microphone and your... Read more

Cartoon Network Superstar Soccer: Goal!!...
Cartoon Network Superstar Soccer: Goal!!! – Multiplayer Sports Game Starring Your Favorite Characters 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Become a soccer superstar with your... | Read more »
NFL Huddle: What's new in Topps NFL...
Can you smell that? It's the scent of pigskin in the air, which either means that cliches be damned, pigs are flying in your neck of the woods, or the new NFL season is right around the corner. [Read more] | Read more »
FarmVille: Tropic Escape tips, tricks, a...
Maybe farming is passé in mobile games now. Ah, but farming -- and doing a lot of a other things too -- in an island paradise might be a little different. At least you can work on your tan and sip some pina coladas while tending to your crops. [... | Read more »
Become the King of Avalon in FunPlus’ la...
King Arthur is dead. Considering the legend dates back to the 5th century, it would be surprising if he wasn’t. But in the context of real-time MMO game King of Avalon: Dragon Warfare, Arthur’s death plunges the kingdom into chaos. Evil sorceress... | Read more »
Nightgate (Games)
Nightgate 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: *** Launch Sale: 25% OFF for a limited time! *** In the year 2398, after a great war, a network of intelligent computers known as... | Read more »
3 best fantasy football apps to get you...
Last season didn't go the way you wanted it to in fantasy football. You were super happy following your drafts or auctions, convinced you had outsmarted everyone. You were all set to hustle on the waiver wire, work out some sweet trades, and make... | Read more »
Pokemon GO update: Take me to your leade...
The Team Leaders in Pokemon GO have had it pretty easy up until now. They show up when players reach level 5, make their cases for joining their respective teams, and that's pretty much it. Light work, as Floyd Mayweather might say. [Read more] | Read more »
Ruismaker FM (Music)
Ruismaker FM 1.0 Device: iOS Universal Category: Music Price: $4.99, Version: 1.0 (iTunes) Description: Following up on the success of Ruismaker, here's her crazy twin-sister, designed for people who want to design their own... | Read more »
Space Marshals 2 (Games)
Space Marshals 2 1.0.15 Device: iOS iPhone Category: Games Price: $5.99, Version: 1.0.15 (iTunes) Description: The sci-fi wild west adventure in outer space continues with Space Marshals 2. This tactical top-down shooter puts you in... | Read more »
Dungeon Warfare (Games)
Dungeon Warfare 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: Dungeon Warfare is a challenging tower defense game where you become a dungeon lord to defend your dungeon against greedy... | Read more »

Price Scanner via MacPrices.net

BookBook Releases SurfacePad, BookBook &...
BookBook has released three new covers just for iPad Pro: SurfacePad, BookBook and BookBook Rutledge Edition. BookBook for iPad Pro is a gorgeous leather case reminiscent of a vintage sketchbook.... Read more
Clean Text 1.0 for iOS Reduces Text Cleanup a...
Apimac today announced availability of Clean Text for iOS, a tool for webmasters, graphic designers, developers and magazine editors to reduce text cleanup and editing time, and also for any iPhone... Read more
27-inch iMacs on sale for up to $220 off MSRP
B&H Photo has 27″ Apple iMacs on sale for up to $200 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2099 $200 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $1899 $100... Read more
Apple refurbished 13-inch MacBook Airs availa...
Apple has Certified Refurbished 2016 and 2015 13″ MacBook Airs now available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: - 2016 13″ 1.6GHz/8GB/... Read more
Apple refurbished iPad mini 2s available for...
Apple is offering Certified Refurbished iPad mini 2s for up to $80 off the cost of new minis. An Apple one-year warranty is included with each model, and shipping is free: - 16GB iPad mini 2 WiFi: $... Read more
Save up to $600 with Apple refurbished Mac Pr...
Apple has Certified Refurbished Mac Pros available for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The following... Read more
Mac Pros on sale for $200 off MSRP
B&H Photo has Mac Pros on sale for $200 off MSRP. Shipping is free, and B&H charges sales tax in NY only: - 3.7GHz 4-core Mac Pro: $2799, $200 off MSRP - 3.5GHz 6-core Mac Pro: $3799, $200... Read more
Will We See A 10.5″ iPad Pro in 2017? – The ‘...
A MacRumors report, cites a research note from KGI Securities analyst Ming-Chi Kuo, saying a new size iPad model is in the works. According to the highly respected Cho, who has a strong track record... Read more
IOGEAR USB-C Docking Station Transforms Lapto...
IOGEAR has announced the launch of its innovative USB-C Docking Station with Power Delivery which turns USB-C enabled laptops into desktop workstations. The new IOGEAR USB-C Docking Station features... Read more
12-inch Retina MacBooks on sale for up to $10...
Amazon has 2016 12″ Apple Retina MacBooks on sale for $100 off MSRP. Shipping is free: - 12″ 1.1GHz Space Gray Retina MacBook: $1199 $100 off MSRP - 12″ 1.1GHz Silver Retina MacBook: $1224.99 $75 off... Read more

Jobs Board

*Apple* Professional Learning Specialist - A...
# Apple Professional Learning Specialist Job Number: 51234243 Portland, Maine, Maine, United States Posted: Aug. 18, 2016 Weekly Hours: 40.00 **Job Summary** The Read more
*Apple* Mobile Master - Best Buy (United Sta...
What does a Best Buy Apple Mobile Master do? At Best Buy, our mission is to leverage the unique talents and passions of our employees to inspire, delight, and enrich Read more
*Apple* Retail - Multiple Positions Akron, O...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Simply Mac *Apple* Specialist- Repair Techn...
…The Technician is a master at working with our customers to diagnose and repair Apple devices in a manner that exceeds the expectations set forth by Apple Read more
*Apple* Retail - Multiple Positions Germanto...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.