IndivisionECSv4 Software package

Download

Media:IndivisionECSv4-1.0.lha (05-Nov-2024)
Media:IndiECSv4Rescue.adf.lha bootable rescue disk (05-Nov-2024)
Media:Ecsv4-20241122.lha Latest firmware file (22-Nov-2024), fixes some scanline issue and filter

HighGFX: Amiga screenmodes up to 1280x1024 by André Pfeiffer; Download: Media:HighGFX.lha

Installation notes

Please read the documentation. A German translation is included in the archive. See requirements below.

IndivisionECSv4 Settings

1. Overview

With this tool you can configure your IndivisionECSv4's mapping of Amiga to VGA screen modes, and for each mode adjust screen dimensions, positions and various options.

2. Requirements

OCS or ECS Amiga, IndivisionECSv4, MC68000 CPU, Kickstart 2.04 (v37), asl.library v38 (Workbench 2.1) for screenmode requesters Command line flash and config tool requirements: Kickstart 1.3 (v34)

No installation required. Drag the IndivisionECSv4 icon to SYS:Prefs/ or whereever you like.

3. Security measures, prerequisites

A note about very old VGA monitors: Monitors without digital logic and microcontroller (the generation before there were onscreen displays), are in danger of being damaged if you play with the VGA settings. First consult your monitor's handbook and do not overstep the monitor's limits in horizontal and vertical frequency.

First of all we recommend to visit the 'Firmware' menu and to create a rescue disk.

Please make sure that you can boot this rescue disk without your monitor showing a picture, by just inserting it into a disk drive.

This disk will automatically flash the IndivisionECSv4 firmware and erase the configuration from the device, so the IndivisionECSv4 will come back with its hardcoded defaults and a picture.

This will come in handy in case you produced a configuration that gives no picture (a "black screen") on your VGA monitor. The current configuration will be saved onto the disk as well, so you can import it later and redo the configuration from there. There's little risk of losing a configuration, because when you have "gone blind", the configuration tool will have saved the configuration to ENVARC: as well.

4. Basic concepts

Always remember: The list of Indivision modes is evaluated from top to bottom. The first mode that matches the criteria will be used for selecting the corresponding Indivision mode. The Indivision mode in turn will have a VGA mode assigned to it.

The IndivisionECSv4 bases the Amiga screen mode detection on a possible range of raster lines and on optional selection criteria, which can pick a horizontal resolution (or the special A2024 screenmode.)

The number of lines detected on the screen will be the main argument for switching modes automatically. Usually both the interlaced and non-interlaced variants of an Amiga mode are combined into one Indivision mode.

The 'Select' argument is needed most of the time to distinguish between 'Normal' (LoRes and HiRes) and the SuperHires variants of the same mode. See PAL SuperHires for example, which has the same line number range as regular PAL screens, but is distinguished using the 'Select on SHires' criterion.

That's it basically - everything else is the adjustments of position and sclaing, VGA mode selection and a few options. If you feel uncomfortable tinkering with VGA modes - you don't have to! You are not missing out that much, and you are in greater risk of locking yourself out by producing a mode that your monitor refuses to display. The interesting settings are typically in the configuration program's main window.

5. Main window

When starting the program, you will be presented a list of Indivision modes.

First let's talk about the 'Cancel' button, which has the Escape key as its shortcut. 'Cancel' doesn't ask for confirmation - by pressing 'Cancel' or the Escape key you will lose the configuration in the current window - if it hasn't been saved before. On the other hand, this will restore the Indivision's live settings to their previous state - so you can get the display back when you have produced a configuration that distorts or doesn't give a picture at all. This is an important safety measure - so in that case, keep calm, press Escape, and carry on. The 'Cancel' button and Escape key work on all windows in the same fashion: No questions asked, configuration reverted.

The 'Save' button: The IndivisionECSv4 can switch modes automatically only when the configuration is saved to the device. The configuration will never be saved to the device unless you click 'Save'. When you find the 'Save' button available (not greyed out), then your current configuration is not saved on the device. Press 'Save' and the button becomes unavailable again until you change something. When saving, the configuration is saved not only to the device, but also in ENVARC: and ENV: on your Amiga.

Nothing really bad can happen by clicking 'Use'. The 'Use' button will not change the configuration on the device, just keep the current live state, save the configuration to ENV: (in RAM, not on disk), and exit the program. In other words, the live state will be gone with the next screen mode change, likely with a reset, and certainly with a power-up.

To find out which Indivision mode would be applied and used on clicking 'Save' or 'Use', select 'Find Mode to be Applied' from the Settings menu. This refers to the Amiga mode the configuration tool is running on, i.e. normally the Workbench. You can also apply this mode manually by clicking 'Apply', if it is not already activated. To find out which Indivision mode is currently active, select from the Settings menu 'Find Live Mode'.

Important note:

Naturally, you can also edit Indivision modes (and VGA modes) that are not currently being displayed on the Workbench (or elsewhere.) On clicking 'Test/Adjust' a test screen is opened with an Amiga mode that is assigned to the Indivision mode for testing. On clicking 'Okay' your changes will be accepted, but that doesn't mean that they will be applied when returning from the test screen to the main window. They will be applied only when clicking 'Apply' or 'Save & Apply', and only on the appropriate Amiga mode.

5.1 Indivision mode list

The first mode that matches the criteria (when searched from top to bottom) will be used. You can arrange the list by sorting entries up and down. You cannot remove default modes from the list, but individual modes in the list can be deactivated (and activated again) with a double-click, or by clicking the 'Disabled' checkmark. Not every detail can be configured in a default mode; so if you find greyed-out elements that you wish to change, then create your own copy of a mode by clicking 'Copy'. In that case, please edit the name in the text field below the list.

The 'VGA Mode' field shows the VGA mode that is currently assigned to this Indivision mode. To change it, press the arrow button to its right, and proceed with 6. VGA mode selection and editing.

The 'Amiga Mode' field shows the Amiga screen mode that is currently assigned to this Indivision mode. It will be used for testing, that is, when you click the 'Test/Adjust' button. You can change the test mode by clicking the arrow button, if you want to test an Indivision mode on both interlaced and non-interlaced variants of the same mode.

Very important note:

The 'Amiga Mode' must correspond to the Indivision mode and its name, or the testing the Indivision mode will be entirely confusing! If unsure, do not change the 'Amiga Mode'. You will need the 'Amiga Mode' only if you create a new mode, or if you want to change between non-interlaced and interlaced variants (of the same mode!) for testing.

5.2. Selection criteria

It is rarely needed to adjust the selection criteria yourself, because most Amiga modes are already in the default Indivision mode list. So even if you want to create a variant with other adjustments or a different VGA mode, making an appropriate "Copy of" an Indivision mode is normally enough - in that case you can safely advance to the next section, 5.3 Test/Adjust.

However, if you have installed a monitor file not listed in the defaults, or even programmed a new monitor file yourself (you never know), or just want to learn how it works, read on.

The buttons to the left of the main list are related to the currently selected Indivision mode. The fields 'Select', 'Min. Lines' and 'Max. Lines' will be enabled only if you are in a custom mode created by making a copy of a default mode.

The 'Select' cycle allows to accept a mode 'Always' (with the exception of A2024), only 'on Normal' (i.e. on LoRes and HiRes), specifically 'on SHires' (Super Hires), or on the special mode 'A2024'. For 'Min. Lines' and 'Max. Lines' please enter a range of number of rasterlines for which this mode should apply. Once again, please remember that the list of modes will be evaluated from the top to bottom, and the first matching mode will be selected.

If you are editing an entirely new mode (advanced topic):

Also pick the appropriate 'Amiga Mode' using a screen mode requester, by clicking the arrow on the right of the field showing the mode name. This is the Amiga mode which will be opened for testing and adjustments - as well as to determine the number of raster lines on this particular Amiga mode for automatic recognition. Acquire this number by clicking 'Test/Adjust' to open a screen of the assigned Amiga mode. Enter this number in the 'Max. Lines' field. As a rule of thumb, also enter this number -1 (minus one) in the 'Min. Lines' field, to also catch short frames in the interlaced variant of the same mode.

5.3. Test/Adjust

By clicking 'Test/Adjust' on the main window, a test screen and window on that screen will be opened.

'Left', 'Top', 'Width' and 'Height' are the starting position and scan range in the Amiga picture signal. With this, you can determine precisely how much of the overscan area you wish to show up in the VGA output. 'Resolution' is used to distinguish between 'Normal' (LoRes and Hires) and 'SHires' (SuperHires) pixel resolution. 'Double Scan' is used to halve the vertical resolution. Note: It is not needed for you to distinguish between interlaced and non-interlaced variants of the same mode - the IndivisionECSv4 does this automatically. The 'Double Scan' setting will have to be disabled only for certain ECS modes.

Some settings come with a certain danger of maladjustment, especially on clicking the 'Resolution' and 'Double Scan' buttons. In that case, keep calm, press their respective keyboard shortcuts 'r' and 'd', and as a last resort, there's the Escape key.

Use the 'HFilter' and 'VFilter' sliders for real-time adjustment of scaling interpolation. Naturally this applies only to screens that are actually being scaled.

The 'Scanl.' slider allows you to reduce the intensity of every second scan line, so as to emulate the appearance of a CRT monitor. This only works on modes that have 'Double Scan' enabled, and on the interlaced variant of an Amiga mode the 'Double Scan' setting is being ignored.

Using the 'OSDSize', 'OSDPos' and 'OSDSec' elements you can adjust the onscreen display's size, position, and for how long it is getting displayed on a mode change, respectively.

On the adjustment screen, you have the following keyboard shortcuts:

Escape: Exit
Cursor left and right: Change left starting position in each line
Cursor up and down: Change top line starting position
Shift+Cursor left and right: Change width
Shift+Cursor up and down: Change height

On clicking into the adjustment window and holding the left mouse button, you can pan the visible area with the mouse. On clicking and holding the right mouse button, you can zoom the visible area with the mouse.

5.4 Advanced

The 'Advanced Options' window is separated into two sections, mode settings that apply to the mode currently being shown in the main window, and global settings that apply universally.

Advanced Mode Settings:

'Doublebuffer': When doublebuffer mode is active the frame-buffer is split into two. The graphics from the Amiga is written in one half of the framebuffer, while the VGA displays its frame from the other half. This can reduce or even eliminate tearing artifacts when VSync is not available for the selected Indivision mode. When the VGA is VSync'ed on twice the Amiga framerate (100Hz) enabling this option can remove tearing effect in the middle of the screen. Enabling this option however will introduce extra latency. And can cause jitter in the frame display frequency for modes without VSync enabled.

'Powersave': When a screen is detected to stay black for 30 seconds, the monitor is put into power save mode.

'VSync Line': This setting selects the Amiga scanline that triggers the VGA logic to start a new frame when VSync is enabled. The value should be as low as possible to have the minimum amount of latency between the Amiga and the VGA. If tearing effects are visisble at the top of the screen, this value can be increased in small steps until it is no longer visible. When VSync is not active on the VGA mode, this setting has no effect.

'Graffiti Emulation': Enables Graffiti emulation.

Global Settings:

'ECS Mode': This is a global switch, so it will show the same state in all Indivision modes. Please note that an ECS Agnus chip is required for it to be available. On changing this setting, a reboot is required for the change to take effect, as it will switch the emulated Denise from OCS to ECS mode, and vice versa. ECS mode must be enabled to get hardware support for enhanced screen modes like Productivity, SuperHires, Euro72 etc. But that is not enough - a monitor driver for the respective mode must be present in SYS:Devs/Monitors as well. Only then you can select these modes in screen mode requesters.

'RTG Switch': When this option is enabled, you can use the utility 'Indiswitcher' (see below) to suspend the monitor signal when a Picasso96 RTG screen is in front.

5.5 Re-Read Monitor Display Data

Using the menu item 'Re-Read Monitor Display Data' from the 'Settings' menu, you can re-read the monitor's extended display information database (EDID). The additional modes will show up in the VGA mode list (see also section 6., VGA mode selection and editing). The EDID modes will be read automatically, you need this function only if you changed the monitor while the program is running.

5.6 Pick VGA Mode from Display Data

To pick a VGA mode automatically from the monitor's display database, select 'Pick VGA Mode from Display Data' from the 'Settings' menu. This will try to determine the most preferrable VGA mode from the monitor's extended display information database (EDID). After a new mode has been selected, you should test it by clicking the 'Test/Adjust' button. If successful, you can then apply this VGA mode to all Indivision modes using the next menu item. See 5.7, Apply this VGA Mode to All.

5.7 Apply this VGA Mode to All

To use the current VGA mode for all active Indivision modes in the list, select from the 'Settings' menu 'Apply this VGA Mode to All...'.

6. VGA mode selection and editing

Before you proceed, please make sure that you have read the first paragraph of section 3 Security measures, prerequisites.

If this configuration panel looks confusing to you, don't worry, so it does to the author. Just use it for picking a different VGA mode for assigning it to an Indivision mode.

You can, but you do not need to edit VGA modes. With the predefined VGA modes, all dangerous settings are greyed out so you cannot even change them by accident.

Select a VGA mode that you wish to assign to your Indivision mode from the list to the right.

Before you click 'Accept', you should have tested the VGA mode on your monitor at least once. Because when you 'Accept' a mode that doesn't show a picture on your monitor, you have only the Escape key left on the main window to get the picture back. And with this you risk to lose other changes that you may have made before in the main window.

So click 'Test/Adjust' to test the VGA mode. If this yields a good picture, click 'Okay', and then you can 'Accept' it. Otherwise please press 'Cancel' or the Escape key.

6.1 VGA mode creation

To change anything in a VGA mode, you must first create a copy by clicking 'Copy'. Your new own mode will then show up at the top of the list.

Now all settings are available, including 'Pixel Clock', 'VSync', 'Auto Resolution', and all horizontal and vertical timings.

For example, you can now crank the 'Pixel Clock' slider to the very right. Or the very left. Or you can set 'F.Porch' to zero, or 'Visible' to 64. Nothing of this will likely yield something that you desire. Better do not even test this: If you make mistakes, better delete the current VGA mode by pressing 'Delete', and begin with a new copy. Watch out that Horizontal frequency (in KHz) and Vertical frequency (in Hz) do not exceed the limits of your monitor, especially if you have a very old monitor. As you change parameters, these frequency values will change all the time.

Read you monitor's specifications, use a VGA mode calculator, or try only small steps on the 'Test/Adjust' screen. On the test screen, you have the following keyboard shortcuts:

Escape: Exit
Cursor left and right: Change horizontal porch
Shift+Cursor left and right: Change horizontal sync length
Cursor up and down: Change vertical porch
Shift+Cursor up and down: Change vertical sync length

As long as you get a good and stable picture, you can leave the test screen by clicking 'Okay' to use these settings in your new VGA mode, and 'Accept' them to bind the new mode to the Indivision mode on the main window.

6.2 Auto Resolution

In 'Auto Resolution' mode, the Amiga's pixel clock will be used for display generation. In this mode, all timing settings and scaling will be disabled, as these are done automatically.

7. Advanced topics

7.1 Commandline arguments

CONFIGFILE - Name of a configuration file to load at startup SAVEEDID - Filename for saving the monitor's EDID block

7.2 Signals

Program signals are defined as follows: - CTRL-C terminates the program, reverting to the previous live registers. - CTRL-E opens the main window again when iconified.

8. Flashtool

With the IndivisionECSv4 settings program, you can produce a rescue disk on which there is a tool named 'flashtool'. This program can not only flash a firmware and reset the configuration in flash, but it can also write a configuration.

Flashtool synopsis:

Template: FLASH/K,FPGA/S,DELAY/N/K,SAVECONFIG/K,OCS/S FLASH/K - Firmware file to flash FPGA/S - FPGA mode [default: CPLD mode] DELAY/N/K - Initial delay, in seconds SAVECONFIG/K - Config file to save to flash OCS/S - Force config to OCS mode

The rescue disk starts this flashtool automatically from its startup-sequence, but if your display has gone black or distorted, you can also enter (blindly, if everything else failed):

> flashtool flash firmware

This should give you a picture back with the hardcoded defaults, and

> flashtool saveconfig default.conf

to write a configuration file.

The flashtool reports the return status using the Amiga's power LED, as follows:

Blinking once, pause, repeat: Success, all ok
Blinking twice, pause, repeat: Flash not found
Blinking three times, pause, repeat: Some other error

The 'flashtool' program and the files 'firmware' and 'default.conf' are also on the distribution disk (or in the archive).

9. Indiswitcher

This utility suspends the monitor on the IndivisionECSv4 when a screen with a Picasso96 RTG mode is in front.

Requirements: rtg.library v41, 'RTG Switch' option enabled (see above)

Usage: Start the indiswitcher utility to activate it. Start it another time to deactivate it. Ideally it is started when an Amiga native screen is in front.

Installation: Run it in startup-sequence, after binding monitors, before IPrefs.

Example / Tutorial

For a short example/tutorial, see see also Indivision_AGA_MK3/doc#Example_.2F_Tutorial, which is very similar to this product.

Changelog

1.0

another round of default mode changes; names of default modes reflect only the Amiga screenmodes now. The first couple of inactive modes in the list are editable presets, while the defaults are largely immutable - save for pan, scale, and VGA mode.
modes copied by the user are now prefixed with "Copy of".
major overhaul of the documentation
added firmware 20241104

0.14

the OSD position config wasn't loaded correctly from config, fixed
improved liveconfig validity checks and other startup checks
A2024 preset mode also covers NTSC
Indivision modes renamed (Amiga screenmode name first)
Min/Max Lines and Select mode are now ghosted in default modes

0.13

under Kick2.x, string gadgets were empty after editing, fixed
preset modes in the Indivision mode list are now editable, and from their names the "Pre" prefix has been removed. (Note that in order to maintain compatibility with old configurations, this change affects only new configurations - or after "Restore to Defaults".)
added doublescan key shortcut on Indivision mode test screen
added A2024 preset mode (on empty configuration or after "Restore to defaults")
added firmware 20240912

0.12

added firmware 20240823
no longer warns about testing on AutoRes mode
added A2024 mode criteria selection

0.11

added firmware 20240725

Indivision ECS V4/doc

Contents