OC-MultICE/README.md

69 lines
2.4 KiB
Markdown
Raw Normal View History

2017-04-19 03:54:24 +10:00
# MultICE
2017-04-19 03:53:21 +10:00
## The MultIplexed Computing Environment for OpenComputers
2017-04-19 23:31:21 +10:00
A simple, unprotected, cooperative multitasking operating system.
### Building
MultICE uses a relatively simple build system. It has been tested on Arch Linux, Debian Linux, OpenOS and Plan9k.
#### 1. Choose modules.
The system is made out of modules from the `modules/` directory. When you run the build script, it assembles them, and optionally optomises the code for space.
Modules are specified in the `modules.cfg` file and are relative to the `modules/` folder.
An example for interactive usage with networking:
```
base/header.lua
drivers/dterm.lua
library/print.lua
drivers/keyboard.lua
library/net.lua
applications/luash.lua
base/footer.lua
```
#### 2. Configure build system
The build system has a configuration file `build.cfg`.
##### `optomise`
Can either be yes or no.
2017-04-19 23:59:51 +10:00
Specifies whether to run the simple optimisation function on the kernel.
2017-04-19 23:31:21 +10:00
##### `test`
Can either be yes or no.
Specifies whether to test the final kernel (using load). Only picks up syntax errors.
##### `log`
Can either be yes or no.
Specifies whether to output log files.
##### `opath`
Specifies where to put the output kernel.
#### 3. Build.
Simply run `build.lua`. Under OpenOS or plan9k that may just be going to the right dir and entering `build`, but under proper UNIX systems it may involve `lua build.lua`.
2017-04-19 03:53:21 +10:00
### Base OS API
2017-04-19 23:58:12 +10:00
#### `s(name,function,environment)`
2017-04-19 03:53:21 +10:00
Spawns a process from `function` under the name `name`, with the environment table specified in `environment`. Environment doesn't really have much use right now.
2017-04-19 22:52:17 +10:00
#### `l() `
2017-04-20 00:02:12 +10:00
Returns the last event.
2017-04-19 03:53:21 +10:00
2017-04-19 22:52:17 +10:00
#### `h(...)`
2017-04-19 03:53:21 +10:00
Pushes an event to the queue, with whatever data you specify. Generally used for IPC.
### Module APIs
#### library/print.lua
2017-04-19 23:59:51 +10:00
These functions should be display device independent.
2017-04-19 22:52:17 +10:00
##### `print(...)`
Displays its arguments on the display device as a string, with a newline.
2017-04-19 22:52:17 +10:00
##### `write(...)`
Displays its arguments on the display device as a string, without a newline
#### drivers/keyboard.lua
This is a device-specific driver.
2017-04-19 22:52:17 +10:00
##### `readln()`
Reads a line of input from the keyboard.
#### library/net.lua
Note: Settings have to be set in the kernel module, at the line
```
tM,nP,nID = {}, 4096, 1
```
Where 4096 is the port and 1 is the device ID. Device ID can be any data type, port must be a number.
Network messages can be read from `_G.ev`, they have the type `net_msg`
2017-04-19 22:52:17 +10:00
##### `ns(id,po,msg)`
Sends network message `msg` to device `id` on port `po`