diff --git a/README.md b/README.md index 07a0fcd3..2e662219 100644 --- a/README.md +++ b/README.md @@ -10,29 +10,31 @@ Its principal goal is to collect all "genius" 65c02 pieces of code ever written (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 hardware modification. As VBL signal is NOT available as an IRQ on //e (it is on //c & IIgs) -it makes preemptive multitasking impossible. +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. -+ TCPIP stack : TCP still missing! -+ AppleTalk Support -+ GUI & Printing -+ Archive, Disk Image transfer tools (ADT client!)... -+ Question : Pascal or C Compiler? -+ ...sure there is some more! +"Device Manager" handles event collected from builtin devices as well as devices added by loadable drivers. -## Screen shots +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. ++ TCPIP stack : TCP still missing! ++ AppleTalk Support ++ GUI & Printing ++ Archive, Disk Image transfer tools (ADT client!)... ++ Question : Pascal or C Compiler? ++ ...sure there is some more! + +## Screenshots ![](./.screen-shots/ScreenShot.LS.png) @@ -48,86 +50,91 @@ Several subprojects are now indentified : ** 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 S-C MASM boot disk image with all sources -**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) +(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 S-C MASM boot disk image with all sources +**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.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 | -| TCPIP | In Progress | New Socket API. ARP,IP,ICMP,UDP ok, TCP in progress | 0.9 | -| DHCPCLNT | Working | rewritten to use new Socket API | 0.9 | + +## 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 | +| TCPIP | In Progress | New Socket API. ARP,IP,ICMP,UDP ok, TCP in progress | 0.9 | +| DHCPCLNT| Working | rewritten to use new Socket API | 0.9 | | TELNETD | | | | -| HTTPD | | | | - -## 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 | | -| IF | | | -| PAUSE | Working | | -| READ | Working | -S : no echo (password) | -| | | -P : "prompt message" | -| TIME | Working | | -| SET | Working | | +| HTTPD | | | | + +## 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 | | +| IF | | | +| 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 | + +## 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 | +| $* | Working | All Args | +| $# | Working | Arg Count | +| $? | Working | Return Code | +| $@ | Working | Parent PID | +| $$ | Working | PID | +| $! | Working | Child PID | -note : '$VAR' does NOT expand Variable +note : '$VAR' does NOT expand Variable + +## DRV,Drivers: -## 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 | +| 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.8 | | Mouse.DRV | Working | Apple Mouse Card,//c Mouse Port | 0.9 | | DHGR.DRV | In Progress | except bitblt... | 0.8 | | ---- | ------ | ------- | ----- | -| Uthernet.DRV | Working | | 0.9 | +| Uthernet.DRV | Working | | 0.9 | | Uthernet2.DRV | Working | | 0.9 | -| Uther2.AI.DRV | In Progress | With ARP/IP Offloading | 0.8 | +| Uther2.AI.DRV | In Progress | With ARP/IP Offloading | 0.8 | | LanCeGS.DRV | Working | | 0.8 | - -## BIN,External Shell commands: + +## 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 | @@ -157,17 +164,18 @@ note : '$VAR' does NOT expand Variable | 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: + +## BIN,External DEV Shell commands: | Name | Status | Comment | K.Ver | | ---- | ------ | ------- | ----- | | ASM | In Progress | S-C MASM based multi CPU assembler | | | 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++ + +## Misc + +### S-C MASM color scheme for Notepad++ +...drop _Tools/userDefineLang.xml in %APPDATA%\Notepad++ ;-)