MacWorks Plus Technical Overview By Chuck Lukaszewski

MACWORKS PLUS TECHNICAL OVERVIEW Charles T. Lukaszewski Sun Remarketing, Inc. Logan, Utah MacWorks Plus Technical Overview Sun Remarketing, Inc. Page 1 o ON OO oO FF WO DN = CONTENTS Introduction Organization of MacWorks Plus Source Code MacWorks Plus Software Implementation The MacWorks Plus Installation Program List of Known Incompatibilities Issues in Transporting the Macintosh ROM Software Problem Report Summary Software Problem Reports With Corrective Measures Pending Software Problem Reports MacWorks Plus Technical Overview Sun Remarketing, Inc. Page 2 INTRODUCTION MacWorks Plus is the implementation of the Macintosh Plus 128K ROM for the Apple Macintosh-XL and Lisa-2 computers. MacWorks Plus was developed by a programming team at Sun Remarketing lead by Charles Lukaszewski. The project's design goal is one-hundred percent compatibility with software that operates on the Macintosh Plus. MacWorks Plus is based on reverse-engineered 128K Macintosh ROM code, reverse-engineered device drivers from the original MacWorks program, and modified versions of current System Software resources. The chief difference between MacWorks Plus and its predecessor is a brand-new hardware interface whose low-level interface to the 128K ROM operating system is identical to that in the Macintosh Plus. All in all, there are about 50 source files which contain some 23,000 lines of source code. The project is managed with the aid of the Macintosh Programmers Workshop (MPW) version 2.0.2. The code can be easily extended to accommodate future enhancements, should they be desiredt, including SCSI support, extended sound compatibility, and addition of 256K ROM (Macintosh SE and Macintosh Il) routines. This document is intended to provide an introduction to the MacWorks Plus code for both the programmer and the layman. The programmer should consult this document prior to making any modifications to the source code. MacWorks Plus Technical Overview Sun Remarketing, Inc. Page 3 ORGANIZATION OF MACWORKS PLUS SOURCE CODE MacWorks Plus is generated from 50 source files which can be broadly classified into five categories: ROM image files, hardware kernel files, installer files, user tools and generation utilities. The process of creating executable MacWorks Plus programs has been completely automated through the use of the Macintosh Programmers Workshop ‘make’ utility. Location of Source Files In order to compile the project with MPW, all of the source files must be located in a folder called 'MacWorks+' that resides in the MPW folder (defined by the MPW shell variable {MPW}). The ‘MacWorks+’ folder contains the following items: =) MacWorks+ BE a cy Makefile installer kernel rom_image _ pp_driver >. edev utilities includes rez doc GTE obj Ist bin — Wa KI ec The ‘Makefile’ is the master control file for MPW. Performing a ‘make all’ at this di- rectory level will build all segments of MacWorks Plus. The folders contain source code or compiler outpu…