← Back to branch summary

~ubuntu-branches/ubuntu/utopic/vice/utopic

« back to all changes in this revision

Viewing changes to doc/html/vice_7.html

  • Committer: Package Import Robot
  • Author(s): Logan Rosen
  • Date: 2014-05-10 21:08:23 UTC
  • mfrom: (17.2.1 utopic-proposed)
  • Revision ID: package-import@ubuntu.com-20140510210823-r7x98jmpl1x7rgop
Tags: 2.4.dfsg+2.4.6-1ubuntu1
Use autotools-dev to update config.{sub,guess} for new arches.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/vice_7.html
1
1
<HTML>
2
2
<HEAD>
3
3
<!-- This HTML file has been created by texi2html 1.52
4
 
     from ../../doc/vice.texi on 2 November 2012 -->
 
4
     from ../../doc/vice.texi on 9 Febuary 2014 -->
5
5
 
6
6
<TITLE>VICE Manual - 7  Machine-specific features</TITLE>
7
7
</HEAD>
10
10
<P><HR><P>
11
11
 
12
12
 
13
 
<H1><A NAME="SEC93" HREF="vice_toc.html#TOC93">7  Machine-specific features</A></H1>
14
 
 
15
 
 
16
 
 
17
 
<H2><A NAME="SEC94" HREF="vice_toc.html#TOC94">7.1  C64/128-specific commands and settings</A></H2>
 
13
<H1><A NAME="SEC94" HREF="vice_toc.html#TOC94">7  Machine-specific features</A></H1>
 
14
 
 
15
 
 
16
 
 
17
<H2><A NAME="SEC95" HREF="vice_toc.html#TOC95">7.1  C64/128-specific commands and settings</A></H2>
18
18
 
19
19
<P>
20
20
This section lists the settings and commands that are C64/128 specific
24
24
 
25
25
 
26
26
 
27
 
<H3><A NAME="SEC95" HREF="vice_toc.html#TOC95">7.1.1  Using cartridges</A></H3>
 
27
<H3><A NAME="SEC96" HREF="vice_toc.html#TOC96">7.1.1  Using cartridges</A></H3>
28
28
 
29
29
<P>
30
30
The cartridge system is organized in "Slots" to allow more than one cartridge
87
87
</P>
88
88
 
89
89
 
90
 
<H4><A NAME="SEC96" HREF="vice_toc.html#TOC96">7.1.1.1  Slot 0</A></H4>
 
90
<H4><A NAME="SEC97" HREF="vice_toc.html#TOC97">7.1.1.1  Slot 0</A></H4>
91
91
 
92
92
<P>
93
93
All carts that have a passthrough connector go here. Once a "Slot 0"
122
122
 
123
123
 
124
124
 
125
 
<H4><A NAME="SEC97" HREF="vice_toc.html#TOC97">7.1.1.2  Slot 1</A></H4>
 
125
<H4><A NAME="SEC98" HREF="vice_toc.html#TOC98">7.1.1.2  Slot 1</A></H4>
126
126
 
127
127
<P>
128
128
Mostly RAM based cartridges which for one reason or the other might make sense
159
159
 
160
160
 
161
161
 
162
 
<H4><A NAME="SEC98" HREF="vice_toc.html#TOC98">7.1.1.3  Main Slot</A></H4>
 
162
<H4><A NAME="SEC99" HREF="vice_toc.html#TOC99">7.1.1.3  Main Slot</A></H4>
163
163
 
164
164
<P>
165
165
All other cartridges which are not pure i/o extensions go here.
327
327
 
328
328
 
329
329
 
330
 
<H4><A NAME="SEC99" HREF="vice_toc.html#TOC99">7.1.1.4  I/O Slot</A></H4>
 
330
<H4><A NAME="SEC100" HREF="vice_toc.html#TOC100">7.1.1.4  I/O Slot</A></H4>
331
331
 
332
332
<P>
333
333
All carts that are pure I/O extensions go here.
375
375
 
376
376
 
377
377
 
378
 
<H4><A NAME="SEC100" HREF="vice_toc.html#TOC100">7.1.1.5  Expected behaviour</A></H4>
 
378
<H4><A NAME="SEC101" HREF="vice_toc.html#TOC101">7.1.1.5  Expected behaviour</A></H4>
379
379
 
380
380
<P>
381
381
When the emulator is run without arguments, all settings from the config file
405
405
</P>
406
406
 
407
407
 
408
 
<H4><A NAME="SEC101" HREF="vice_toc.html#TOC101">7.1.1.6  Common problems</A></H4>
 
408
<H4><A NAME="SEC102" HREF="vice_toc.html#TOC102">7.1.1.6  Common problems</A></H4>
409
409
 
410
410
<P>
411
411
If attaching a cartridge does not work as expected, this may be because of various
454
454
 
455
455
 
456
456
 
457
 
<H4><A NAME="SEC102" HREF="vice_toc.html#TOC102">7.1.1.7  IEEE-488 interface</A></H4>
 
457
<H4><A NAME="SEC103" HREF="vice_toc.html#TOC103">7.1.1.7  IEEE-488 interface</A></H4>
458
458
 
459
459
<P>
460
460
To be able to use an IEEE drive, you need to enable IEEE emulation for the
478
478
</P>
479
479
 
480
480
 
481
 
<H4><A NAME="SEC103" HREF="vice_toc.html#TOC103">7.1.1.8  The Final Cartridge 3</A></H4>
 
481
<H4><A NAME="SEC104" HREF="vice_toc.html#TOC104">7.1.1.8  The Final Cartridge 3</A></H4>
482
482
<P>
483
483
The Final Cartridge 3 detects whether a mouse is connected when it starts and
484
484
disables mouse support if it doesnt detect one. So to make mouse emulation
488
488
</P>
489
489
 
490
490
 
491
 
<H3><A NAME="SEC104" HREF="vice_toc.html#TOC104">7.1.2  C64 cartridge settings</A></H3>
492
 
 
493
 
 
494
 
 
495
 
<H4><A NAME="SEC105" HREF="vice_toc.html#TOC105">7.1.2.1  C64 cartridge resources</A></H4>
 
491
<H3><A NAME="SEC105" HREF="vice_toc.html#TOC105">7.1.2  C64 cartridge settings</A></H3>
 
492
 
 
493
 
 
494
 
 
495
<H4><A NAME="SEC106" HREF="vice_toc.html#TOC106">7.1.2.1  C64 cartridge resources</A></H4>
496
496
 
497
497
<DL COMPACT>
498
498
 
784
784
 
785
785
 
786
786
 
787
 
<H4><A NAME="SEC106" HREF="vice_toc.html#TOC106">7.1.2.2  C64 cartridge command-line options</A></H4>
 
787
<H4><A NAME="SEC107" HREF="vice_toc.html#TOC107">7.1.2.2  C64 cartridge command-line options</A></H4>
788
788
 
789
789
<DL COMPACT>
790
790
 
1304
1304
 
1305
1305
 
1306
1306
 
1307
 
<H3><A NAME="SEC107" HREF="vice_toc.html#TOC107">7.1.3  CIA settings</A></H3>
1308
 
 
1309
 
 
1310
 
 
1311
 
<H4><A NAME="SEC108" HREF="vice_toc.html#TOC108">7.1.3.1  CIA resources</A></H4>
 
1307
<H3><A NAME="SEC108" HREF="vice_toc.html#TOC108">7.1.3  CIA settings</A></H3>
 
1308
 
 
1309
 
 
1310
 
 
1311
<H4><A NAME="SEC109" HREF="vice_toc.html#TOC109">7.1.3.1  CIA resources</A></H4>
1312
1312
 
1313
1313
<DL COMPACT>
1314
1314
 
1325
1325
 
1326
1326
 
1327
1327
 
1328
 
<H4><A NAME="SEC109" HREF="vice_toc.html#TOC109">7.1.3.2  CIA command-line options</A></H4>
 
1328
<H4><A NAME="SEC110" HREF="vice_toc.html#TOC110">7.1.3.2  CIA command-line options</A></H4>
1329
1329
 
1330
1330
<DL COMPACT>
1331
1331
 
1347
1347
 
1348
1348
 
1349
1349
 
1350
 
<H3><A NAME="SEC110" HREF="vice_toc.html#TOC110">7.1.4  VIC-II settings</A></H3>
 
1350
<H3><A NAME="SEC111" HREF="vice_toc.html#TOC111">7.1.4  VIC-II settings</A></H3>
1351
1351
 
1352
1352
<P>
1353
1353
These settings control the emulation of the VIC-II (MOS6569) video chip
1407
1407
 
1408
1408
 
1409
1409
 
1410
 
<H4><A NAME="SEC111" HREF="vice_toc.html#TOC111">7.1.4.1  VIC-II resources</A></H4>
 
1410
<H4><A NAME="SEC112" HREF="vice_toc.html#TOC112">7.1.4.1  VIC-II resources</A></H4>
1411
1411
 
1412
1412
<DL COMPACT>
1413
1413
 
1555
1555
 
1556
1556
 
1557
1557
 
1558
 
<H4><A NAME="SEC112" HREF="vice_toc.html#TOC112">7.1.4.2  VIC-II command-line options</A></H4>
 
1558
<H4><A NAME="SEC113" HREF="vice_toc.html#TOC113">7.1.4.2  VIC-II command-line options</A></H4>
1559
1559
 
1560
1560
<DL COMPACT>
1561
1561
 
1701
1701
 
1702
1702
 
1703
1703
 
1704
 
<H3><A NAME="SEC113" HREF="vice_toc.html#TOC113">7.1.5  SID settings</A></H3>
 
1704
<H3><A NAME="SEC114" HREF="vice_toc.html#TOC114">7.1.5  SID settings</A></H3>
1705
1705
 
1706
1706
<P>
1707
1707
These settings control the emulation of the SID (MOS6581 or MOS8580)
1794
1794
 
1795
1795
 
1796
1796
 
1797
 
<H4><A NAME="SEC114" HREF="vice_toc.html#TOC114">7.1.5.1  SID resources</A></H4>
 
1797
<H4><A NAME="SEC115" HREF="vice_toc.html#TOC115">7.1.5.1  SID resources</A></H4>
1798
1798
 
1799
1799
<DL COMPACT>
1800
1800
 
1834
1834
<DD>
1835
1835
Integer specifying what SID engine will be used (<CODE>0</CODE>: FASTSID, <CODE>1</CODE>: RESID
1836
1836
, <CODE>2</CODE>: CATWEASELMKIII, <CODE>3</CODE>: HARDSID, <CODE>4</CODE>: PARSID_PORT1, <CODE>5</CODE>: PARSID_PORT2
1837
 
, <CODE>6</CODE>: PARSID_PORT3, <CODE>7</CODE>: RESID_FP).
 
1837
, <CODE>6</CODE>: PARSID_PORT3).
1838
1838
 
1839
1839
<A NAME="IDX690"></A>
1840
1840
<DT><CODE>SidResidSampling</CODE>
1862
1862
 
1863
1863
 
1864
1864
 
1865
 
<H4><A NAME="SEC115" HREF="vice_toc.html#TOC115">7.1.5.2  SID command-line options</A></H4>
 
1865
<H4><A NAME="SEC116" HREF="vice_toc.html#TOC116">7.1.5.2  SID command-line options</A></H4>
1866
1866
 
1867
1867
<DL COMPACT>
1868
1868
 
1895
1895
258: ReSID 8580 + digiboost,
1896
1896
1024: ParSID in par port 1,
1897
1897
1280: ParSID in par port 2,
1898
 
1536: ParSID in par port 3,
1899
 
1800: ReSID-FP 6581R3 4885,
1900
 
1801: ReSID-FP 6581R3 0486S,
1901
 
1802: ReSID-FP 6581R3 3984,
1902
 
1803: ReSID-FP 6581R4 AR 3789,
1903
 
1804: ReSID-FP 6581R3 4485,
1904
 
1805: ReSID-FP 6581R4 1986S,
1905
 
1808: ReSID-FP 8580R5 3691,
1906
 
1809: ReSID-FP 8580R5 3691 + digiboost,
1907
 
1810: ReSID-FP 8580R5 1489,
1908
 
1811: ReSID-FP 8580R5 1489D).
 
1898
1536: ParSID in par port 3).
1909
1899
 
1910
1900
<A NAME="IDX698"></A>
1911
1901
<DT><CODE>-sidfilters</CODE>
1942
1932
 
1943
1933
 
1944
1934
 
1945
 
<H3><A NAME="SEC116" HREF="vice_toc.html#TOC116">7.1.6  C64 I/O extension settings</A></H3>
 
1935
<H3><A NAME="SEC117" HREF="vice_toc.html#TOC117">7.1.6  C64 I/O extension settings</A></H3>
1946
1936
 
1947
1937
<P>
1948
1938
I/O extensions are (usually) cartridges which do not map into ROM space,
1997
1987
 
1998
1988
 
1999
1989
 
2000
 
<H4><A NAME="SEC117" HREF="vice_toc.html#TOC117">7.1.6.1  C64 I/O extension resources</A></H4>
 
1990
<H4><A NAME="SEC118" HREF="vice_toc.html#TOC118">7.1.6.1  C64 I/O extension resources</A></H4>
2001
1991
 
2002
1992
<DL COMPACT>
2003
1993
 
2120
2110
 
2121
2111
 
2122
2112
 
2123
 
<H4><A NAME="SEC118" HREF="vice_toc.html#TOC118">7.1.6.2  C64 I/O extension command-line options</A></H4>
 
2113
<H4><A NAME="SEC119" HREF="vice_toc.html#TOC119">7.1.6.2  C64 I/O extension command-line options</A></H4>
2124
2114
 
2125
2115
<DL COMPACT>
2126
2116
 
2255
2245
 
2256
2246
 
2257
2247
 
2258
 
<H3><A NAME="SEC119" HREF="vice_toc.html#TOC119">7.1.7  C64/128 system ROM settings</A></H3>
 
2248
<H3><A NAME="SEC120" HREF="vice_toc.html#TOC120">7.1.7  C64/128 system ROM settings</A></H3>
2259
2249
 
2260
2250
<P>
2261
2251
These settings can be used to control what system ROMs are loaded in the
2265
2255
 
2266
2256
 
2267
2257
 
2268
 
<H4><A NAME="SEC120" HREF="vice_toc.html#TOC120">7.1.7.1  C64/128 system ROM resources</A></H4>
 
2258
<H4><A NAME="SEC121" HREF="vice_toc.html#TOC121">7.1.7.1  C64/128 system ROM resources</A></H4>
2269
2259
 
2270
2260
<DL COMPACT>
2271
2261
 
2321
2311
 
2322
2312
 
2323
2313
 
2324
 
<H4><A NAME="SEC121" HREF="vice_toc.html#TOC121">7.1.7.2  C64/128 system ROM command-line options</A></H4>
 
2314
<H4><A NAME="SEC122" HREF="vice_toc.html#TOC122">7.1.7.2  C64/128 system ROM command-line options</A></H4>
2325
2315
 
2326
2316
<DL COMPACT>
2327
2317
 
2351
2341
 
2352
2342
 
2353
2343
 
2354
 
<H3><A NAME="SEC122" HREF="vice_toc.html#TOC122">7.1.8  C64 settings</A></H3>
2355
 
 
2356
 
 
2357
 
 
2358
 
<H4><A NAME="SEC123" HREF="vice_toc.html#TOC123">7.1.8.1  C64 resources</A></H4>
 
2344
<H3><A NAME="SEC123" HREF="vice_toc.html#TOC123">7.1.8  C64 settings</A></H3>
 
2345
 
 
2346
 
 
2347
 
 
2348
<H4><A NAME="SEC124" HREF="vice_toc.html#TOC124">7.1.8.1  C64 resources</A></H4>
2359
2349
 
2360
2350
<DL COMPACT>
2361
2351
 
2409
2399
 
2410
2400
 
2411
2401
 
2412
 
<H4><A NAME="SEC124" HREF="vice_toc.html#TOC124">7.1.8.2  C64 command-line options</A></H4>
 
2402
<H4><A NAME="SEC125" HREF="vice_toc.html#TOC125">7.1.8.2  C64 command-line options</A></H4>
2413
2403
 
2414
2404
<DL COMPACT>
2415
2405
 
2464
2454
 
2465
2455
 
2466
2456
 
2467
 
<H2><A NAME="SEC125" HREF="vice_toc.html#TOC125">7.2  C128-specific commands and settings</A></H2>
2468
 
 
2469
 
 
2470
 
 
2471
 
<H3><A NAME="SEC126" HREF="vice_toc.html#TOC126">7.2.1  VDC settings</A></H3>
2472
 
 
2473
 
 
2474
 
 
2475
 
<H4><A NAME="SEC127" HREF="vice_toc.html#TOC127">7.2.1.1  VDC resources</A></H4>
 
2457
<H2><A NAME="SEC126" HREF="vice_toc.html#TOC126">7.2  C128-specific commands and settings</A></H2>
 
2458
 
 
2459
 
 
2460
 
 
2461
<H3><A NAME="SEC127" HREF="vice_toc.html#TOC127">7.2.1  VDC settings</A></H3>
 
2462
 
 
2463
 
 
2464
 
 
2465
<H4><A NAME="SEC128" HREF="vice_toc.html#TOC128">7.2.1.1  VDC resources</A></H4>
2476
2466
 
2477
2467
<DL COMPACT>
2478
2468
 
2605
2595
 
2606
2596
 
2607
2597
 
2608
 
<H4><A NAME="SEC128" HREF="vice_toc.html#TOC128">7.2.1.2  VDC command-line options</A></H4>
 
2598
<H4><A NAME="SEC129" HREF="vice_toc.html#TOC129">7.2.1.2  VDC command-line options</A></H4>
2609
2599
 
2610
2600
<DL COMPACT>
2611
2601
 
2725
2715
 
2726
2716
 
2727
2717
 
2728
 
<H3><A NAME="SEC129" HREF="vice_toc.html#TOC129">7.2.2  C128 system ROM settings</A></H3>
2729
 
 
2730
 
 
2731
 
 
2732
 
<H4><A NAME="SEC130" HREF="vice_toc.html#TOC130">7.2.2.1  C128 system ROM resources</A></H4>
 
2718
<H3><A NAME="SEC130" HREF="vice_toc.html#TOC130">7.2.2  C128 system ROM settings</A></H3>
 
2719
 
 
2720
 
 
2721
 
 
2722
<H4><A NAME="SEC131" HREF="vice_toc.html#TOC131">7.2.2.1  C128 system ROM resources</A></H4>
2733
2723
 
2734
2724
<DL COMPACT>
2735
2725
 
2810
2800
 
2811
2801
 
2812
2802
 
2813
 
<H4><A NAME="SEC131" HREF="vice_toc.html#TOC131">7.2.2.2  C128 system ROM command-line options</A></H4>
 
2803
<H4><A NAME="SEC132" HREF="vice_toc.html#TOC132">7.2.2.2  C128 system ROM command-line options</A></H4>
2814
2804
 
2815
2805
<DL COMPACT>
2816
2806
 
2884
2874
<DD>
2885
2875
<DT><CODE>+intfunc</CODE>
2886
2876
<DD>
2887
 
Enable/Disable the internal Function ROM
 
2877
Enable/Disable the internal Function ROM (0: None, 1: ROM, 2: RAM, 3: RTC)
2888
2878
<A NAME="IDX872"></A>
2889
2879
<DT><CODE>-intfrom &#60;name&#62;</CODE>
2890
2880
<DD>
2895
2885
<DD>
2896
2886
<DT><CODE>+extfunc</CODE>
2897
2887
<DD>
2898
 
Enable/Disable the external Function ROM
 
2888
Enable/Disable the external Function ROM (0: None, 1: ROM, 2: RAM, 3: RTC)
2899
2889
<A NAME="IDX874"></A>
2900
2890
<DT><CODE>-extfrom &#60;name&#62;</CODE>
2901
2891
<DD>
2905
2895
 
2906
2896
 
2907
2897
 
2908
 
<H3><A NAME="SEC132" HREF="vice_toc.html#TOC132">7.2.3  C128 settings</A></H3>
2909
 
 
2910
 
 
2911
 
 
2912
 
<H4><A NAME="SEC133" HREF="vice_toc.html#TOC133">7.2.3.1  C128 resources</A></H4>
 
2898
<H3><A NAME="SEC133" HREF="vice_toc.html#TOC133">7.2.3  C128 settings</A></H3>
 
2899
 
 
2900
 
 
2901
 
 
2902
<H4><A NAME="SEC134" HREF="vice_toc.html#TOC134">7.2.3.1  C128 resources</A></H4>
2913
2903
 
2914
2904
<DL COMPACT>
2915
2905
 
2935
2925
 
2936
2926
 
2937
2927
 
2938
 
<H4><A NAME="SEC134" HREF="vice_toc.html#TOC134">7.2.3.2  C128 command-line options</A></H4>
 
2928
<H4><A NAME="SEC135" HREF="vice_toc.html#TOC135">7.2.3.2  C128 command-line options</A></H4>
2939
2929
 
2940
2930
<DL COMPACT>
2941
2931
 
2961
2951
 
2962
2952
 
2963
2953
 
2964
 
<H2><A NAME="SEC135" HREF="vice_toc.html#TOC135">7.3  C64DTV-specific commands and settings</A></H2>
 
2954
<H2><A NAME="SEC136" HREF="vice_toc.html#TOC136">7.3  C64DTV-specific commands and settings</A></H2>
2965
2955
 
2966
2956
<P>
2967
2957
This section lists the settings and commands that are C64DTV specific
2971
2961
 
2972
2962
 
2973
2963
 
2974
 
<H3><A NAME="SEC136" HREF="vice_toc.html#TOC136">7.3.1  C64DTV ROM image</A></H3>
 
2964
<H3><A NAME="SEC137" HREF="vice_toc.html#TOC137">7.3.1  C64DTV ROM image</A></H3>
2975
2965
 
2976
2966
<P>
2977
2967
The DTV has a 2MB Flash chip which contains the kernal, basic and
3048
3038
 
3049
3039
 
3050
3040
 
3051
 
<H3><A NAME="SEC137" HREF="vice_toc.html#TOC137">7.3.2  DTV revision</A></H3>
 
3041
<H3><A NAME="SEC138" HREF="vice_toc.html#TOC138">7.3.2  DTV revision</A></H3>
3052
3042
 
3053
3043
<P>
3054
3044
The DTV revision 2 has a bug in the Blitter. Using revision 3
3068
3058
 
3069
3059
 
3070
3060
 
3071
 
<H3><A NAME="SEC138" HREF="vice_toc.html#TOC138">7.3.3  LumaFix</A></H3>
 
3061
<H3><A NAME="SEC139" HREF="vice_toc.html#TOC139">7.3.3  LumaFix</A></H3>
3072
3062
 
3073
3063
<P>
3074
3064
The PAL C64DTVs have wrong resistors in the video output circuit,
3088
3078
 
3089
3079
 
3090
3080
 
3091
 
<H3><A NAME="SEC139" HREF="vice_toc.html#TOC139">7.3.4  Userport</A></H3>
 
3081
<H3><A NAME="SEC140" HREF="vice_toc.html#TOC140">7.3.4  Userport</A></H3>
3092
3082
 
3093
3083
<P>
3094
3084
The C64DTV userport emulation currently supports three devices:
3133
3123
 
3134
3124
 
3135
3125
 
3136
 
<H3><A NAME="SEC140" HREF="vice_toc.html#TOC140">7.3.5  Debug</A></H3>
 
3126
<H3><A NAME="SEC141" HREF="vice_toc.html#TOC141">7.3.5  Debug</A></H3>
3137
3127
 
3138
3128
<P>
3139
3129
Debugging information on Blitter, DMA and Flash can be enabled with command
3168
3158
 
3169
3159
 
3170
3160
 
3171
 
<H3><A NAME="SEC141" HREF="vice_toc.html#TOC141">7.3.6  Monitor DTV features</A></H3>
 
3161
<H3><A NAME="SEC142" HREF="vice_toc.html#TOC142">7.3.6  Monitor DTV features</A></H3>
3172
3162
 
3173
3163
<P>
3174
3164
Currently the registers A, Y and X are registers R0, R1 and R2 regardless of
3188
3178
</P>
3189
3179
 
3190
3180
 
3191
 
<H3><A NAME="SEC142" HREF="vice_toc.html#TOC142">7.3.7  DTV resources</A></H3>
 
3181
<H3><A NAME="SEC143" HREF="vice_toc.html#TOC143">7.3.7  DTV resources</A></H3>
3192
3182
 
3193
3183
<DL COMPACT>
3194
3184
 
3242
3232
 
3243
3233
 
3244
3234
 
3245
 
<H2><A NAME="SEC143" HREF="vice_toc.html#TOC143">7.4  VIC20-specific commands and settings</A></H2>
 
3235
<H2><A NAME="SEC144" HREF="vice_toc.html#TOC144">7.4  VIC20-specific commands and settings</A></H2>
3246
3236
 
3247
3237
<P>
3248
3238
This section lists the settings and commands that are VIC20-specific and
3252
3242
 
3253
3243
 
3254
3244
 
3255
 
<H3><A NAME="SEC144" HREF="vice_toc.html#TOC144">7.4.1  Using cartridge images</A></H3>
 
3245
<H3><A NAME="SEC145" HREF="vice_toc.html#TOC145">7.4.1  Using cartridge images</A></H3>
3256
3246
 
3257
3247
<P>
3258
 
As with the C64 (see section <A HREF="vice_7.html#SEC95">7.1.1  Using cartridges</A>), it is possible to attach
 
3248
As with the C64 (see section <A HREF="vice_7.html#SEC96">7.1.1  Using cartridges</A>), it is possible to attach
3259
3249
several types of cartridge images:
3260
3250
 
3261
3251
</P>
3312
3302
</P>
3313
3303
 
3314
3304
 
3315
 
<H3><A NAME="SEC145" HREF="vice_toc.html#TOC145">7.4.2  VIC20 cartridge settings</A></H3>
3316
 
 
3317
 
 
3318
 
 
3319
 
<H4><A NAME="SEC146" HREF="vice_toc.html#TOC146">7.4.2.1  VIC20 cartridge resources</A></H4>
 
3305
<H3><A NAME="SEC146" HREF="vice_toc.html#TOC146">7.4.2  VIC20 cartridge settings</A></H3>
 
3306
 
 
3307
 
 
3308
 
 
3309
<H4><A NAME="SEC147" HREF="vice_toc.html#TOC147">7.4.2.1  VIC20 cartridge resources</A></H4>
3320
3310
 
3321
3311
<DL COMPACT>
3322
3312
 
3415
3405
 
3416
3406
 
3417
3407
 
3418
 
<H4><A NAME="SEC147" HREF="vice_toc.html#TOC147">7.4.2.2  VIC20 cartridge command-line options</A></H4>
 
3408
<H4><A NAME="SEC148" HREF="vice_toc.html#TOC148">7.4.2.2  VIC20 cartridge command-line options</A></H4>
3419
3409
 
3420
3410
<DL COMPACT>
3421
3411
 
3598
3588
 
3599
3589
 
3600
3590
 
3601
 
<H3><A NAME="SEC148" HREF="vice_toc.html#TOC148">7.4.3  VIC settings</A></H3>
3602
 
 
3603
 
 
3604
 
 
3605
 
<H4><A NAME="SEC149" HREF="vice_toc.html#TOC149">7.4.3.1  VIC resources</A></H4>
 
3591
<H3><A NAME="SEC149" HREF="vice_toc.html#TOC149">7.4.3  VIC settings</A></H3>
 
3592
 
 
3593
 
 
3594
 
 
3595
<H4><A NAME="SEC150" HREF="vice_toc.html#TOC150">7.4.3.1  VIC resources</A></H4>
3606
3596
 
3607
3597
<DL COMPACT>
3608
3598
 
3727
3717
 
3728
3718
 
3729
3719
 
3730
 
<H4><A NAME="SEC150" HREF="vice_toc.html#TOC150">7.4.3.2  VIC command-line options</A></H4>
 
3720
<H4><A NAME="SEC151" HREF="vice_toc.html#TOC151">7.4.3.2  VIC command-line options</A></H4>
3731
3721
 
3732
3722
<DL COMPACT>
3733
3723
 
3845
3835
 
3846
3836
 
3847
3837
 
3848
 
<H3><A NAME="SEC151" HREF="vice_toc.html#TOC151">7.4.4  Changing memory configuration</A></H3>
 
3838
<H3><A NAME="SEC152" HREF="vice_toc.html#TOC152">7.4.4  Changing memory configuration</A></H3>
3849
3839
 
3850
3840
<P>
3851
3841
It is possible to change the VIC20 memory configuration in two ways: by
3915
3905
 
3916
3906
 
3917
3907
 
3918
 
<H4><A NAME="SEC152" HREF="vice_toc.html#TOC152">7.4.4.1  VIC20 memory configuration resources</A></H4>
 
3908
<H4><A NAME="SEC153" HREF="vice_toc.html#TOC153">7.4.4.1  VIC20 memory configuration resources</A></H4>
3919
3909
 
3920
3910
<DL COMPACT>
3921
3911
 
3941
3931
 
3942
3932
 
3943
3933
 
3944
 
<H4><A NAME="SEC153" HREF="vice_toc.html#TOC153">7.4.4.2  VIC20 memory configuration command-line options</A></H4>
 
3934
<H4><A NAME="SEC154" HREF="vice_toc.html#TOC154">7.4.4.2  VIC20 memory configuration command-line options</A></H4>
3945
3935
 
3946
3936
<DL COMPACT>
3947
3937
 
4010
4000
 
4011
4001
 
4012
4002
 
4013
 
<H3><A NAME="SEC154" HREF="vice_toc.html#TOC154">7.4.5  VIC20 system ROM settings</A></H3>
 
4003
<H3><A NAME="SEC155" HREF="vice_toc.html#TOC155">7.4.5  VIC20 system ROM settings</A></H3>
4014
4004
 
4015
4005
<P>
4016
4006
These settings can be used to control what system ROMs are loaded in the
4020
4010
 
4021
4011
 
4022
4012
 
4023
 
<H4><A NAME="SEC155" HREF="vice_toc.html#TOC155">7.4.5.1  VIC20 system ROM resources</A></H4>
 
4013
<H4><A NAME="SEC156" HREF="vice_toc.html#TOC156">7.4.5.1  VIC20 system ROM resources</A></H4>
4024
4014
 
4025
4015
<DL COMPACT>
4026
4016
 
4045
4035
 
4046
4036
 
4047
4037
 
4048
 
<H4><A NAME="SEC156" HREF="vice_toc.html#TOC156">7.4.5.2  VIC20 system ROM command-line options</A></H4>
 
4038
<H4><A NAME="SEC157" HREF="vice_toc.html#TOC157">7.4.5.2  VIC20 system ROM command-line options</A></H4>
4049
4039
 
4050
4040
<DL COMPACT>
4051
4041
 
4088
4078
 
4089
4079
 
4090
4080
 
4091
 
<H3><A NAME="SEC157" HREF="vice_toc.html#TOC157">7.4.6  VIC20 settings</A></H3>
4092
 
 
4093
 
 
4094
 
 
4095
 
<H4><A NAME="SEC158" HREF="vice_toc.html#TOC158">7.4.6.1  VIC20 command-line options</A></H4>
 
4081
<H3><A NAME="SEC158" HREF="vice_toc.html#TOC158">7.4.6  VIC20 settings</A></H3>
 
4082
 
 
4083
 
 
4084
 
 
4085
<H4><A NAME="SEC159" HREF="vice_toc.html#TOC159">7.4.6.1  VIC20 command-line options</A></H4>
4096
4086
 
4097
4087
<DL COMPACT>
4098
4088
 
4108
4098
 
4109
4099
 
4110
4100
 
4111
 
<H2><A NAME="SEC159" HREF="vice_toc.html#TOC159">7.5  PLUS4-specific commands and settings</A></H2>
4112
 
 
4113
 
 
4114
 
 
4115
 
<H3><A NAME="SEC160" HREF="vice_toc.html#TOC160">7.5.1  TED settings</A></H3>
4116
 
 
4117
 
 
4118
 
 
4119
 
<H4><A NAME="SEC161" HREF="vice_toc.html#TOC161">7.5.1.1  TED resources</A></H4>
 
4101
<H2><A NAME="SEC160" HREF="vice_toc.html#TOC160">7.5  PLUS4-specific commands and settings</A></H2>
 
4102
 
 
4103
 
 
4104
 
 
4105
<H3><A NAME="SEC161" HREF="vice_toc.html#TOC161">7.5.1  TED settings</A></H3>
 
4106
 
 
4107
 
 
4108
 
 
4109
<H4><A NAME="SEC162" HREF="vice_toc.html#TOC162">7.5.1.1  TED resources</A></H4>
4120
4110
 
4121
4111
<DL COMPACT>
4122
4112
 
4241
4231
 
4242
4232
 
4243
4233
 
4244
 
<H4><A NAME="SEC162" HREF="vice_toc.html#TOC162">7.5.1.2  TED command-line options</A></H4>
 
4234
<H4><A NAME="SEC163" HREF="vice_toc.html#TOC163">7.5.1.2  TED command-line options</A></H4>
4245
4235
 
4246
4236
<DL COMPACT>
4247
4237
 
4351
4341
 
4352
4342
 
4353
4343
 
4354
 
<H3><A NAME="SEC163" HREF="vice_toc.html#TOC163">7.5.2  PLUS4 I/O extension settings</A></H3>
4355
 
 
4356
 
 
4357
 
 
4358
 
<H4><A NAME="SEC164" HREF="vice_toc.html#TOC164">7.5.2.1  PLUS4 I/O extension resources</A></H4>
 
4344
<H3><A NAME="SEC164" HREF="vice_toc.html#TOC164">7.5.2  PLUS4 I/O extension settings</A></H3>
 
4345
 
 
4346
 
 
4347
 
 
4348
<H4><A NAME="SEC165" HREF="vice_toc.html#TOC165">7.5.2.1  PLUS4 I/O extension resources</A></H4>
4359
4349
 
4360
4350
<DL COMPACT>
4361
4351
 
4401
4391
 
4402
4392
 
4403
4393
 
4404
 
<H4><A NAME="SEC165" HREF="vice_toc.html#TOC165">7.5.2.2  PLUS4 I/O extension command-line options</A></H4>
 
4394
<H4><A NAME="SEC166" HREF="vice_toc.html#TOC166">7.5.2.2  PLUS4 I/O extension command-line options</A></H4>
4405
4395
 
4406
4396
<DL COMPACT>
4407
4397
 
4458
4448
 
4459
4449
 
4460
4450
 
4461
 
<H3><A NAME="SEC166" HREF="vice_toc.html#TOC166">7.5.3  PLUS4 system ROM settings</A></H3>
4462
 
 
4463
 
 
4464
 
 
4465
 
<H4><A NAME="SEC167" HREF="vice_toc.html#TOC167">7.5.3.1  PLUS4 system ROM resources</A></H4>
 
4451
<H3><A NAME="SEC167" HREF="vice_toc.html#TOC167">7.5.3  PLUS4 system ROM settings</A></H3>
 
4452
 
 
4453
 
 
4454
 
 
4455
<H4><A NAME="SEC168" HREF="vice_toc.html#TOC168">7.5.3.1  PLUS4 system ROM resources</A></H4>
4466
4456
 
4467
4457
<DL COMPACT>
4468
4458
 
4497
4487
 
4498
4488
 
4499
4489
 
4500
 
<H4><A NAME="SEC168" HREF="vice_toc.html#TOC168">7.5.3.2  PLUS4 system ROM command-line options</A></H4>
 
4490
<H4><A NAME="SEC169" HREF="vice_toc.html#TOC169">7.5.3.2  PLUS4 system ROM command-line options</A></H4>
4501
4491
 
4502
4492
<DL COMPACT>
4503
4493
 
4532
4522
 
4533
4523
 
4534
4524
 
4535
 
<H3><A NAME="SEC169" HREF="vice_toc.html#TOC169">7.5.4  PLUS4 settings</A></H3>
4536
 
 
4537
 
 
4538
 
 
4539
 
<H4><A NAME="SEC170" HREF="vice_toc.html#TOC170">7.5.4.1  PLUS4 resources</A></H4>
 
4525
<H3><A NAME="SEC170" HREF="vice_toc.html#TOC170">7.5.4  PLUS4 settings</A></H3>
 
4526
 
 
4527
 
 
4528
 
 
4529
<H4><A NAME="SEC171" HREF="vice_toc.html#TOC171">7.5.4.1  PLUS4 resources</A></H4>
4540
4530
 
4541
4531
<DL COMPACT>
4542
4532
 
4561
4551
 
4562
4552
 
4563
4553
 
4564
 
<H4><A NAME="SEC171" HREF="vice_toc.html#TOC171">7.5.4.2  PLUS4 command-line options</A></H4>
 
4554
<H4><A NAME="SEC172" HREF="vice_toc.html#TOC172">7.5.4.2  PLUS4 command-line options</A></H4>
4565
4555
 
4566
4556
<DL COMPACT>
4567
4557
 
4599
4589
 
4600
4590
 
4601
4591
 
4602
 
<H2><A NAME="SEC172" HREF="vice_toc.html#TOC172">7.6  PET-specific commands and settings</A></H2>
 
4592
<H2><A NAME="SEC173" HREF="vice_toc.html#TOC173">7.6  PET-specific commands and settings</A></H2>
4603
4593
 
4604
4594
<P>
4605
4595
This section lists the settings and commands that are PET-specific and
4609
4599
 
4610
4600
 
4611
4601
 
4612
 
<H3><A NAME="SEC173" HREF="vice_toc.html#TOC173">7.6.1  Changing PET model settings</A></H3>
 
4602
<H3><A NAME="SEC174" HREF="vice_toc.html#TOC174">7.6.1  Changing PET model settings</A></H3>
4613
4603
 
4614
4604
<P>
4615
4605
With <CODE>xpet</CODE>, it is possible to change at runtime the
4779
4769
</P>
4780
4770
 
4781
4771
 
4782
 
<H3><A NAME="SEC174" HREF="vice_toc.html#TOC174">7.6.2  CRTC Settings</A></H3>
4783
 
 
4784
 
 
4785
 
 
4786
 
<H4><A NAME="SEC175" HREF="vice_toc.html#TOC175">7.6.2.1  CRTC resources</A></H4>
 
4772
<H3><A NAME="SEC175" HREF="vice_toc.html#TOC175">7.6.2  CRTC Settings</A></H3>
 
4773
 
 
4774
 
 
4775
 
 
4776
<H4><A NAME="SEC176" HREF="vice_toc.html#TOC176">7.6.2.1  CRTC resources</A></H4>
4787
4777
 
4788
4778
<DL COMPACT>
4789
4779
 
4913
4903
 
4914
4904
 
4915
4905
 
4916
 
<H4><A NAME="SEC176" HREF="vice_toc.html#TOC176">7.6.2.2  CRTC command-line options</A></H4>
 
4906
<H4><A NAME="SEC177" HREF="vice_toc.html#TOC177">7.6.2.2  CRTC command-line options</A></H4>
4917
4907
 
4918
4908
<DL COMPACT>
4919
4909
 
5025
5015
 
5026
5016
 
5027
5017
 
5028
 
<H3><A NAME="SEC177" HREF="vice_toc.html#TOC177">7.6.3  PET I/O extension settings</A></H3>
5029
 
 
5030
 
 
5031
 
 
5032
 
<H4><A NAME="SEC178" HREF="vice_toc.html#TOC178">7.6.3.1  PET I/O extension resources</A></H4>
 
5018
<H3><A NAME="SEC178" HREF="vice_toc.html#TOC178">7.6.3  PET I/O extension settings</A></H3>
 
5019
 
 
5020
 
 
5021
 
 
5022
<H4><A NAME="SEC179" HREF="vice_toc.html#TOC179">7.6.3.1  PET I/O extension resources</A></H4>
5033
5023
 
5034
5024
<DL COMPACT>
5035
5025
 
5078
5068
 
5079
5069
 
5080
5070
 
5081
 
<H4><A NAME="SEC179" HREF="vice_toc.html#TOC179">7.6.3.2  PET I/O extension command-line options</A></H4>
 
5071
<H4><A NAME="SEC180" HREF="vice_toc.html#TOC180">7.6.3.2  PET I/O extension command-line options</A></H4>
5082
5072
 
5083
5073
<DL COMPACT>
5084
5074
 
5126
5116
 
5127
5117
 
5128
5118
 
5129
 
<H3><A NAME="SEC180" HREF="vice_toc.html#TOC180">7.6.4  PET system ROM settings</A></H3>
5130
 
 
5131
 
 
5132
 
 
5133
 
<H4><A NAME="SEC181" HREF="vice_toc.html#TOC181">7.6.4.1  PET system ROM resources</A></H4>
 
5119
<H3><A NAME="SEC181" HREF="vice_toc.html#TOC181">7.6.4  PET system ROM settings</A></H3>
 
5120
 
 
5121
 
 
5122
 
 
5123
<H4><A NAME="SEC182" HREF="vice_toc.html#TOC182">7.6.4.1  PET system ROM resources</A></H4>
5134
5124
 
5135
5125
<DL COMPACT>
5136
5126
 
5160
5150
 
5161
5151
 
5162
5152
 
5163
 
<H4><A NAME="SEC182" HREF="vice_toc.html#TOC182">7.6.4.2  PET system ROM command-line options</A></H4>
 
5153
<H4><A NAME="SEC183" HREF="vice_toc.html#TOC183">7.6.4.2  PET system ROM command-line options</A></H4>
5164
5154
 
5165
5155
<DL COMPACT>
5166
5156
 
5219
5209
 
5220
5210
 
5221
5211
 
5222
 
<H3><A NAME="SEC183" HREF="vice_toc.html#TOC183">7.6.5  The PET diagnostic pin</A></H3>
 
5212
<H3><A NAME="SEC184" HREF="vice_toc.html#TOC184">7.6.5  The PET diagnostic pin</A></H3>
5223
5213
 
5224
5214
<P>
5225
5215
It is possible to enable or disable emulation of the PET diagnostic pin
5234
5224
</P>
5235
5225
 
5236
5226
 
5237
 
<H3><A NAME="SEC184" HREF="vice_toc.html#TOC184">7.6.6  PET settings</A></H3>
5238
 
 
5239
 
 
5240
 
 
5241
 
<H4><A NAME="SEC185" HREF="vice_toc.html#TOC185">7.6.6.1  PET resources</A></H4>
 
5227
<H3><A NAME="SEC185" HREF="vice_toc.html#TOC185">7.6.6  PET settings</A></H3>
 
5228
 
 
5229
 
 
5230
 
 
5231
<H4><A NAME="SEC186" HREF="vice_toc.html#TOC186">7.6.6.1  PET resources</A></H4>
5242
5232
 
5243
5233
<DL COMPACT>
5244
5234
 
5252
5242
 
5253
5243
 
5254
5244
 
5255
 
<H4><A NAME="SEC186" HREF="vice_toc.html#TOC186">7.6.6.2  PET command line options</A></H4>
 
5245
<H4><A NAME="SEC187" HREF="vice_toc.html#TOC187">7.6.6.2  PET command line options</A></H4>
5256
5246
 
5257
5247
<P>
5258
5248
These are the commandline options specific for the CBM-II models.
5326
5316
 
5327
5317
 
5328
5318
 
5329
 
<H3><A NAME="SEC187" HREF="vice_toc.html#TOC187">7.6.7  Changing screen colors</A></H3>
 
5319
<H3><A NAME="SEC188" HREF="vice_toc.html#TOC188">7.6.7  Changing screen colors</A></H3>
5330
5320
 
5331
5321
<P>
5332
5322
It is also possible to choose what color set is used for the emulation
5333
 
window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC27">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
 
5323
window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC28">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
5334
5324
following values:
5335
5325
 
5336
5326
</P>
5350
5340
 
5351
5341
 
5352
5342
 
5353
 
<H2><A NAME="SEC188" HREF="vice_toc.html#TOC188">7.7  CBM-II-specific commands and settings</A></H2>
 
5343
<H2><A NAME="SEC189" HREF="vice_toc.html#TOC189">7.7  CBM-II-specific commands and settings</A></H2>
5354
5344
 
5355
5345
<P>
5356
5346
This section lists the settings and commands that are CBM-II-specific and
5360
5350
 
5361
5351
 
5362
5352
 
5363
 
<H3><A NAME="SEC189" HREF="vice_toc.html#TOC189">7.7.1  Changing CBM-II model</A></H3>
 
5353
<H3><A NAME="SEC190" HREF="vice_toc.html#TOC190">7.7.1  Changing CBM-II model</A></H3>
5364
5354
 
5365
5355
<P>
5366
5356
With <CODE>xcbm2</CODE> and <CODE>xcbm5x0</CODE>, it is possible to change at runtime the
5479
5469
</P>
5480
5470
 
5481
5471
 
5482
 
<H3><A NAME="SEC190" HREF="vice_toc.html#TOC190">7.7.2  CBM-II system ROM settings</A></H3>
5483
 
 
5484
 
 
5485
 
 
5486
 
<H4><A NAME="SEC191" HREF="vice_toc.html#TOC191">7.7.2.1  CBM-II system ROM resources</A></H4>
5487
 
 
5488
 
 
5489
 
 
5490
 
<H4><A NAME="SEC192" HREF="vice_toc.html#TOC192">7.7.2.2  CBM-II system ROM command line options</A></H4>
 
5472
<H3><A NAME="SEC191" HREF="vice_toc.html#TOC191">7.7.2  CBM-II system ROM settings</A></H3>
 
5473
 
 
5474
 
 
5475
 
 
5476
<H4><A NAME="SEC192" HREF="vice_toc.html#TOC192">7.7.2.1  CBM-II system ROM resources</A></H4>
 
5477
 
 
5478
 
 
5479
 
 
5480
<H4><A NAME="SEC193" HREF="vice_toc.html#TOC193">7.7.2.2  CBM-II system ROM command line options</A></H4>
5491
5481
 
5492
5482
<DL COMPACT>
5493
5483
 
5532
5522
 
5533
5523
 
5534
5524
 
5535
 
<H3><A NAME="SEC193" HREF="vice_toc.html#TOC193">7.7.3  CBM-II command line options</A></H3>
 
5525
<H3><A NAME="SEC194" HREF="vice_toc.html#TOC194">7.7.3  CBM-II command line options</A></H3>
5536
5526
 
5537
5527
<P>
5538
5528
These are the commandline options specific for the CBM-II models.
5598
5588
 
5599
5589
 
5600
5590
 
5601
 
<H3><A NAME="SEC194" HREF="vice_toc.html#TOC194">7.7.4  Changing screen colors</A></H3>
 
5591
<H3><A NAME="SEC195" HREF="vice_toc.html#TOC195">7.7.4  Changing screen colors</A></H3>
5602
5592
 
5603
5593
<P>
5604
5594
It is also possible to choose what color set is used for the emulation
5605
 
window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC27">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
 
5595
window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC28">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
5606
5596
following values:
5607
5597
 
5608
5598
</P>
5622
5612
 
5623
5613
 
5624
5614
 
5625
 
<H2><A NAME="SEC195" HREF="vice_toc.html#TOC195">7.8  VSID-specific commands and settings</A></H2>
5626
 
 
5627
 
 
5628
 
 
5629
 
<H3><A NAME="SEC196" HREF="vice_toc.html#TOC196">7.8.1  VSID settings</A></H3>
5630
 
 
5631
 
 
5632
 
 
5633
 
<H4><A NAME="SEC197" HREF="vice_toc.html#TOC197">7.8.1.1  VSID resources</A></H4>
 
5615
<H2><A NAME="SEC196" HREF="vice_toc.html#TOC196">7.8  VSID-specific commands and settings</A></H2>
 
5616
 
 
5617
 
 
5618
 
 
5619
<H3><A NAME="SEC197" HREF="vice_toc.html#TOC197">7.8.1  VSID settings</A></H3>
 
5620
 
 
5621
 
 
5622
 
 
5623
<H4><A NAME="SEC198" HREF="vice_toc.html#TOC198">7.8.1.1  VSID resources</A></H4>
5634
5624
 
5635
5625
<DL COMPACT>
5636
5626
 
5650
5640
 
5651
5641
 
5652
5642
 
5653
 
<H4><A NAME="SEC198" HREF="vice_toc.html#TOC198">7.8.1.2  VSID command-line options</A></H4>
 
5643
<H4><A NAME="SEC199" HREF="vice_toc.html#TOC199">7.8.1.2  VSID command-line options</A></H4>
5654
5644
 
5655
5645
<DL COMPACT>
5656
5646