TweetFollow Us on Twitter

Nubus Slots
Volume Number:6
Issue Number:4
Column Tag:XCMD Corner

Related Info: Slot Manager Resource Manager

Exploring NuBus Slots

By Donald Koscheka, Ernst & Young, MacTutor Contributing Editor

Getting on the NuBus

One of the more salient differences between a personal computer and a mini computer is the bus architecture that is used to pipe data between the processor and its peripherals. Minicomputer designers expend great amounts of energy trying to optimize the system’s bus for throughput and flexibility. Personal computer designers seem to be willing to trade bandwidth for cost and “plug compatibility”. The Macintosh II clearly falls into this latter category. The choice of NuBus could only have been made on economic grounds; technologically it is one of the least inspiring choices possible as is evidenced by the use of byte lanes to correct the fact that NuBus is optimized for intel 808x processors.

While I’m underwhelmed with the choice of NuBus, I have to admit that it’s well documented in yet another outstanding technical reference piece available from Apple, Designing Cards and Drivers for Macintosh II and Macintosh SE (Addison Wesley).

A friend of mine asked if I could put together an XCMD that would return the names of all the NuBus cards plugged into the slots on a Macintosh II. I thought this a reasonable request so I plunged into the Slot Manager documentation in IM Volume V to figure out how to assemble such an XCMD. Like the rest of Inside Macintosh, the Slot Manager is a reference piece; it does a good job of documenting the calls to the slot manager but doesn’t go into a lot of depth on how to use these calls.

I called my friend to tell him that I thought the problem was solvable but that the documentation just didn’t lead to a quick solution. He suggested that I scan “Phil and Dave’s Excellent CD” for some examples on how to use the slot manager. Well the only thing I was able to turn up was a hastily written little application called “getsinfo”. To my chagrin, I couldn’t find any source code to this example so I took out MacNosy and began disassembling the code. Supplementing the information gleaned from MacNosy with some careful TMON walk throughs of the application , I pieced together enough information to write the XCMD.

Listing 1 presents an xcmd that returns a Hypercard list of each card plugged into the slots on a Macintosh II. If no card is plugged into a particular slot, it returns a “Empty Slot”. The information presented here augments what I’ve learned by reading the available documentation and by disassembling some code. Although the code in listing 1 works, it may not be complete or bulletproof so make sure that you use it as a point of embarkation. If you intend to explore NuBus further, I suggest that you get both Inside Macintosh, Volume V and Designing Cards and Drivers. I will be happy to publish any corrections or enhancements to this code if anyone feels inclined to take it out for a spin.

Talking to the Slots

Understanding this code requires a quick refresher course in I/O addressing on the Macintosh. The traditional Macintosh II memory map is depicted in Figure 1. Note that the NuBus cards are addressed just as if they were memory chips located between $90 000 and $EF FFFF. Each slot has up to one megabyte of address space assigned to it. Slot memory starts at location $90 0000 (above the ROM) so the six slots are number from $9-$E rather than from from 1 to 6 as might be expected. When making calls to the slot manager that require a slot number, you’ll want to make sure that the number falls between $9 and $E. Although the Mac II is assigned to slot 0, accessing its memory space will generate a bus error (its memory is assigned from $F0 0000 to the top of memory).

These rules change for 32 bit addressing but the 24-bit mode suffices for illustration.

FIGURE 1. Mac II Memory Model (24 bit addresses )

This memory map goes a long way towards explaining why slots are number starting at 9 rather than at 0 or 1. This doesn’t imply that the slots below 9 are reserved by Apple but rather that slots are numbered to correspond with where they reside in memory.

Communication with the slot manager takes place via a record called the SpBlock (think of it as a parameter block for slots). This “slot block” contains fields that are filled in as needed for a given call (See IM V-439 for more details on the slot block). Typically, you need to supply the slot number in the spSlot field and a slot list identification number in spID. Results are returned in the appropriate field or in the spResult field as needed.

Each NuBus card has associated with it a block of firmware called the declaration ROM. This area of card memory is used to store information that is needed by the card. The declaration ROM is organized into slot resources which act like resources in the Macintosh resource manager (they are related but are not interchangeable). Each sResource has a type and a name. For our purposes, we don’t need to concern ourselves with the exact structure of each sResources. We do need to figure out how to find the card name within the card’s declaration ROM.

Before querying a card in slot x for its name, it’s a good idea to check to see that slot x has a card installed in the first place. In listing 1, this is accomplished using the call to SReadInfo. We pass this call the slot number and the address of an sInfoRecord. Poll the siInitStatusA field of this record to determine whether the card is initialized. If the card is installed and initialized, this field will be set to 0 otherwise it will contain an error message describing why the card couldn’t be initialized. If the slot is empty , siInitStatusA will be set to -300, (smEmptySlot). In our slot loop, we ignore slots that are not installed and set the appropriate entry in the slot name list to “empty slot”.

If the slot is initialized, then we get the spID of the first sResource on the card with the call to sNextTypesRsrc. Now I determined this by disassembling the getsinfo application but it seems to me that sNextRsrc might have been just as useful. Since cards can have multiple functions, they can also have multiple resources. To get the name of each “sub device” you will probably need to walk through the sResource list, thus the call to sNextTypesRsrc.

All I’m really interested in is the spID returned by sNextTypesRsrc. Once gotten, I pass this id to sReadDrvrName to get the name of the driver that handles this card (it seems reasonable to associate the name of the card with the name of the driver that codes for it). This is accomplished with a call to sReadDrvrName although getsinfo appears to take another tack preferring to use SGetCString to extract the card name via a slightly more convoluted scheme. The problem with sGetDrvrName is that it returns the card name as a pascal string preceded by a “.” so that this name can be passed directly to openDriver. No big deal, I simply convert the string back to a “C” string and ignore the first character as it was added to the string anyway.

SlotInfo.c loops for as many slots as it can get information about in the call to SReadInfo. I chose this approach rather than using a for loop (0x09..0x0E) because not all Mac II’s have six slots. Thus slotinfo returns an entry for each slot in the physical machine regardless of whether the slot holds a card or not.

The results of this investigation were interesting. For example, the Apple video card is named the “Toby Frame Buffer” no doubt in honor of its inventor, Toby Frame Buffer. This name may not be too meaningful to the average user so my Hypercard handler for this XCMD converts it to “Apple Video Card”.

Conclusion

At any rate, this is a starting point for anyone that needs to explore programming for NuBus. I hope that the information is mostly correct, but if I’ve made any errors, please be kind enough to pass on the corrections to this magazine so that we can all expand our knowledge of this area.

Ther’s lots of things that you can do once armed with this information such as poll choice locations on the cards, return card status information and, of course, provide a software mechanism for telling the user what’s got under the hood so people don’t have to go around popping their tops every time they want to find out how their Macs are configured.

/****************************************/
/* File: SlotInfo.c*/
/* */
/* Returns a hypercard compatible list */
/* of the names of the cards in each of*/
/* the nuBus slots.*/
/****************************************/

#define UsingHypercard

#include<MacTypes.h>
#include<OSUtil.h>
#include<MemoryMgr.h>
#include<pascal.h>
#include<string.h>
#include “HyperXCmd.h”
#include<HyperUtils.h>
/* obtained from back issues of MacTutor */
#include<SlotMgr.h>

#define SLOT1  0x09

pascal void main( paramPtr )
 XCmdBlockPtr  paramPtr;
{
 short  slotnum  = SLOT1;
 OSErr  err;
 Handle SlotList = NewHandle( 0L );
 short  sResIndex;
 SpBlockslotblok;
 SInfoRecordslotinfo;
 char   slotName[256];
 
 /*** Loop until no more slots found ***/
 
 while( 1 ){
 slotblok.spSlot = slotnum;
 slotblok.spResult = (long)&slotinfo;
 
 if( (err = SReadInfo( &slotblok ) ) == noErr ){
 if( slotinfo.siInitStatusA == 0 ){
 /*** have a card in this slot ***/
 sResIndex = 0;
 
 slotblok.spSlot = slotnum;
 slotblok.spID = sResIndex;
 
 slotblok.spTBMask = 3;
 slotblok.spCategory = 1;
 slotblok.spCType= 0;
 slotblok.spDrvrHW = 0;
 slotblok.spDrvrSW = 0;
 slotblok.spHwDev= 0;
 slotblok.spExtDev = 0;
 err = SNextTypesRsrc( &slotblok );
 
 slotblok.spResult = (long)&slotName;
 
 DebugStr(“\p read name”);
 err = SReadDrvrName( &slotblok );
 
 if( !err ){
 PtoCstr( (char *)&slotName );
 CopyStrToHandle( (char *)&(slotName[1]), SlotList );
 }
 
 AppendCharToHandle( SlotList, ‘\r’ );

 }
 else
 pStrToField( “\pEmpty Slot”, ‘\r’, SlotList );
 
 slotnum++;
 }
 else
 break;
 }
 AppendCharToHandle( SlotList, ‘\0’ );
 paramPtr->returnValue = SlotList;
}

Listing 1. SlotInfo.c XCMD

 
AAPL
$97.67
Apple Inc.
+0.00
MSFT
$43.63
Microsoft Corpora
+0.00
GOOG
$511.17
Google Inc.
+0.00

MacTech Search:
Community Search:

Software Updates via MacUpdate

Autopano Giga 3.7 - Stitch multiple imag...
Autopano Giga allows you to stitch 2, 20, or 2,000 images. Version 3.0 integrates impressive new features that will definitely make you adopt Autopano Pro or Autopano Giga: Choose between 9... Read more
MenuMeters 1.8 - CPU, memory, disk, and...
MenuMeters is a set of CPU, memory, disk, and network monitoring tools for Mac OS X. Although there are numerous other programs which do the same thing, none had quite the feature set I was looking... Read more
Coda 2.5 - One-window Web development su...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few... Read more
Arq 4.6.1 - Online backup to Google Driv...
Arq is super-easy online backup for the Mac. Back up to your own Google Drive storage (15GB free storage), your own Amazon Glacier ($.01/GB per month storage) or S3, or any SFTP server. Arq backs up... Read more
Airfoil 4.8.10 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
Apple iMovie 10.0.6 - Edit personal vide...
With an all-new design, Apple iMovie lets you enjoy your videos like never before. Browse your clips more easily, instantly share your favorite moments, and create beautiful HD movies and Hollywood-... Read more
Tunnelblick 3.4.1 - GUI for OpenVPN. (Fr...
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
OnyX 2.8.8 - Maintenance and optimizatio...
OnyX is a multifunctional utility for OS X. It allows you to verify the startup disk and the structure of its System files, to run miscellaneous tasks of system maintenance, to configure the hidden... Read more
Parallels Desktop 10.1 - Run Windows app...
Parallels Desktop is simply the world's bestselling, top-rated, and most trusted solution for running Windows applications on your Mac. With Parallels Desktop for Mac, you can seamlessly run both... Read more
Apple Keynote 6.5 - Apple's present...
Apple Keynote makes it simple to create and deliver beautiful presentations. Powerful tools and dazzling effects bring your ideas to life. You can work seamlessly between Mac and iOS devices. And... Read more

Latest Forum Discussions

See All

Hay Ewe Review
Hay Ewe Review By Campbell Bird on October 20th, 2014 Our Rating: :: SAVE YOUR SHEEPLEUniversal App - Designed for iPhone and iPad Pave the way for your flock in this line drawing puzzle game from the creators of Worms.   | Read more »
My Very Hungry Caterpillar (Education)
My Very Hungry Caterpillar 1.0.0 Device: iOS Universal Category: Education Price: $3.99, Version: 1.0.0 (iTunes) Description: Care for your very own Very Hungry Caterpillar! My Very Hungry Caterpillar will captivate you as he crawls... | Read more »
Dungeon Dick (Games)
Dungeon Dick 1.1 Device: iOS Universal Category: Games Price: $.99, Version: 1.1 (iTunes) Description: Dungeon Dick is a fantasy adventure where you must discover the wicked plot to destroy the lands . 'Fling' at your foes and land... | Read more »
Here’s How the Apple Watch Could Transfo...
With the Apple Watch’s generic release date of, “early 2015” hovering on the horizon, it’s only a matter of time before gamers begin to ask “What’s in it for us?” The obvious choice would be to place entire games directly on the face of the watch,... | Read more »
Republique Episode 3: Ones & Zeroes...
Republique Episode 3: Ones & Zeroes is Available Now Posted by Rob Rich on October 17th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Loot Raiders Review
Loot Raiders Review By Campbell Bird on October 17th, 2014 Our Rating: :: PRESS BUTTON, GET LOOTUniversal App - Designed for iPhone and iPad This menu-based loot game is suitable to compel those with pretty extreme loot lust.   | Read more »
There’s Something Strange in Fruit Ninja...
There’s Something Strange in Fruit Ninja’s Neighborhood Posted by Rob Rich on October 17th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Cars: Fast as Lightning Review
Cars: Fast as Lightning Review By Nadia Oxford on October 17th, 2014 Our Rating: :: SMOOTH RIDEUniversal App - Designed for iPhone and iPad Cars: Fast as Lightning is a good city-building/racing game, though it’s probably too... | Read more »
Angry Birds are Crashing Puzzle & Dr...
Angry Birds are Crashing Puzzle & Dragons Next Week Posted by Rob Rich on October 17th, 2014 [ permalink ] Next week, Puzzle & Dragons is getting a little angry. Because, you know, Angry Birds. It’s a… a pun. I thought… never mind. | Read more »
Incandescence Review
Incandescence Review By Andrew Fisher on October 17th, 2014 Our Rating: :: ALL TAPPED OUTUniversal App - Designed for iPhone and iPad Incandescence promises intense tapping action, but isn’t particularly fun.   | Read more »

Price Scanner via MacPrices.net

2013 15-inch 2.0GHz Retina MacBook Pro availa...
B&H Photo has leftover previous-generation 15″ 2.0GHz Retina MacBook Pros now available for $1599 including free shipping plus NY sales tax only. Their price is $400 off original MSRP. B&H... Read more
Updated iPad Prices
We’ve updated our iPad Air Price Tracker and our iPad mini Price Tracker with the latest information on prices and availability from Apple and other resellers, including the new iPad Air 2 and the... Read more
Apple Pay Available to Millions of Visa Cardh...
Visa Inc. brings secure, convenient payments to iPad Air 2 and iPad mini 3as well as iPhone 6 and 6 Plus. Starting October 20th, eligible Visa cardholders in the U.S. will be able to use Apple Pay,... Read more
Textkraft Pocket – the missing TextEdit for i...
infovole GmbH has announced the release and immediate availability of Textkraft Pocket 1.0, a professional text editor and note taking app for Apple’s iPhone. In March 2014 rumors were all about... Read more
C Spire to offer iPad Air 2 and iPad mini 3,...
C Spire on Friday announced that it will offer iPad Air 2 and iPad mini 3, both with Wi-Fi + Cellular, on its 4G+ LTE network in the coming weeks. C Spire will offer the new iPads with a range of... Read more
Belkin Announces Full Line of Keyboards and C...
Belkin International has unveiled a new lineup of keyboard cases and accessories for Apple’s newest iPads, featuring three QODE keyboards and a collection of thin, lightweight folios for both the... Read more
Verizon offers new iPad Air 2 preorders for $...
Verizon Wireless is accepting preorders for the new iPad Air 2, cellular models, for $100 off MSRP with a 2-year service agreement: - 16GB iPad Air 2 WiFi + Cellular: $529.99 - 64GB iPad Air 2 WiFi... Read more
Price drops on refurbished Mac minis, now ava...
The Apple Store has dropped prices on Apple Certified Refurbished previous-generation Mac minis, with models now available starting at $419. Apple’s one-year warranty is included with each mini, and... Read more
Apple refurbished 2014 MacBook Airs available...
The Apple Store has Apple Certified Refurbished 2014 MacBook Airs available for up to $180 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is free.... Read more
Refurbished 2013 MacBook Pros available for u...
The Apple Store has Apple Certified Refurbished 13″ and 15″ MacBook Pros available starting at $929. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook Pros (4GB RAM/... Read more

Jobs Board

Position Opening at *Apple* - Apple (United...
**Job Summary** At the Apple Store, you connect business professionals and entrepreneurs with the tools they need in order to put Apple solutions to work in their Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** The Apple Store is a retail environment like no other - uniquely focused on delivering amazing customer experiences. As an Expert, you introduce people Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** As businesses discover the power of Apple computers and mobile devices, it's your job - as a Solutions Engineer - to show them how to introduce these Read more
Position Opening at *Apple* - Apple (United...
…Summary** As a Specialist, you help create the energy and excitement around Apple products, providing the right solutions and getting products into customers' hands. You Read more
Project Manager, *Apple* Financial Services...
**Job Summary** Apple Financial Services (AFS) offers consumers, businesses and educational institutions ways to finance Apple purchases. We work with national and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.