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

calibre 4.17.0 - Complete e-book library...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
MacPilot 11.1.4 - $15.96
MacPilot gives you the power of UNIX and the simplicity of Macintosh, which means a phenomenal amount of untapped power in your hands! Use MacPilot to unlock over 1,200 features, and access them all... Read more
Transmission 3.00 - Popular BitTorrent c...
Transmission is a fast, easy, and free multi-platform BitTorrent client. Transmission sets initial preferences so things "just work", while advanced features like watch directories, bad peer blocking... Read more
Doom 3 1.3.1 - First-person shooter acti...
A massive demonic invasion has overwhelmed the Union Aerospace Corporation's (UAC) Mars Research Facility, leaving only chaos and horror in its wake. As one of only a few survivors, you must fight... Read more
Box Sync 4.0.8004 - Online synchronizati...
Box Sync gives you a hard-drive in the Cloud for online storage. Note: You must first sign up to use Box. What if the files you need are on your laptop -- but you're on the road with your iPhone? No... Read more
LibreOffice 6.4.4.2 - Free, open-source...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
Day One 4.14 - Maintain a daily journal.
Day One is an easy, great-looking way to use a journal / diary / text-logging application. Day One is well designed and extremely focused to encourage you to write more through quick Menu Bar entry,... Read more
Doxie 2.12.2 - Scan, share, and store do...
Introducing Doxie, the new, modern paper scanner that's so simple, it'll revolutionize the way you think about sharing and storing docs and photos forever. Doxie is ultra-portable, fully automatic,... Read more
Tinderbox 8.7.0 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
Viber 13.0.0 - Send messages and make fr...
Viber lets you send free messages and make free calls to other Viber users, on any device and network, in any country! Viber syncs your contacts, messages and call history with your mobile device, so... Read more

Latest Forum Discussions

See All

SINoALICE, Yoko Taro and Pokelabo's...
Yoko Taro and developer Pokelabo's SINoALICE has now opened for pre-registration over on the App Store. It's already amassed 1.5 million Android pre-registrations, and it's currently slated to launch on July 1st. [Read more] | Read more »
Masketeers: Idle Has Fallen's lates...
Masketeers: Idle Has Fallen is the latest endeavour from Appxplore, the folks behind Crab War, Thor: War of Tapnarok and Light A Way. It's an idle RPG that's currently available for Android in Early Access and will head to iOS at a later date. [... | Read more »
Evil Hunter Tycoon celebrates 2 million...
Evil Hunter Tycoon has proved to be quite the hit since launching back in March, with its most recent milestone being 2 million downloads. To celebrate the achievement, developer Super Planet has released a new updated called Darkness' Front Yard... | Read more »
Peak's Edge is an intriguing roguel...
Peak's Edge is an upcoming roguelike puzzle game from developer Kenny Sun that's heading for both iOS and Android on June 4th as a free-to-play title. It will see players rolling a pyramid shape through a variety of different levels. [Read more] | Read more »
Clash Royale: The Road to Legendary Aren...
Supercell recently celebrated its 10th anniversary and their best title, Clash Royale, is as good as it's ever been. Even for lapsed players, returning to the game is as easy as can be. If you want to join us in picking the game back up, we've put... | Read more »
The Magic Gladiator class arrives in MU...
The Magic Gladiator class is now available in MU Origin 2 following the most recent patch. It also marks the start of Abyss Season 11 and the introduction of Couple Skills and Couple Dungeons. [Read more] | Read more »
The 5 Best Racing Games
With KartRider Rush+ making a splash this past week, we figured it was high time we updated our list of the best mobile racing games out there. From realistic racing sims to futuristic arcade racers (and even racing management games!), check out... | Read more »
KartRider Rush+ Guide - Tips for new rac...
KartRider Rush+ continues to be a surprisingly refreshing and fun kart racer that's entirely free-to-play. The main reason for this is just how high its skill ceiling is. Check out the video above if you're curious to know what top level play looks... | Read more »
KartRider Rush+ might be good, actually?
It's hard to find good racing games on mobile. Most of them are free-to-play, and free-to-play racers generally suck. Even Nintendo couldn't put together a competent Mario Kart game, opting instead for a weird score chaser that resembles--but feels... | Read more »
LifeAfter, NetEase's popular surviv...
A new map will be making its way into NetEase's popular survival game LifeAfter. The map is set to arrive on May 28th and will introduce a volcano that's teetering on the verge of eruption, bringing a host of added challenges to the game. [Read... | Read more »

Price Scanner via MacPrices.net

Memorial Day Weekend Sale: Take $300 off thes...
Apple resellers are offering $300 discounts on select 16″ MacBook Pros as part of their Memorial Day Weekend 2020 sales. Prices start at $2099: – 16″ 2.6GHz 6-Core Space Gray MacBook Pro: $2099 at... Read more
Best Memorial Day Weekend 2020 Apple AirPods...
Apple resellers are offering discounts ranging up to $50 off MSRP on AirPods as part of their Memorial Day Weekend 2020 sales. These are the best deals today on various AirPods models. See our... Read more
Memorial Day Weekend Sale: 10″ Apple iPads fo...
Amazon is offering new 10.2″ iPads for $80-$100 off Apple’s MSRP as part of their Memorial Day Weekend 2020 sale, with prices starting at only $249. These are the same iPads sold by Apple in their... Read more
Memorial Day Weekend Sale: 2020 Apple iPhone...
Sprint is offering Apple’s new 2020 64GB iPhone SE for $0 per month for 18 months as part of their Memorial Day Weekend 2020 sale. New line of service and trade-in required. Offer is valid from 5/22/... Read more
Amazon’s popular $100 Apple Watch Series 5 di...
Amazon has Apple Watch Series 5 GPS + Cellular models on sale for up to $100 off Apple’s MSRP today. Shipping is free. These are the same Apple Watch models sold by Apple in their retail and online... Read more
2020 13″ 4-Core MacBook Air on sale for $949,...
Apple reseller Adorama has the new 2020 13″ 1.1GHz 4-Core Space Gray MacBook Air on sale today for $949 shipped. Their price is $50 off Apple’s MSRP, and it’s the lowest price currently available for... Read more
Apple Retail Chief Announces Staggered Reopen...
NEWS: 05.20.20 – In the midst of a global pandemic, after its retail outlets were shuttered temporarily in mid-March as a mitigation measure enacted by Apple during the peak of the spread of COVID-19... Read more
Apple’s Pro Display XDR models in stock today...
Abt Electronics has Apple’s new 32″ Pro Display XDR models in stock and on sale today for up to $305 off MSRP. Shipping is free. Their prices are currently the lowest available for these new models... Read more
Apple restocks refurbished iPhone 8 for $339
Apple has restocked Apple Certified Refurbished 64GB iPhone 8 models for only $339. Apple dropped their price on this phone last month by $160, from $499 to $339. Each refurbished iPhone comes with a... Read more
New at AT&T: 50% off iPhone 11 for new cu...
AT&T is offering a 50% off the 64GB iPhone 11 for new customers who switch to AT&T and open a new line of service. Discount applied over a 30 month period The fine print: “iPhone 11 64GB for... Read more

Jobs Board

Cub Foods - *Apple* Valley - Now Hiring Par...
Cub Foods - Apple Valley - Now Hiring Part Time! United States of America, Minnesota, Apple Valley New Retail Operations Post Date 5 days ago Requisition # Read more
Senior Data Engineer - *Apple* - Theorem, L...
Job Summary Apple is seeking an experienced, detail-minded data engineeringconsultant to join our worldwide business development and strategy team. If you are Read more
Cub Foods - *Apple* Valley - Now Hiring Par...
Cub Foods - Apple Valley - Now Hiring Part Time! United States of America, Minnesota, Apple Valley New Retail Operations Post Date 4 days ago Requisition # Read more
Medical Screener - *Apple* Hill - Evenings...
Medical Screener - Apple Hill - Evenings Tracking Code D-MS-AH-E Job Description Medical Screener - Temporary We Are Hiring: WellSpan Health has a temporary Medical Read more
*Apple* Systems Administrator - Solidus Tech...
Solidus is searching for an Apple Systems Engineer. The engineer will be responsible for desktop and server infrastructure. This includes support for operating Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.