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

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Minecraft 302 - Popular sandbox building...
Minecraft allows players to build constructions out of textured cubes in a 3D procedurally generated world. Other activities in the game include exploration, gathering resources, crafting, and combat... Read more
FotoMagico 5.2b8 - Powerful slideshow cr...
FotoMagico lets you create professional slideshows from your photos and music with just a few, simple mouse clicks. It sports a very clean and intuitive yet powerful user interface. High image... Read more
TeamViewer 11.0.65452 - Establish remote...
TeamViewer gives you remote control of any computer or Mac over the Internet within seconds, or can be used for online meetings. Find out why more than 200 million users trust TeamViewer! Free for... Read more
Dropbox 9.4.49 - 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
Geekbench 4.0.0 - Measure processor and...
Geekbench provides a comprehensive set of benchmarks engineered to quickly and accurately measure processor and memory performance. Designed to make benchmarks easy to run and easy to understand,... Read more
Nisus Writer Pro 2.1.5 - Multilingual wo...
Nisus Writer Pro is a powerful multilingual word processor, similar to its entry level products, but brings new features such as table of contents, indexing, bookmarks, widow and orphan control,... Read more
Default Folder X 5.0.6 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click on... Read more
Alfred 3.1 - Quick launcher for apps and...
Alfred is an award-winning productivity application for OS X. Alfred saves you time when you search for files online or on your Mac. Be more productive with hotkeys, keywords, and file actions at... Read more
MYStuff Pro 2.0.25 - Create inventories...
MYStuff Pro is the most flexible way to create detail-rich inventories for your home or small business. Add items to MYStuff by dragging and dropping existing information, uploading new images, or... Read more
OmniOutliner Pro 4.6 - Pro version of th...
OmniOutliner Pro is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more

Lifeline: Crisis Line (Games)
Lifeline: Crisis Line 1.0.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.0 (iTunes) Description: | Read more »
BLUK (Games)
BLUK 1.1 Device: iOS Universal Category: Games Price: $1.99, Version: 1.1 (iTunes) Description: ** ‘Upcoming Game of the Year’ Finalist at NGF Awards 2015 ** ** ‘Big Indie Pitch’ Nominee at Pocket Gamer Connects 2016... | Read more »
How to get coins faster in Madden NFL Mo...
All aboard the coin train. By that I mean you need coins to improve your team in Madden NFL Mobile. Whether you prefer the excitement of opening packs or hitting up the auction house, your squad won't get any better without more coins to spend. [... | Read more »
Six! Tips, tricks, and hints for beginne...
There's nothing pretentious about Six!, the latest release from Gram Games. As puzzlers go, it's so unassuming that it took me some time to even realize why it was called what it was. Somewhere, my high school geometry teacher is now sobbing... | Read more »
Mobius Final Fantasy: Multiplayer update...
Up until now, Mobius Final Fantasy has been about as single-player an experience as an RPG can be. Not only do you play solo, but you are literally one among a seemingly unending wave of faceless warriors on the road toward the same goal. [Read... | Read more »
Find out the story behind League of Ange...
If you’re looking for a new thrilling MMORPG to play with your friends then you’ll be excited to hear that there is a sequel to one of the most well known titles in the genre – namely League of Angels 2. With a brand new 3D engine offering... | Read more »
Naruto Shippuden: Ultimate Ninja Blazing...
I'm not sure if it's possible to say you are an anime fan but also never have seen one episode of Naruto. If it is, then I resemble that remark, and if not, I offer a hearty apology. [Read more] | Read more »
5 mobile games that let you explore spac...
No Man's Sky hasn't exactly turned out to be everything it was promised. Though its core concept of exploring an unimaginably vast universe of different planets is an intriguing one, the execution has left many PS4 and PC gamers feeling like they... | Read more »
Mummy madness in new action game Tomb He...
Hot on the tail of Bump Hero, ZPlay is giving gamers another reason to get screen bashing with a brand new release. Tomb Heroes is a challenging action game in which you battle enemies in various tombs around the world. You can select from nine... | Read more »
Siralim 2 (RPG / Roguelike) (Games)
Siralim 2 (RPG / Roguelike) 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Siralim 2 is an old-school monster catching RPG. Summon and customize hundreds of creatures to fight for you as... | Read more »

Price Scanner via MacPrices.net

That Upgrade Itch; How Often Do You Upgrade Y...
I have a quandary to resolve as we head into what is typically a major Apple product upgrade season. My mid-2013 MacBook Air will be three years old and my iPad Air 2 will be two come late November.... Read more
Apple refurbished 12-inch iPad Pros available...
Apple has Certified Refurbished 12″ iPad Pros available for up to $160 off the cost of new iPads. An Apple one-year warranty is included with each model, and shipping is free: - 32GB 12″ iPad Pro... Read more
Tim Cook Posts Open Letter To The Apple Commu...
Apple Inc. CEO Tim Cook has posted an open letter commenting on the European Commission’s bizarre demand that Apple pay more than $14 billion in allegedly underpaid back taxes on its Irish... Read more
Streetwise Drivers Club App Now Features Open...
Streetwise Drivers Club, an app that rewards drivers with deals on everything from dining and gift cards to tires and insurance, has announced the launch of a new enhancement connecting app users... Read more
15-inch Retina MacBook Pros on sale for up to...
B&H Photo has 15″ Retina Apple MacBook Pros on sale for up to $200 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799 $200 off MSRP - 15″ 2.5GHz... Read more
RESCUECOM 2016 Semi-Annual Computer Reliabili...
The beginning of a new school year is upon us again, in which students and parents have some very important choices to make, often including the purchase of a computer or tablet. Whether you are... Read more
VRS Design Damda Glide Series iPhone 7 and 7...
What makes the Damda Glide Series for the iPhone 7 and iPhone 7 Plus special? Case maker VRS Design says its Damda Glide Series is the first mobile case to incorporate a semi-automatic mechanism for... Read more
Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more
Clearance 2015 13-inch MacBook Airs available...
B&H Photo has clearance 2015 13″ MacBook Airs available for $350 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/4GB/128GB MacBook Air (MJVE2LL/A): $829... Read more
Check Apple prices on any device with the iTr...
MacPrices is proud to offer readers a free iOS app (iPhones, iPads, & iPod touch) and Android app (Google Play and Amazon App Store) called iTracx, which allows you to glance at today’s lowest... Read more

Jobs Board

*Apple* Retail - Multiple Positions Norfolk,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions- Tampa,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
SW Engineer *Apple* TV - Apple Inc. (United...
The Apple TV team is looking for excellent software engineers with experience in hardware, media management, media playback, content delivery and a passion for Read more
*Apple* Solutions Consultant - Apple (United...
Apple Solutions ConsultantJob Number: 51218534Pleasant Hill, California, United StatesPosted: Aug. 18, 2016Weekly Hours: 40.00Job SummaryAs an Apple Solutions Read more
*Apple* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 51218354 Fredericksburg, Virginia, United States Posted: Aug. 18, 2016 Weekly Hours: 40.00 **Job Summary** As an Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.