mirror of https://github.com/A2osX/A2osX.git
Updated Documenation
This commit is contained in:
Patrick Kloepfer
parent
bc2cb392f5
commit
aa749150b8
|
|
@ -134,6 +134,27 @@ Kernel 0.9.1 stable enough to resume building.
|
|||
+ ...
|
||||
+ to allow...Preemptive!
|
||||
|
||||
__A new attempt using Mouse card VBL IRQ is targeted in 0.9.1.__
|
||||
|
||||
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!
|
||||
|
||||
**"System Tick" sources for preemptive mode :**
|
||||
|
||||
|
|
|
|||
|
|
@ -130,11 +130,8 @@ To Telnet to A2osX running TELNETD.
|
|||
|
||||
Use Notepad++ which you can download from....
|
||||
|
||||
|
||||
__S-C MASM color scheme for Notepad++__
|
||||
#### S-C MASM color scheme for Notepad++
|
||||
...drop _Tools/userDefineLang.xml in %APPDATA%\Notepad++
|
||||
;-)
|
||||
|
||||
|
||||
|
||||
THere is a userDefinedLang.xlm file in the .Tools dir that you will want to copy to Notepad... then when editing ASM files (.S) you can change your language to S-C MASM 65C02 and notepad++ will do the proper highlighting.
|
||||
|
|
|
|||
|
|
@ -13,6 +13,11 @@ I agree with edward, that the constraint tends to be memory and not processor (w
|
|||
|
||||
ASM is needed because at end of day its the most strict mem mgmt (the language that allows you to be stringy on mem use) so of course the core of A2osX is in ASM. however after we make out own ASM that makes the OS self making (we talked about this) we plan a CSH which is first step to Interactive C and then a BIn that will make C feed to ASM (the point of 23) so we will get there, but hey stupid, the CORE has to be ASM to be tight with mem
|
||||
|
||||
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)
|
||||
|
||||
|
||||
|
||||
|
||||
# Notes for Developers
|
||||
|
||||
|
|
|
|||
69
README.md
69
README.md
|
|
@ -1,5 +1,9 @@
|
|||
# A2osX (0.93) Multi-Tasking OS for Apple II
|
||||
|
||||
|
||||
|
||||
If you would like to see more screenshots of A2osX click **[here](.Docs/Screen%20Shots.md)**.
|
||||
|
||||
## Introduction...
|
||||
|
||||
A2osX is an operating, programming and execution environment for the 128K Enhanced Apple //e and Apple //gs series of computers. While layered atop of ProDOS, taking advantage of all ProDOS block devices and MLI calls; A2osX is much more than an application or command shell. Written in 65C02 assembly for speed of execution and efficient memory management; A2osX is a multitasking and yes multiuser development environment bringing many of today's server operating system features to our venerable vintage 8-bit systems.
|
||||
|
|
@ -8,11 +12,11 @@ The foundation of A2osX enabling its multiuser multitasking capabilities is a re
|
|||
|
||||
A2osX is designed to work on any "stock" 128k Apple //e, with no additional hardware with a 65C02 or newer processor.
|
||||
|
||||
See the **[documentation](#documentation)** section below to find the other resources available for learning how to install, use, develop and test A2osX.
|
||||
See the **[documentation](#documentation)** section below to find other resources available to you for learning how to install, use, develop and test A2osX.
|
||||
|
||||
## Latest News 2019-02-19
|
||||
|
||||
Major updates have occured to the kernel and many of the APIs to support an enhanced shell with support of many new scripting capabilities, the ability to redirect and eventually piping output. Current kernel also supports multiple virtual terminals as well as TCP (via TELNETD) and serial (SSC driver) terminals.
|
||||
Major updates have occurred to the kernel and many of the A2osX API's to support a greatly enhanced shell that boasts significant new scripting capabilities since 0.92. Also added is the the ability to redirect input and output, including errors, and the ability to pipe (|) the output of one command or operation to another (i.e. **ls \* | more** ). A2osX now provides for multiple virtual terminals as well as users/terminals via TCP (through TELNETD) and serial devices (through a SSC driver).
|
||||
|
||||
If you would like to read all the past news articles for A2osX, you can read the news article found **[here](.Docs/News.md)**.
|
||||
|
||||
|
|
@ -22,59 +26,36 @@ This is just a place holder and plug for our A2osx internet site. Stay tuned he
|
|||
|
||||
## Disk images :
|
||||
|
||||
|
||||
You can use and/or install A2osX from the media found in our Media directory found **[here](.Floppies)**. The current set of available media includes:
|
||||
|
||||
+ **A2OSX.BOOT.po** : **(0.92)** 140k BOOT disk image with all binaries
|
||||
+ **A2OSX.DEV.po** : **(0.92)** 140k disk image with ASM binaries, Debug Tools & INClude files
|
||||
+ **A2OSX.BUILD.po** : **(0.92)** 800k BOOT disk image with S-C MASM 3.0 and all binaries (BOOT+DEV)
|
||||
+ **A2OSX.SRC.po** : **(0.92)** 800k disk image with all sources
|
||||
| Image Name | Description !
|
||||
| --- | --- |
|
||||
| **A2OSX.BUILD.po** | 32MB disk image with S-C MASM 3.0, all binaries and all source for A2osX <br> This is primary development media for A2osX, especially pre-launch of Release, Stable and official Build Media. See below.|
|
||||
| A2OSX.MAKE.po | 32MB disk image with S-C MASM 3.0, all binaries and all source for multiple BUILD versions of A2osX stored in directories on MAKE. The image also includes the TEST, ADMIN, and EXAMPLE scripts being created to support A2osX. |
|
||||
| A2OSX.B800.po | An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| A2OSX.BOOT.po | An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| A2OSX.DEV.po | A 140K ProDOS disk image containing source code for A2osX. Use is being discontinued. |
|
||||
| BLANK32MB.po | A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
| BLANK800.po | A formatted empty ProDOS 3.5" 800K disk image, suitable for use with emulators such as AppleWin |
|
||||
| BLANK140.dsk | A formatted empty ProDOS 5.25" 140K disk image, suitable for use with emulators such as AppleWin |
|
||||
|
||||
|
||||
Please note, we plan to change the media set once 0.93 is officially released. Currently, the BUILD media is the primary image used by the developers to hold the most current version of the A2osX binaries (and a copy of the source, although of course GitHub is the primary source repository). You can download the BUILD image and run in your favorite Apple II emulator or copy to CFFA, MicroTurbo or other Hard Disk emulator to boot, run, test and develop programs for A2osX. Once 0.93 is released, we plan to update the media to include RELEASE, STABLE and BUILD editions of the media, like other projects you might find on GitHub; and each of these will include BOOT, INSTALL, SOURCE and EXTRA type media so that users and developers can BOOT or INSTALL A2osX to existing systems as they see fit.
|
||||
|
||||
## Requires :
|
||||
Enhanced IIe (65c02 cpu) with 128k, //c, IIgs
|
||||
|
||||
## Documentation
|
||||
|
||||
Much work being done to expand and enhance the documentation for A2osX. Some of this documentations are still in the rough draft stage but are being provided to bring you as much information about A2osX as soon as possible. We happily welcome any help and contributions from others to this or any area of the A2osX project.
|
||||
Much work is being done to expand and enhance the documentation for A2osX. Some of this documentation is still in the rough draft stage, but is provided to bring you as much information about A2osX as quickly as possible. We happily welcome any help and contributions from others to this or any area of the A2osX project.
|
||||
|
||||
The repository all A2osX documentation can be found **[here](.Docs)**. This directory includes the system generated specifications for all the A2osX APIs as well as all our other documentation.
|
||||
|
||||
### User Guide
|
||||
|
||||
A draft of the first A2osX User Guide can be found on GitHub **[here](.Docs/User%20Guide.md)**.
|
||||
|
||||
### Notes for Developers
|
||||
|
||||
__A new attempt using Mouse card VBL IRQ is targeted in 0.9.1.__
|
||||
|
||||
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!
|
||||
|
||||
## General Information:
|
||||
|
||||
Kernel API 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.
|
||||
|
||||
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)
|
||||
|
||||
## Misc
|
||||
|
||||
### S-C MASM color scheme for Notepad++
|
||||
...drop _Tools/userDefineLang.xml in %APPDATA%\Notepad++
|
||||
;-)
|
||||
A draft of the first A2osX Notes for Developers can be found on GitHub **[here](.Docs/Notes%20for%20Developers.md)**.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue