EMMA 02

XML CODE

  • Home
  • Download
  • Change Log
  • Help
  • Compilation
    • Windows
    • OS X
    • Ubuntu
    • Fedora
    • openSUSE
  • Forums
  • Tape Conversion
  • Machine Code
    • SYSTEM00
    • CDP1801
    • CDP1802
    • CDP1804
    • CDP1805
    • Differences
  • Pseudo Code
    • AMVBAS
    • AM4KBAS
    • CARDTRAN
    • Chip-8, 8X, ETI-660 & Elf
    • FEL-1
    • FPA-1
    • FPL-2
    • FPL-4
    • GPL-2
    • GPL-3
    • GPL-4
    • GPL-A (2K RAM)
    • GPL-A (2K ROM)
    • ST2
    • ST4
    • STK
    • Test-Word
    • Super-chip
  • XML Code
    • Main Elements
    • I/O
    • System
    • A/D Convertor
    • BASIC
    • Batch wav
    • Bootstrap
    • Cassette
    • CD4536B
    • CDP1851
    • CDP1852
    • CDP1854
    • CDP1855
    • CDP1877
    • CDP1878
    • CDP1879
    • Debugger
    • COMX Diagnostic
    • Dip switch
    • Disk
    • EF Buttons
    • Flip Flop
    • Front Panel
    • GUI
    • HEX Modem
    • I/O Group
    • Keyboard
    • Keyfile
    • Locations
    • Memory
    • MM57109
    • Printer
    • RTC
    • Sound
    • Splash
    • USB
    • Video
    • Videodump
    • vt
    • X Modem
  • BASIC
    • General Information
    • COMX BASIC V1.00
    • Floating Point BASIC 2.2
    • Pecom 32 BASIC
    • Pecom 64 BASIC 1.0 & 4.0
    • Quest Super BASIC 1.4
    • Quest Super BASIC 3.0
    • Quest Super BASIC 5.0
    • Quest Super BASIC 6.0
    • RCA BASIC3 V1.1
    • Telmac SBASIC v24.3
    • Error Messages
  • Computer List

 

 

 

 

 

 

 

 

 

 

 

 

Element: video

Video definition. The type attribute defines one of the different video HW configurations: coin (RCA Video Coin Arcade Game Console), cdp1861 (alternatively 1861 or pixie), cdp1862 (or 1862), cdp1864 (or 1864), st4 (Studio IV video), vip2k (VIP2K Membership Card video), fred (FRED 1 or 1.5 video), mc6845, mc6847, tms9918, intel8275, 1870 (RCA VIS 1870) or sn76430n (Cybervision 2001 video)

Type: coin

Video definition for the RCA Video Coin Arcade Game Console.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
graphics child elements Define graphic constants
height height (pixels) Define video screen height in pixels.
iogroup group number (8 bit) Coin Arcade iogroup definition. For details about value usage see XML - I/O
out mask, q port (1 to 7) Coin Arcade output port definition to enable graphics. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
xscale x scale factor Define default x scale, when not specified factor 3 will be used.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: cdp1861

Video definition for the CDP1861 (pixie) chip.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines foreground (type="fore") or background (type="back") color. For the VISICOM COM-100 color option 3 additional foregroud colors can be specified: type="fore1", type="fore2" and type="fore3". Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
colortype vis Defines VISICOM COM-100 color option.
ef pol, q ef flag (1 to 4) EF used for frame indicator. Use type="on" to use frame indicator only when screen is on / enabled. For details about attribute and value usage see XML - I/O
graphics child elements Define graphic constants
height height (pixels) Define video screen height in pixels.
highres Define high resolution mode.
in mask, q, type port (1 to 7) CDP1861 input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O
io mask, q, type port (1 to 7) CDP1861 input and output port definition to enable (type="on", default) or disable (type="off") graphics. WHen using io instead of in or out, the specified port will be defined as input and output for the same function. For details about attribute and value usage see XML - I/O
iogroup group number (8 bit) CDP1861 iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) CDP1861 output port definition to enable (type="on") or disable (type="off", default) graphics. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
xscale x scale factor Define default x scale, when not specified factor 3 will be used.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: cdp1862

Video definition for the CDP1862 chip, this definition should always be used in combination with the CDP1861 (pixie) definition.

child element attribute value description
color type red, green, blue (8 bit) Defines foreground (type: white (or fore), red, blue, magenta, green, yellow, cyan, black) and/or background (type: back_blue (or back), back_black, back_green, back_red) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
colorram mask Define color RAM range, RAM bits as defined in mask
colortype cos, eti, hec, hug, tmc, vic, vip Defines the color option: cos (Cosmicos, default), eti (ETI-660), hec (HEC1802), hug (HUG1802), tmc (Telmac 1800/2000), vic (Soundic Victory) or vip (COSMAC VIP)
iogroup group number (8 bit) CDP1862 iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) CDP1862 output port. Attribute Type="back" defines the output port to switch background colour. Attribute Type="color_ram" defines the output port to write to color RAM using the RAM bits as defined in mask. For details about attribute and value usage see XML - I/O

Type: cdp1864

Video definition for the CDP1864 chip.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines foreground (type: white (or fore), red, blue, magenta, green, yellow, cyan, black) and/or background (type: back_blue (or back), back_black, back_green, back_red) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
colorram mask Define color RAM range, RAM bits as defined in mask
colortype cos, eti, hec, hug, tmc, vic, vip Defines the color option: cos (Cosmicos, default), eti (ETI-660), hec (HEC1802), hug (HUG1802), tmc (Telmac 1800/2000), vic (Soundic Victory) or vip (COSMAC VIP)
ef pol, q ef flag (1 to 4) EF used for frame indicator. Use type="on" to use frame indicator only when screen is on / enabled. For details about attribute and value usage see XML - I/O
graphics child elements Define graphic constants
height height (pixels) Define video screen height in pixels.
in mask, q, type port (1 to 7) CDP1864 input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O
io mask, q, type port (1 to 7) CDP1864 input and output port definition to enable (type="on", default) or disable (type="off") graphics. WHen using io instead of in or out, the specified port will be defined as input and output for the same function. For details about attribute and value usage see XML - I/O
iogroup group number (8 bit) CDP1864 iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) CDP1864 output port definition. Attribute type="tone" defines the output port to set tone latch. Attribute type="back" defines the output port to switch background color. Attribute type="color_tone" defines the output port to set tone and color latch. Attribute Type="color_ram" defines the output port to write to color RAM using the RAM bits as defined in mask. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
xscale x scale factor Define default x scale, when not specified factor 4 will be used.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: st4

Video definition for the the Studio IV video chip.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines foreground (type: black, red, blue, magenta, green, yellow, cyan, white) and/or background (type: back_black, back_red, back_blue, back_magenta, back_green, back_yellow, back_cyan, back_white) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
colorram Define color RAM range
ef pol, q ef flag (1 to 4) EF used for frame indicator. Use type="on" to use frame indicator only when screen is on / enabled. For details about attribute and value usage see XML - I/O
graphics child elements Define graphic constants
height height (pixels) Define video screen height in pixels.
in mask, q, type port (1 to 7) Studio IV input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O
iogroup group number (8 bit) Studio IV video iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) Studio IV video output port definition. Attribute type="color" defines the output port to set color, enable graphics and PAL/NTSC mode, two 'color' output ports can be defined by repeating this tag. Attribute type="dma" defines the output port to enable the dma burst. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
xscale x scale factor Define default x scale, when not specified factor 4 will be used.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: graphics

Graphics line details for some of the above video chips.

child element attribute value description
interrupt line Defines graphic line when an interrupt should be generated.
start line Defines graphic line when an interrupt should be generated.

Type: vip2k

Video definition for the VIP2K Membership Card.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
dirname type directory name (text) Location of the sequencer file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system).
ef pol, q ef flag (1 to 4) EF used for frame indicator. For details about attribute and value usage see XML - I/O
filename file name (text) VIP2K Membership Card sequencer filename.
height height (pixels) Define video screen height in pixels.
in mask, q, type port (1 to 7) VIP2K Membership Card input port definition to enable (type="on", default) or disable (type="off") graphics. For details about attribute and value usage see XML - I/O
io mask, q, type port (1 to 7) VIP2K Membership Card input and output port definition to enable (type="on", default) or disable (type="off") graphics. WHen using io instead of in or out, the specified port will be defined as input and output for the same function. For details about attribute and value usage see XML - I/O
iogroup group number (8 bit) VIP2K Membership Card iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) VIP2K Membership Card output port definition to enable (type="on") or disable (type="off", default) graphics. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
xscale x scale factor Define default x scale, when not specified factor 1.5 will be used.
width width (pixels) Define video screen width in pixels.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: fred

Video definition for the FRED 1 or 1.5.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
height height (pixels) Define video screen height in pixels.
iogroup group number (8 bit) FRED 1 or 1.5 iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) FRED 1 or 1.5 output port definition (bit 0-2 background colour, bit 3 white foreground, bit 4-5 enable graphics, bit 6 PAL/NTSC). For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
xscale x scale factor Define default x scale, when not specified no factor will be used.
width width (pixels) Define video screen width in pixels.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: mc6845

Video definition for the MC6845 chip.

child element attribute value description
border XxY (pixels) Defines default border size.
char XxY (pixels) Define initial character size in pixels, e.g. 7x8 will define characters of 7 pixels wide and 8 pixels high. Note that charcater height can be changed via the CRTC address and data register.
color type red, green, blue (8 bit) Defines foreground (type="fore") or background (type="back") color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
dirname type directory name (text) Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system).
ef pol, q ef flag (1 to 4) EF used for display enable. For details about attribute and value usage see XML - I/O
font font file name (text) MC6845 font file filename.
interlace Set interlace option on
iogroup group number (8 bit) MC6845 iogroup definition. For details about value usage see XML - I/O
out mask, type address (16 bit) MC6845 output definition using a memory address. Attribute type="register" defines the CRTC address register. Attribute type="data" defines the CRTC data register. Using the mask option will allow a range of addresses. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
ram start-end (hex format and 16 bit) Defines video ram in a range within the CPU memory map. Always specify a range in hex (0x) format.
screen XxY (character x lines) Defines initial screen size in characters, e.g. 64x16 will define a screen of 64 characters wide and 16 lines. Note that screen size can be changed via the CRTC address and data register.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: mc6847

Video definition for the MC6847 chip.

child element attribute value description
as init bit number Defines 'as' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
ag init bit number Defines 'ag' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines text (type: text_back, text_back, text_orange) and/or graphic (type: graph_green, graph_yellow, graph_blue, graph_red, graph_buff, graph_cyan, graph_magenta, graph_orange) colors. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
css init bit number Defines 'css' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
dirname type directory name (text) Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system).
ext init bit number Defines 'ext' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
font font file name (text) MC6847 font file filename.
gm0 init bit number Defines 'gm0' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
gm1 init bit number Defines 'gm1' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
gm2 init bit number Defines 'gm2' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
inv init bit number Defines 'inv' function per bit number: use b0-b7 or 0-7 for bit 0 to 7, use dd6 to dd11 for dd bits. Note dd8 to dd11 are the same as b0 to b3. When attribute init="high" is used the bit will be initialized as 1 otherwise 0.
iogroup group number (8 bit) MC6847 iogroup definition. For details about value usage see XML - I/O
out mask, q port (1 to 7) or address range (16 bit) MC6847 output definition output number to select video mode either defined as an output port (1-7) or range (use hex, i.e. 0xFF00-0xFFFF). For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
ram start-end (hex format and 16 bit) Defines video ram in a range within the CPU memory map. Always specify a range in hex (0x) format.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: tms9918

Video definition for the TMS9918 chip.

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines color (type: transparant, black, medium_green, light_green, dark_blue, light_blue, dark_red, aqua_blue, medium_red, light_red, dark_yellow, light_yellow, dark_green, purple, gray, white) definiton. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
ef pol, q ef flag (1 to 4) EF used for interrupt. For details about attribute and value usage see XML - I/O
iogroup group number (8 bit) TMS9918 iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) TMS9918 output port definition. Attribute type="register" defines the port to select the register. Attribute type="data" defines the port for data output. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: intel8275

Video definition for the Intel 8275 chip.

child element attribute value description
border XxY (pixels) Defines default border size.
char XxY (pixels) Define initial character size in pixels, e.g. 8x9 will define characters of 8 pixels wide and 9 pixels high.
clock number / fraction (0 > value > 500) Intel 8275 clock speed.
color type red, green, blue (8 bit) Defines foreground (type="fore"), background (type="back") or highlight (type="high")color. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
dirname type directory name (text) Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system).
ef pol, q, type ef flag (1 to 4) EF used for the horizontal (type="horizontal") and vertical (type="vertical") retrace. For details about attribute and value usage see XML - I/O
font gpa font file name (text) Intel 8275 font file filename. With gpa="switched" gpa bits are switched (used for the SBC1802)
in mask, q, type port (1 to 7) Intel 8275 input portin definition using a memory address. Attribute type="status" defines the port to read the status. Attribute type="parameter" defines the port to read the parameter. For details about attribute and value usage see XML - I/O
int type CDP1877 PIC interrupt number Specify PIC interrupt number (if used) for the horizontal (type="horizontal") and vertical (type="vertical") retrace.
interlace Set interlace option on
iogroup group number (8 bit) Intel 8275 iogroup definition. For details about value usage see XML - I/O
out mask, q, type port (1 to 7) Intel 8275 output port definition. Attribute type="command" defines the port to write the command. Attribute type="parameter" defines the port to write the parameter. For details about attribute and value usage see XML - I/O
pos screen position (x, y) Defines default video terminal screen position.
screen XxY (character x lines) Defines initial screen size in characters, e.g. 80x26 will define a screen of 80 characters wide and 26 lines.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: 1870

Video definition for the VIS 1870.

child element attribute value description
border XxY (pixels) Defines default border size.
charlines number of lines (8 or 9) Defines default number of character lines 8 or 9. The actual value should be set by FW but the default is used for the initial emulation screen size. If not specified 8 will be used for NTSC and 9 for PAL.
charrom address (16 bit) Defines at which addres character RAM changes to ROM (i.e., where character ROM starts)
charsize iogroup, type size (0x3ff or 0x7ff) Define charcater memory as RAM (type="ram") or ROM (type="rom") with size 0x3ff or 0x7ff. Attribute iogroup="no" will decouple activation of character RAM from the defined I/O group.
clock speed (MHz) VIS 1870 clock speed
cmamaskfixed CMA mask fixed to 0xf independent of the number of lines. NTSC or 8 lines would normally use CMA mask 0x7 but COMX NTSC still uses 16 lines per character in memory so CMA mask is 0xf.
color num, mask red, green, blue (8 bit) Defines color where attribute num="x" will set color x with x=0 to 7. Attribute mask defines the color mask for color x (num="x") where x=0 to 7. Color mask is used in the ctone definition which defines the different brightness levels. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
colorram type Define color RAM type: type="cidelsa" (color ram HW as in Cidelsa) or type="tmc" (color ram HW as in TMC600)
ctone num Defines the CTONE brightness value for color x (num="x"), this should be used in combination with a defintion of a color mask only.
cursorblink Activates cursor blinking
dirname type directory name (text) Location of the font file file; defined as sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system).
ef pol, q ef flag (1 to 4) VIS 1870 EF flag definition. Attribute type="display" defines the EF flag for the non display period. Attribute type="mode" defines the EF flag to select video mode (used in the COMX-35 or COMIX-35, where this function is only active until first Q pulse). Attribute write="enable" will enable writing to video RAM even during display period. For details about attribute and value usage see XML - I/O
filename format file name (text) VIS 1870 character ROM file filename. Attribute format="tmc" loads a file in TMC format.
graphicsize iogroup, type size (0x1fff) Define graphic memory as RAM with size 0x1fff. Attribute iogroup="no" will decouple activation of character RAM from the defined I/O group.
int type CDP1877 PIC interrupt number Specify PIC interrupt number (if used).
int_mode VIS 1870 interrupt mode.
iogroup group number (8 bit) VIS 1870 iogroup definition. For details about value usage see XML - I/O
maxcharlines number of lines (8 or 16) Defines maximum number of character lines 8 or 16. When using PAL, 9 lines are visible but 16 are reserved in character memory.
maxscreenlines number of lines (24, 25 or 27) Defines number of lines on one screen: 24, 25 or 27 (for Cidelsa DRACO)
mode mode (pal or ntsc) Defines video mode pal or ntsc
out mask, q, type port (1 to 7) VIS 1870 output port definition. Attribute type="select" defines the port to select the VIS 1870 port (as used in the Telmac TMC-600). Attribute type="write" defines the port to write to the selected VIS 1870 port (as used in the Telmac TMC-600). Attribute type="int" defines the port to set interrupt enable (port 2 on the RCA COSMC Microboard Computer). Attribute type="int_reset" defines the port to reset the interrupt request (port 2 on the VIS1802). For details about attribute and value usage see XML - I/O
pagesize iogroup, type size (0x3ff or 0x7ff) Defines page memory as RAM with size 0x3ff or 0x7ff. Attribute type="ram" is the normal configuration and type="rom" will define page memory as RAM but add the option to load a ROM to 0xF800-0xFFFF as well. Attribute iogroup="no" will decouple activation of page RAM from the defined I/O group.
pcbmask 0x7f or 0xff Defines pcb mask 0x7f or 0xff
pos screen position (x, y) Defines default video terminal screen position.
rotate Rotate screen 90% as in Cidelsa
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.

Type: sn76430n

Video definition for the SN76430N chip (Cybervision 2001 video).

child element attribute value description
border XxY (pixels) Defines default border size.
color type red, green, blue (8 bit) Defines color (type: white, yellow, green, red or black) definiton. Color is specified as red, green, blue all 3 values range from 0 to 255. If no color definition is specified the default color set will be used.
pos screen position (x, y) Defines default video terminal screen position.
zoom zoom factor Define default zoom, when not specified factor 2.00 will be used.