Inside NitrOS-9

Back in 1987, Frank Hogg Laboratory, Inc. published a book by Kevin K. Darling entitled "Inside OS9 Level II - The inside story of OS9 for the Tandy Color Computer 3". A PDF scan of the whole book is available from various places online, including: InsideOS9.pdf

This set of pages is an attempt, starting from an OCR'd copy of the original book, to revise that material so that it is applicable to NitrOS-9 and to both Level 1 and Level 2 systems.

1. INSIDE OS9 LEVEL2

THE INSIDE STORY OF OS9 FOR THE TANDY COLOR COMPUTER 3

by Kevin K. Darling

PUBLISHED BY Frank Hogg Laboratory, Inc. 77O James Street Syracuse, New York 13203

Copyright (C) 1987 by Kevin K. Darling

All rights reserved. No part of the contents of this book may be reproduced or transmitted in any form or by any means without the written permission of the publisher.

Printed and bound in the United States of America

Distributed by Frank Hogg Laboratory, Inc.

Disclaimer

The opinions in this book are strictly those of the author and do not necessarily represent the views of Frank Hogg laboratory, inc. The authors have exercised due care in the preparation of this book and the programs contained in it. Neither the author or the publisher make any warranties either express or implied with regardt o the information and programs contained in this book. In no event shall the authors or publisher be liable for incidental or consequential damages arising out of the furnishing, performance, or use of any information and/or programs.

TRS-80 Color Computer is a trademark of the Tandy Corporation. OS-9 and BASIC09 are trademarks of Microware and Motorola.

First edition published in April 1987

Table of Contents

1. Inside - INTRODUCTION
   1. Section 1-1 Forward and General Info
   2. Section 1-2 Basics of OS9
   3. Section 1-3 The GIME MMU
   4. Section 1-4 DAT Images
   5. Section 1-5 Level Two
2. Inside - THE SYSTEM
   1. Section 2-1 Direct Page variables and System memory map.
   2. Section 2-2 System calls (FScalls)
   3. Section 2-3 System calls (IScalls)
   4. Section 2-4 interrupts
3. Inside - DEVICES
   1. Section 3-1 RBF Random Block File Manager
   2. Section 3-2 RBF Calls
   3. Section 3-3 SCF Sequential File Manager
   4. Section 3-4 Pipe manager
   5. Section 3-5 General information
4. Inside - WINDOWS
   1. Section 4-1 Window Basics
   2. Section 4-2 Global and CC3IO Memory
   3. Section 4-3 Fonts and things
   4. Section 4-4 Window Descriptor
5. Inside - MISCELLANEOUS
   1. Section 5-1 The Shell
   2. Section 5-2 Using Rogue to make OS9 Level 2
   3. Section 5-3 Bug Fixes
   4. Section 5-4 Graficom Font Conversion
   5. Section 5-5 User Tips
6. Inside - SOURCES
   1. Section 6-1 Alarm Utility
   2. Section 6-2 DMem Utility
   3. Section 6-3 MMAP Utility
   4. Section 6-4 PMap Utility
   5. Section 6-5 Proc Utility
   6. Section 6-6 SMap Utility
7. Inside - REFERENCE
   1. Section 7-1 GIME Register Map
   2. Section 7-2 Tables and other Stuff
   3. Section 7-3 Video Display Codes
   4. Section 7-4 Keyboard codes
   5. Section 7-5 Error Codes