[#58] altair8080: software screenshots

README.md

@@ -56,6 +56,13 @@ the documentation won't be processed by GitHub pages, just the website.
 ## Tools
 
 - Logo: MetaPost
-- Screenshot editing (markup): Shutter
-- Animated gif: peek, terminalizer
+- Screenshot editing (markup): [Shutter][shutter]
+- Animated gif:
+    - [peek][peek]: for bitmap gifs
+    - [terminalizer][terminalizer]: for terminal gifs
 - Thumbnails: imagemagick
+
+
+[peek]: https://github.com/phw/peek 
+[terminalizer]: https://github.com/faressoft/terminalizer
+[shutter]: https://shutter-project.org/

_data/screenshots.yml

@@ -54,8 +54,8 @@ screenshots:
   }
   - {
     title: 'Computer-user interaction',
-    id: 'CPM22',
-    alt: 'CP/M 2.2',
+    id: 'CPM30',
+    alt: 'CP/M 3.0',
     thumbnail: '/files/images/cpm3.png',
     image: '/files/images/cpm3.png',
     html: '

_documentation/user/_doc/altair8800/software.md

@@ -139,10 +139,12 @@ Specific steps how to boot CP/M 3 in emuStudio follow:
 
 The following image shows the look right after the boot:
 
-![Operating system CP/M 3 (banked version)]({{ site.baseurl }}/assets/altair8800/cpm3.gif){:style="max-width:737px"}
+![Operating system CP/M 3 (banked version)]({{ site.baseurl }}/assets/altair8800/cpm30.gif){:style="max-width:737px"}
 
 ## Altair DOS v1.0
 
+At first, make sure 88-sio includes CPU port 0 for status channel and CPU port 1 for data channel.
+
 Steps for booting Altair DOS v1.0 follow:
 
 1. Mount `altdos.dsk` to drive `A:` in MITS 88-DCDD.

_pages/download.md

@@ -32,12 +32,15 @@ To run emuStudio, run the following command from the console:
 
 For more information, please see the [documentation]({{ site.baseurl }}/documentation/user/application/).
 
-# Disk images, ROMs, etc.
+# Software for emulated computers
 
-There exist multiple images of the original software for computers emulated on emuStudio. However, it is not possible to
-provide all of them due to potential licensing issues. Therefore, instead of providing the images with emuStudio
-installation, we rather list some links to sites that provide those.
+Software is essential for emulators as it is for computers. For emulators, software is usually preserved in disk images,
+ROM images, magnetic tapes in a digitalized form, and there are probably even more options. It then depends solely on
+the specific emulator, how it loads the software in.
+
+In emuStudio, each virtual computer has a section in documentation called "Original software". This section provide
+links to various sites with software for emulators.
 
 - [MITS Altair8800]({{ site.baseurl }}/documentation/user/altair8800/software)
-- [Brainf*ck]({{ site.baseurl }}/documentation/user/brainduck/examples)
+- [Brainduck]({{ site.baseurl }}/documentation/user/brainduck/examples)
 - [SSEM]({{ site.baseurl }}/documentation/user/ssem/software)

artwork/gif-automation/README

@@ -0,0 +1,3 @@
+Run:
+
+npm install -g terminalizer

artwork/gif-automation/automation.yml

@@ -363,19 +363,19 @@ records:
   - delay: 309
     content: "\a"
   - delay: 143
-    content: "\r\nas-8080/ as-ssem/ as-z80/  \r\n$ ./emuStudio --auto --nogui --config config/MITSAltair8800.toml --input examples/as-8080/reverse.asm"
+    content: "\r\nas-8080/ as-ssem/ as-z80/  \r\n$ ./emuStudio -cf config/MITSAltair8800.toml --input-file examples/as-8080/reverse.asm auto --no-gui"
   - delay: 938
     content: "\r\n"
   - delay: 447
-    content: "[INFO] Loading virtual computer: config/MITSAltair8800.toml\r\n"
+    content: "  [INFO] [88-SIO, device=LSI ADM-3A terminal] Device was attached\r\n"
   - delay: 217
-    content: "[INFO] [device=LSI ADM-3A Terminal] Device was attached to 88-SIO\r\n[INFO] Processing input file: 'adm3A-terminal.in'; delay of chars read (ms): 0\r\n"
+    content: "  [INFO] Starting emulation automation...\r\n"
   - delay: 11
-    content: "[INFO] Starting emulation automation...\r\n[INFO] Compiler: Intel 8080 Assembler, version 0.40-SNAPSHOT\r\n[INFO] CPU: Intel 8080 CPU, version 0.40-SNAPSHOT\r\n[INFO] Memory: Standard operating memory, version 0.40-SNAPSHOT\r\n[INFO] Memory size: 65536\r\n[INFO] Device: MITS 88-DCDD device, version 0.40-SNAPSHOT\r\n[INFO] Device: MITS 88-SIO serial board, version 0.40-SNAPSHOT\r\n[INFO] Device: LSI ADM-3A terminal, version 0.40-SNAPSHOT\r\n[INFO] Compiling input file: examples/as-8080/reverse.asm\r\n[INFO] Compiler started working.\r\n[INFO] [Info   ] Intel 8080 Assembler, version 0.40-SNAPSHOT\r\n"
+    content: "  [INFO] Emulating computer: MITS Altair8800\r\n  [INFO] Compiler: Intel 8080 Assembler, version 0.41\r\n  [INFO] CPU: Intel 8080 CPU, version 0.41\r\n  [INFO] Memory: Byte-cell based operating memory, version 0.41\r\n  [INFO] Memory size: 65536\r\n  [INFO] Device: MITS 88-DCDD, version 0.41\r\n  [INFO] Device: MITS 88-SIO, version 0.41\r\n  [INFO] Device: LSI ADM-3A terminal, version 0.41\r\n  [INFO] Compiling input file: examples/as-8080/reverse.asm\r\n  [INFO] Compiler started working.\r\n  [INFO] [INFO   ] Intel 8080 Assembler, version 0.41\r\n"
   - delay: 21
-    content: "[INFO] [Info   ] Compilation was successful.\r\n Output file: /home/vbmacher/emuStudio/examples/as-8080/reverse.hex\r\n[INFO] [Info   ] Compiled file was loaded into memory.\r\n[INFO] Compilation finished.\r\n[INFO] Program start address: 03E8h\r\n[INFO] Resetting CPU...\r\n[INFO] Running emulation...\r\n"
+    content: "  [INFO] [INFO   ] Compile was successful.\r\nOutput: /home/vbmacher/tmp/emuStudio-release/examples/as-8080/reverse.hex\r\n  Program starts at 0x03E8\r\n  [INFO] [INFO   ] Compiled file was loaded into memory.\r\n  [INFO] Compilation finished.\r\n  [INFO] Resetting CPU...\r\n  [INFO] Running emulation...\r\n"
   - delay: 110
-    content: "[INFO] Normal stop\r\n[INFO] Instruction location = 041Ch\r\n[INFO] Emulation completed\r\n"
+    content: "  [INFO] Normal stop\r\n  [INFO] Instruction location = 041Ch\r\n  [INFO] Emulation completed\r\n"
   - delay: 280
     content: '$ '
   - delay: 801