Multi Tasking OS for Apple IIe //c IIgs : Link to 0.93 RELEASE version ->
Go to file
Rémy GIBERT dc88a3dc6c 0.9 2017-08-23 12:17:33 +02:00
.Docs Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
.Floppies Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
.Fonts Kernel version 0.9 : Workspace Reorg #3 2017-06-16 15:11:41 +02:00
.Tools Kernel version 0.9 : CP,RM,MV, Code rewrite in progress....#3 2017-06-30 17:11:29 +02:00
.screen-shots Kernel version 0.9 : Updated DOCs & MEDIAs 2017-04-30 13:42:15 +02:00
BIN Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
DRV Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
ETC New syntax: DNS1/DNS2 2016-01-09 23:35:03 +01:00
INC Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
LIB Kernel version 0.9 : LS,CP,RM,MV, bug fix dst path not printed properly 2017-07-06 17:30:40 +02:00
SBIN Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
SYS Kernel version 0.9 : Change in API to conform with stdlib & stdio 2017-08-22 17:03:34 +02:00
A2osX.S.QC.txt Kernel version 0.9 : KConfig file now loaded by Kernel, no more QCODE 2017-05-03 17:40:02 +02:00
A2osX.S.txt Kernel version 0.9 : Added a "Close All Opened Files" at init2 that prevented copying some files... 2017-06-22 17:21:24 +02:00
A2osX.STARTUP.txt Kernel version 0.9 : LAN drivers, bugfix and optimization 2017-04-27 22:08:12 +02:00
README.md Kernel version 0.9 : "Message in a bottle" ....see README.md ;-) 2017-08-01 21:43:59 +02:00
X.ERRORS.S.txt Kernel version 0.9 : Lowercase support, bugfix in CP/MV/RV 2017-06-21 17:46:43 +02:00
X.PRINTF.S.txt Kernel version 0.9 : X.PRINTF.S rewritten to support bank swiching save/restore (ATLK Crash) 2017-05-02 17:56:43 +02:00
_MAKEBOOT.txt Kernel version 0.9 : saved few bytes with MemMgr Optimization 2017-07-01 15:45:53 +02:00
_MAKEDEV.txt Kernel version 0.9 : CP,RM,MV, Added -Q switch 2017-06-23 14:04:39 +02:00
_RUN.txt Kernel version 0.9 : MEDIA reorganisation 2017-03-29 17:48:15 +02:00
_config.yml Set theme jekyll-theme-hacker 2017-08-01 22:05:17 +02:00

README.md

A2osX (0.9)

Multi-Tasking OS for Apple II

!!!HELP NEEDED!!!

Thanx a lot for all positive comments i read here and there, but i definitively need contributors & testers.

Anybody wants to join this project ?

If you're interested on contributing, please send a message with your skills and in which area you are interested to work on (Network, Kernel, device drivers for additional hardware support, GUI, graphical resourses, command line tools....)

This is some sort of "last hope call", some of you were right, this project is really huge!!! Anyway, i'm convinced that a small team of developers could reach "version 1.0" with GUI & network support in few months....i'm working on it for...4 years now, spending the most of my free time fixing hardware to test this code instead of...writing it! (anybody could help me fix this -5v -12v issue on this nasty Astec AA11042c PSU! ;-)

Well, let me know if you can bring "fresh blood" to this stuff...

Requires :

Enhanced IIe (65c02 cpu) with 128k, //c, IIgs

Introduction...

A2osX is a cooperative, event-driven multitasking kernel (meaning it is applications that are responsible to give back control to kernel) Its principal goal is to collect all "genius" 65c02 pieces of code ever written here and there, concentrated in the same environment. (including IP Stack & HTTPD/TELNETD..., GUI & graphical tools...) "Complete working place", no needing any more to reboot to switch between tons of diskettes!!!

A2osX is designed to work on any "stock" 128k Apple //e, with no additional hardware. As VBL signal is NOT available as an IRQ on //e (it is on //c & IIgs) it makes preemptive multitasking impossible.

(Well, GSosX, 16 bits equivalent for IIgs, another project which is "cooking" in my mind, could do it!)

Kernel, loading in Aux LC on top of ProDOS provide API inspired from Linux/Unix World to allow writing applications & command line tools on top of it. This kernel provides an advanced "Memory Manager" able to relocate 65c02 code. "Event Manager" makes TCPIP stack able to listen on several ports, manage ARP,DNS...cache expiration and any background processes. "Task Manager" is responsible to "distribute" CPU time to several loaded processes. "Device Manager" handles event collected from builtin devices as well as devices added by loadable drivers.

If you're 65c02 or Z80 code writer, how to contribute ?

Several subprojects are now indentified :

  • Hardware Support : adding drivers to support more & more hardware (RAM cards, storage....)
  • Z80 support : Kernel could pass control to any Z80 detected on the system.
  • TCP/IP stack
  • AppleTalk Support
  • GUI & Printing
  • Archive, Disk Image transfer tools (ADT client!)...
  • Question : Pascal or C Compiler?
  • --> Answer : C compiler....Next version of Kernel API will be closer to STDLIBC, Genralize the use of C-Strings
  • ...sure there is some more!

Screenshots

General Information:

** Kernel 0.9 complete rewrite in progress **

(Kernel 0.8 has been archived) It is confined in Aux LC Bank 1 & 2 to leave enough room at $EOOO for Drivers. Network drivers, Mouse, DHGR.DRV can load and fit in Aux LC. Now it's time to make all external BINs use new API, then GUI development will resume.

  • A2OSX.BOOT.po : 140k BOOT disk image with all binaries
  • A2OSX.DEV.po : 140k disk image with ASM binaries, Debug Tools & INClude files
  • A2OSX.BUILD.po : 800k BOOT disk image with S-C MASM 2.0 and all binaries (BOOT+DEV)
  • A2OSX.SRC.po : 800k disk image with all sources

OApple+1,OApple+2,OApple+3 to switch between screens : Kernel Log, text, DHGR. (OApple+shift+1,OApple+shift+2,OApple+shift+3 on FR keyboard)

SYS/KM* Supported Hardware At Kernel Level (ProDOS):

KM.Name Status Comment
KM.NSC Working No-Slot-Clock/DS1216E
KM.RAMWORKS Working AE-Ramworks I,II,III
KM.VSDRIVE Working ADTPro Virtual Drive for SSC
KM.APPLETALK Working AppleTalk Support for ProDOS

SBIN,Daemons/Commands:

Name Status Comment K.Ver
INSDRV Working 0.9
GETTY Working 0.9
LOGIN In Progress no auth using /etc/passd yet 0.9
SHELL Working (See Internal Shell commands) 0.9
KCONFIG Working Kernel Configuration Utility 0.9
---- ------ ------- -----
TCPIP Working Socket API.ARP,IP,ICMP,UDP & TCP ok 0.9
DHCPCLNT Working rewritten to use new Socket API 0.9
TELNETD In Progress 0.9
HTTPD In Progress 0.9

Internal Shell commands:

Name Status Comment
CD Working Improved syntax : now, 'CD ../BIN' works
PWD Working
DATE Working
ECHO Working \b,\e,\f,\n,\\ and \% supported
EXIT Working
PAUSE Working
READ Working -S : no echo (password)
-P : "prompt message"
TIME Working
SET Working
STARTPROC Working Used in A2osX.startup

Shell variables:

Name Status Comment
$PWD Working 'Working Directory'
$0 Working Command Full Path
$1-$9 Working Arg[n]
$* Working All Args
$# Working Arg Count
$? Working Return Code
$@ Working Parent PID
Working PID
$! Working Child PID

note : '$VAR' does NOT expand Variable

DRV,Drivers:

Name Status Comment K.Ver
Console.DRV Working ANSI support in Progress. 0.9
SSC.DRV Working Apple "Super Serial Card" Driver 0.9
SSC.I.DRV Working Apple "Super Serial Card" Driver (IRQ enabled) 0.9
PIC.DRV In Progress Apple "Parallel Interface Card" Driver, renamed from PPIC.DRV 0.9
Mouse.DRV Working Apple Mouse Card,//c Mouse Port 0.9
DHGR.DRV In Progress except bitblt... 0.9
---- ------ ------- -----
LanCeGS.DRV Working 0.9
Uthernet.DRV Working 0.9
Uthernet2.DRV Working 0.9
Uther2.AI.DRV In Progress With ARP/IP Offloading 0.9

BIN,External Shell commands:

Name Status Comment K.Ver
MEM Working Old dump behavior is now MEMDUMP. New MEM command displays MEMSTAT (Main, Aux & Kernel Memory) 0.9
LSDEV Working 0.9
PS Working 0.9
MD Working 0.9
LS Working -A : Do Not Print . & .. 0.9
-L : long listing with size/date...
-R : Recurse subdirectories
RM Working -C : Continue On Error 0.9
-Q : Quiet
-R : Recurse subdirectories
CP Working -C : Continue On Error 0.9
-Q : Quiet
-R : Recurse subdirectories
-Y : Dont't Prompt For Override
MV Working -C : Continue On Error 0.9
-Q : Quiet
-R : Recurse subdirectories
-Y : Dont't Prompt For Override
CAT Working -A : Show All non printable caracters 0.9
-N : Number all output lines
-S : Suppress repeated empty output lines
CHTYP In Progress -C : Continue On Error 0.9
-R : Recurse subdirectories
CHMOD In Progress -C : Continue On Error 0.9
-R : Recurse subdirectories
CHOWN In Progress -C : Continue On Error 0.9
-R : Recurse subdirectories
CHGRP In Progress -C : Continue On Error 0.9
-R : Recurse subdirectories
FORMAT In Progress -L : Low-Level Format 0.9
EDIT Working still missing : find/replace 0.9
NSCUTIL Working Tool for setting time in NSC/DL1216E 0.9
---- ------ ------- -----
ARP Working dump ARP cache, setup a static ARP entry 0.9
PING Working 0.9
DNSINFO Working dump DNS cache, setup a static DNS entry 0.9
IPCONFIG Working renamed from NETINFO 0.9
NETSTAT Working 0.9

BIN,External DEV Shell commands:

Name Status Comment K.Ver
ASM In Progress S-C MASM based multi CPU assembler 0.9
DEVDUMP 0.8
MEMDUMP Working 0.9
RPCDUMP Working tool based on UDP socket API, renamed from RPCINFO 0.9

Misc

S-C MASM color scheme for Notepad++

...drop _Tools/userDefineLang.xml in %APPDATA%\Notepad++ ;-)