| FutureOS Caruh Tasker '-CARUH.TXT' Version 2.1.6 - 2023.10.08
===================== ------------ 1. Introduction --------------- FutureOS Caruh is a CBM based cooperative multitasking manager using FutureOS. It provides a text / semigraphical Menu-System to manage your Tasks. You can use Mice, Joysticks, Cursor keys, Copy / Return / ESC and hot keys. Caruh exists in different languages. You can choose English, French, German, Nederlands or Spanish as your language. (Ask for your language if missing!). The language can not be changed inside Caruh, but by starting the right file. The reason is to fit 'Caruh' into the lower 16 KB RAM. Tasks / Specifications / Features --------------------------------- - Caruh can manage up to 255 different tasks (files with the extension '*.X16') - Each Task has its own 16 KB block of expansion RAM for code, data and stack - A typical Task begins at RAM address &4000 and is not longer than 15,75 KB - The Priority of Task Applications can be changed (1 = high // 255 = low) - Tasks can be cooperative and preemptive. They can kill themselves if needed - Multitasking with Caruh is the fastest way to do it within the CPC/Plus range You can start '-Caruh' under FutureOS and add Tasks by loading them. 2. The following functions are implemented ------------------------------------------ Submenu <F>ile -------------- Load <T>ask Hotkey: t or T --- To load and start a Task Save Tas<k> Hotkey: k or K --- To save a Task Load <a>ll Hotkey: a or A --- Loads and starts all tagged files as Tasks <S>ave tabl Hotkey: s or S --- Saves 16 KB Task-Table (--> for debugging) <R>ead DIRs Hotkey: r or R --- Reads the DIRs of all tagged drives <C>lose Hotkey: c or C --- End all Tasks. Quit this application <I>mport Hotkey: i or I --- <E>xport Hotkey: e or E --- <V>ersion Hotkey: v or V --- Shows version number of Caruh Encr<y>pt Hotkey: y or Y --- <P>rint Hotkey: p or P --- Sen<d> Hotkey: d or D --- <Q>uit Hotkey: q or Q --- End all Tasks. Quit this application Submenu <P>rocess ----------------- C<l>ear Hotkey: l or L --- Clear task = '<E>nd Task' (see below) G<o> To Hotkey: o or L --- Go To a Task = 'Switch <t>o' (see below) C<a>ll OS Hotkey: a or A --- Call the Desktop, return with the OK icon Submenu <O>ptions ----------------- <M>ode Hotkey: m or M --- Select the screen MODE 0-3 for Tasks <C>olour Hotkey: c or C --- Select color for Pen, Paper or Border <F>ormat Hotkey: f or F --- Select Task screen format (80x25, 64x32) <P>rinter Hotkey: p or P --- <N>etwork Hotkey: n or N --- <L>anguage Hotkey: l or L --- Select your language for Tasks Submenu <T>asks --------------- <S>tart Task Hotkey: s or S --- To load and Start a Task <E>nd Task Hotkey: e or E --- To end and delete a Task <P>riority Hotkey: p or P --- Set the Priority of a Task 1-255 Switch <t>o Hotkey: t or T --- Switch a Task to Foreground Submenu <H>elp -------------- <H>elp Hotkey: h or H --- Show a help screen about Control <I>nfo Hotkey: i or I --- Shows version number of Caruh <N>ews Hotkey: n or N --- Shows version number of Caruh <M>enu Hotkey: m or M --- Shows help about this surface -$<$>$- Hotkey: $ or 4 --- Tells how to spend money to YOU .w<w>w. Hotkey: w or W --- Tells where to find you in the internet To have a look at Caruh just start the file "-Caruh" under FutureOS. Help ==== If you want to use Caruh and you need help, Please Email to: FutureSoft@gmx.de I really look forward to help you with your own multitasking applications! 3. Files -------- '-Caruh . ': This file is the multitasking manager for FutureOS called Caruh Attention: There is one file for every language! '-CARUH .TXT': Equates usually to this file ;-) 'CAR .MAX': Source code of the multitasking manager itself. This file links 'CAR-LNG1.MAX', 'CAR-LNG2.MAX', 'CAR-SUB1.MAX', 'CAR-SUB2.MAX' when you assemble 'CAR.MAX' with the MAXAM assembler or s.e. 'CAR-LNG1.MAX': File contains text (Dutch, English, French, German, Spanish) 'CAR-LNG2.MAX': File contains additional text 'CAR-SUB1.MAX': Subroutines for Caruh. Task functionality 'CAR-SUB2.MAX': Subroutines for Caruh. Task functionality 'CAR-SUM4.MAX': Subroutines for the SD card of the M4 expansion 'TASK .MAX': Source Code for example Tasks 'TASK?.X16' 'TASK2-6 .X16': Runnable very simple Tasks. They just change the border 'TEMP .MAX': Source Code for a Task to show Temperature on screen 'TEMP .X16': Runnable Task to show Temperature (needs LambdaSpeak) on screen 'TIME .MAX': Source Code for a Task to show Time and Date on screen 'TIME .X16': Runnable Task to show Time and Date (RTC needed) on screen All files with the ending '.X16' are usable Task files of 16 KB. Try them! Source Code ----------- The source code is provided! The file 'CAR.MAX' contains the main program Caruh and the files 'CAR-LNG1.MAX' & 'CAR-LNG2.MAX' contain language dependent texts. The files 'CAR-SUB1.MAX' and 'CAR-SUB2.MAX' contain additional Task functions. Eventuall the file 'CAR-SUM4.MAX' provides the ability to work with the SD card of the M4 expansion. 4. Memory-Map ------------- &0000-&1000: Application Code of the Tasker Caruh itself &1000-&2000: Texts for Caruh &3800-&3FFF: Charset for all 256 characters. Either a copy of the lower ROM or your own. Place your personal character set here if you want to. &4000-&400F: Few variables for Caruh &4010-&4FFF: Task Table for Caruh. Every Task does use 16 bytes &7800-&7FCF: Multi-Screen-Table for screen occupation by Tasks &7FF0-&7FFF: Few bytes in this area are used by Caruh &A000-&B7FF: System buffers of FutureOS. For details look into the OS manual &BE02-&BE03: Control Bytes for Caruh -> Communication between Caruh and Tasks! 5. Assembler ------------ Use the MAXAM assembler (or something compatible) to assemble the source file 'CAR.MAX'. This file automatically loads and links the two language files and the subroutine source code files. In 'CAR.MAX' you can select your language! 6. Version ---------- Actual version: 2.1.6 from 2023.10.08 7. Updates ---------- 2023.10.04: Added support for the M4 SD card 2023.08.15: Added file size calculation (in records) for mass media M4 'N'/'O' 2022.11.31: Enhanced mouse support 2021.12.22: Release Caruh version 2.0.1 8. Credits ---------- - SID ................. for the .....French language interface! - CPC Freak Belgium ... for the ......Dutch language interface! - Miguel Sky .......... for the ...Spanisch language interface! 9. Last message --------------- Keep YOUR CPCs working! Work on CPCs! Enjoy life with your CPCs and Plus :-) Bye, TFM of FutureSoft |