← Back to branch summary

~ubuntu-branches/ubuntu/quantal/vice/quantal

« back to all changes in this revision

Viewing changes to doc/html/vice_7.html

  • Committer: Bazaar Package Importer
  • Author(s): Laszlo Boszormenyi (GCS)
  • Date: 2009-03-31 00:37:15 UTC
  • mfrom: (1.1.7 upstream) (9.1.2 sid)
  • Revision ID: james.westby@ubuntu.com-20090331003715-i5yisvcfv7mgz3eh
Tags: 2.1.dfsg-1
http://bugs.debian.org/495937
http://bugs.debian.org/501181
* New major upstream release (closes: #495937).
* Add desktop files (closes: #501181).

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 ../vice.texi on 5 August 2007 -->
 
4
     from ../vice.texi on 15 December 2008 -->
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="SEC74" HREF="vice_toc.html#TOC74">7  Machine-specific features</A></H1>
14
 
 
15
 
 
16
 
 
17
 
<H2><A NAME="SEC75" HREF="vice_toc.html#TOC75">7.1  C64/128-specific commands and settings</A></H2>
 
13
<H1><A NAME="SEC77" HREF="vice_toc.html#TOC77">7  Machine-specific features</A></H1>
 
14
 
 
15
 
 
16
 
 
17
<H2><A NAME="SEC78" HREF="vice_toc.html#TOC78">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="SEC76" HREF="vice_toc.html#TOC76">7.1.1  Using cartridge images</A></H3>
 
27
<H3><A NAME="SEC79" HREF="vice_toc.html#TOC79">7.1.1  Using cartridge images</A></H3>
28
28
 
29
29
<P>
30
30
<EM>Cartridge images</EM> are like disk images, but mirror the contents of
100
100
</P>
101
101
 
102
102
 
103
 
<H3><A NAME="SEC77" HREF="vice_toc.html#TOC77">7.1.2  VIC-II settings</A></H3>
 
103
<H3><A NAME="SEC80" HREF="vice_toc.html#TOC80">7.1.2  VIC-II settings</A></H3>
104
104
 
105
105
<P>
106
106
These settings control the emulation of the VIC-II (MOS6569) video chip
112
112
 
113
113
<LI>
114
114
 
115
 
<A NAME="IDX182"></A>
 
115
<A NAME="IDX183"></A>
116
116
 
117
117
"Sprite-sprite collisions" and "Sprite-background collisions", if
118
118
enabled, cause the hardware detection of sprite-to-sprite and
121
121
systems can sometimes make you invincible (although there is also a
122
122
chance that also enemies become invincible then).
123
123
 
124
 
<A NAME="IDX183"></A>
 
124
<A NAME="IDX184"></A>
125
125
<LI>
126
126
 
127
127
"Color set" can be used to dynamically change the palette file
160
160
 
161
161
 
162
162
 
163
 
<H4><A NAME="SEC78" HREF="vice_toc.html#TOC78">7.1.2.1  VIC-II resources</A></H4>
 
163
<H4><A NAME="SEC81" HREF="vice_toc.html#TOC81">7.1.2.1  VIC-II resources</A></H4>
164
164
 
165
165
<DL COMPACT>
166
166
 
167
167
<DT><CODE>CheckSsColl</CODE>
168
168
<DD>
169
 
<A NAME="IDX184"></A>
 
169
<A NAME="IDX185"></A>
170
170
 
171
171
Boolean specifying whether the sprite-sprite hardware collision
172
172
detection must be emulated.
173
173
 
174
 
<A NAME="IDX185"></A>
 
174
<A NAME="IDX186"></A>
175
175
<DT><CODE>CheckSbColl</CODE>
176
176
<DD>
177
177
Boolean specifying whether the sprite-background hardware collision
181
181
 
182
182
 
183
183
 
184
 
<H4><A NAME="SEC79" HREF="vice_toc.html#TOC79">7.1.2.2  VIC-II command-line options</A></H4>
 
184
<H4><A NAME="SEC82" HREF="vice_toc.html#TOC82">7.1.2.2  VIC-II command-line options</A></H4>
185
185
 
186
186
<DL COMPACT>
187
187
 
188
188
<DT><CODE>-checkss</CODE>
189
189
<DD>
190
 
<A NAME="IDX186"></A>
 
190
<A NAME="IDX187"></A>
191
191
 
192
192
<DT><CODE>+checkss</CODE>
193
193
<DD>
194
194
Enable (<CODE>CheckSsColl=1</CODE>) and disable (<CODE>CheckSsColl=0</CODE>)
195
195
emulation of hardware sprite-sprite collision detection, respectively.
196
 
<A NAME="IDX187"></A>
197
 
 
198
196
<A NAME="IDX188"></A>
 
197
 
 
198
<A NAME="IDX189"></A>
199
199
<DT><CODE>-checksb</CODE>
200
200
<DD>
201
201
<DT><CODE>+checksb</CODE>
208
208
 
209
209
 
210
210
 
211
 
<H3><A NAME="SEC80" HREF="vice_toc.html#TOC80">7.1.3  SID settings</A></H3>
 
211
<H3><A NAME="SEC83" HREF="vice_toc.html#TOC83">7.1.3  SID settings</A></H3>
212
212
 
213
213
<P>
214
214
These settings control the emulation of the SID (MOS6581 or MOS8580)
220
220
 
221
221
<LI>
222
222
 
223
 
<A NAME="IDX189"></A>
 
223
<A NAME="IDX190"></A>
224
224
 
225
225
"Second SID" maps a second SID chip into the address space for stereo
226
226
sound. This emulates e.g. the "SID Symphony Stereo Cartridge" from
228
228
"Stereo SID Player" by Mark Dickenson or "The Enhanced Sidplayer" by
229
229
Craig Chamberlain.
230
230
 
231
 
<A NAME="IDX190"></A>
 
231
<A NAME="IDX191"></A>
232
232
<LI>
233
233
 
234
234
"Second SID base address" sets the start address for the second SID
236
236
$DF00-$DFFF can be mapped through the cartridge port of the C64. The
237
237
default start address is $DE00.
238
238
 
239
 
<A NAME="IDX191"></A>
 
239
<A NAME="IDX192"></A>
240
240
<LI>
241
241
 
242
242
"Emulate filters" causes the built-in programmable filters of the SID
243
243
chip to be emulated.  A lot of C64 music requires them to be emulated
244
244
properly, but their emulation requires some additional processor power.
245
245
 
246
 
<A NAME="IDX192"></A>
 
246
<A NAME="IDX193"></A>
247
247
<LI>
248
248
 
249
249
"ChipModel" specifies the model of the SID chip being emulated: there
250
250
are two slightly different generations of SID chips: MOS6581 ones and
251
251
MOS8580 ones.
252
252
 
253
 
<A NAME="IDX193"></A>
 
253
<A NAME="IDX194"></A>
254
254
<LI>
255
255
 
256
256
"Use reSID emulation" specifies whether the more accurate (and
257
257
resource hungry) reSID emulation is turned on or off.
258
258
 
259
 
<A NAME="IDX194"></A>
 
259
<A NAME="IDX195"></A>
260
260
<LI>
261
261
 
262
262
"reSID sampling method" selects the method for conversion of the SID
286
286
machine, that is.
287
287
</UL>
288
288
 
289
 
<A NAME="IDX195"></A>
 
289
<A NAME="IDX196"></A>
290
290
<LI>"reSID resampling passband" specifies the percentage of the
291
291
 
292
292
total bandwidth allocated to the resampling filter passband. The work
301
301
 
302
302
 
303
303
 
304
 
<H4><A NAME="SEC81" HREF="vice_toc.html#TOC81">7.1.3.1  SID resources</A></H4>
 
304
<H4><A NAME="SEC84" HREF="vice_toc.html#TOC84">7.1.3.1  SID resources</A></H4>
305
305
 
306
306
<DL COMPACT>
307
307
 
308
308
<DT><CODE>SidStereo</CODE>
309
309
<DD>
310
 
<A NAME="IDX196"></A>
 
310
<A NAME="IDX197"></A>
311
311
 
312
312
Boolean selecting emulation of a second SID.
313
313
 
314
 
<A NAME="IDX197"></A>
 
314
<A NAME="IDX198"></A>
315
315
<DT><CODE>SidStereoAddressStart</CODE>
316
316
<DD>
317
317
Integer specifying the start address for the second SID.
318
318
 
319
 
<A NAME="IDX198"></A>
 
319
<A NAME="IDX199"></A>
320
320
<DT><CODE>SidFilters</CODE>
321
321
<DD>
322
322
Boolean specifying whether the built-in SID filters must be emulated.
323
323
 
324
 
<A NAME="IDX199"></A>
 
324
<A NAME="IDX200"></A>
325
325
<DT><CODE>SidModel</CODE>
326
326
<DD>
327
327
Integer specifying what model of the SID must be emulated (<CODE>0</CODE>:
328
328
MOS6581, <CODE>1</CODE>: MOS8580).
329
329
 
330
 
<A NAME="IDX200"></A>
 
330
<A NAME="IDX201"></A>
331
331
<DT><CODE>SidUseResid</CODE>
332
332
<DD>
333
333
Boolean specifying whether the accurate reSID emulation is being used.
334
334
 
335
 
<A NAME="IDX201"></A>
 
335
<A NAME="IDX202"></A>
336
336
<DT><CODE>SidResidSampling</CODE>
337
337
<DD>
338
338
Integer specifying the sampling method (<CODE>0</CODE>: Fast, <CODE>1</CODE>:
339
339
Interpolation, <CODE>2</CODE>: Resampling)
340
340
 
341
 
<A NAME="IDX202"></A>
 
341
<A NAME="IDX203"></A>
342
342
<DT><CODE>SidResidPassband</CODE>
343
343
<DD>
344
344
Integer specifying the resampling filter passband in percentage of the
348
348
 
349
349
 
350
350
 
351
 
<H4><A NAME="SEC82" HREF="vice_toc.html#TOC82">7.1.3.2  SID command-line options</A></H4>
 
351
<H4><A NAME="SEC85" HREF="vice_toc.html#TOC85">7.1.3.2  SID command-line options</A></H4>
352
352
 
353
353
<DL COMPACT>
354
354
 
355
355
<DT><CODE>-sidstereo</CODE>
356
356
<DD>
357
 
<A NAME="IDX203"></A>
 
357
<A NAME="IDX204"></A>
358
358
 
359
359
Emulates a second SID chip for stereo sound (<CODE>SidStereo</CODE>).
360
360
 
361
 
<A NAME="IDX204"></A>
 
361
<A NAME="IDX205"></A>
362
362
<DT><CODE>-sidstereoaddress <CODE>ADDRESS</CODE></CODE>
363
363
<DD>
364
364
Specifies the start address for the second SID chip
365
365
(<CODE>SidStereoAddressStart</CODE>).
366
366
 
367
 
<A NAME="IDX205"></A>
 
367
<A NAME="IDX206"></A>
368
368
<DT><CODE>-sidmodel MODEL</CODE>
369
369
<DD>
370
370
Specifies <CODE>MODEL</CODE> as the emulated model of the SID chip
371
371
(<CODE>SidModel</CODE>).
372
372
 
373
 
<A NAME="IDX206"></A>
 
373
<A NAME="IDX207"></A>
374
374
<DT><CODE>-sidfilters</CODE>
375
375
<DD>
376
376
<DT><CODE>+sidfilters</CODE>
378
378
Enable (<CODE>SidFilters=1</CODE>) or disable (<CODE>SidFilters=0</CODE>) emulation
379
379
of the built-in SID filters.
380
380
 
381
 
<A NAME="IDX207"></A>
 
381
<A NAME="IDX208"></A>
382
382
<DT><CODE>-resid</CODE>
383
383
<DD>
384
384
<DT><CODE>+resid</CODE>
386
386
Enable (<CODE>SidFilters=1</CODE>) or disable (<CODE>SidFilters=0</CODE>) usage of
387
387
the reSID emulator.
388
388
 
389
 
<A NAME="IDX208"></A>
 
389
<A NAME="IDX209"></A>
390
390
<DT><CODE>-residsamp <CODE>METHOD</CODE></CODE>
391
391
<DD>
392
392
Specifies the sampling method; fast (<CODE>SidResidSampling=0</CODE>),
393
393
interpolating (<CODE>SidResidSampling=1</CODE>), or resampling
394
394
(<CODE>SidResidSampling=2</CODE>).
395
395
 
396
 
<A NAME="IDX209"></A>
 
396
<A NAME="IDX210"></A>
397
397
<DT><CODE>-residpass <CODE>PERCENTAGE</CODE></CODE>
398
398
<DD>
399
399
Specifies the resampling filter passband in percentage of the total
403
403
 
404
404
 
405
405
 
406
 
<H3><A NAME="SEC83" HREF="vice_toc.html#TOC83">7.1.4  C64 I/O extension settings</A></H3>
 
406
<H3><A NAME="SEC86" HREF="vice_toc.html#TOC86">7.1.4  C64 I/O extension settings</A></H3>
407
407
 
408
408
<P>
409
409
There are three I/O extensions available: they are located at the
417
417
 
418
418
<LI>
419
419
 
420
 
<A NAME="IDX210"></A>
 
420
<A NAME="IDX211"></A>
421
421
 
422
422
The "emulator identification" extension allows programs to
423
423
identify the kind of emulator they are running on, according to the
427
427
a copyright message.  If this extension is disabled, programs will have
428
428
virtually no way to realize they are running on an emulator.
429
429
 
430
 
<A NAME="IDX211"></A>
 
430
<A NAME="IDX212"></A>
431
431
<LI>
432
432
 
433
433
The "512K RAM Expansion Unit" extension emulates a standard 512K
435
435
programs that are designed to take advantage of it.  This currently
436
436
works only in the C64 emulator.
437
437
 
438
 
<A NAME="IDX212"></A>
 
438
<A NAME="IDX213"></A>
439
439
<LI>FIXME
440
440
 
441
441
</UL>
442
442
 
443
443
 
444
444
 
445
 
<H4><A NAME="SEC84" HREF="vice_toc.html#TOC84">7.1.4.1  C64 I/O extension resources</A></H4>
 
445
<H4><A NAME="SEC87" HREF="vice_toc.html#TOC87">7.1.4.1  C64 I/O extension resources</A></H4>
446
446
 
447
447
<DL COMPACT>
448
448
 
449
449
<DT><CODE>IEEE488</CODE>
450
450
<DD>
451
 
<A NAME="IDX213"></A>
 
451
<A NAME="IDX214"></A>
452
452
 
453
453
Boolean specifying whether the IEEE488 interface should
454
454
be emulated or not.
455
455
 
456
 
<A NAME="IDX214"></A>
 
456
<A NAME="IDX215"></A>
457
457
<DT><CODE>REU</CODE>
458
458
<DD>
459
459
Boolean specifying whether the 512K RAM Expansion Unit should be
460
460
emulated or not.
461
461
 
462
 
<A NAME="IDX215"></A>
 
462
<A NAME="IDX216"></A>
463
463
<DT><CODE>EmuID</CODE>
464
464
<DD>
465
465
Boolean specifying whether the emulation identification extension should
469
469
 
470
470
 
471
471
 
472
 
<H4><A NAME="SEC85" HREF="vice_toc.html#TOC85">7.1.4.2  C64 I/O extension command-line options</A></H4>
 
472
<H4><A NAME="SEC88" HREF="vice_toc.html#TOC88">7.1.4.2  C64 I/O extension command-line options</A></H4>
473
473
 
474
474
<DL COMPACT>
475
475
 
476
476
<DT><CODE>-ieee488</CODE>
477
477
<DD>
478
 
<A NAME="IDX216"></A>
 
478
<A NAME="IDX217"></A>
479
479
 
480
480
<DT><CODE>+ieee488</CODE>
481
481
<DD>
482
482
Enable (<CODE>IEEE488=1</CODE>) or disable (<CODE>IEEE488=0</CODE>) emulation of the
483
483
IEEE488 interface.
484
484
 
485
 
<A NAME="IDX217"></A>
 
485
<A NAME="IDX218"></A>
486
486
<DT><CODE>-reu</CODE>
487
487
<DD>
488
488
<DT><CODE>+reu</CODE>
490
490
Enable (<CODE>REU=1</CODE>) or disable (<CODE>REU=0</CODE>) emulation of the
491
491
512K RAM Expansion Unit.
492
492
 
493
 
<A NAME="IDX218"></A>
 
493
<A NAME="IDX219"></A>
494
494
<DT><CODE>-emuid</CODE>
495
495
<DD>
496
496
<DT><CODE>+emuid</CODE>
502
502
 
503
503
 
504
504
 
505
 
<H3><A NAME="SEC86" HREF="vice_toc.html#TOC86">7.1.5  C64/128 system ROM settings</A></H3>
 
505
<H3><A NAME="SEC89" HREF="vice_toc.html#TOC89">7.1.5  C64/128 system ROM settings</A></H3>
506
506
 
507
507
<P>
508
508
These settings can be used to control what system ROMs are loaded in the
512
512
 
513
513
 
514
514
 
515
 
<H4><A NAME="SEC87" HREF="vice_toc.html#TOC87">7.1.5.1  C64/128 system ROM resources</A></H4>
 
515
<H4><A NAME="SEC90" HREF="vice_toc.html#TOC90">7.1.5.1  C64/128 system ROM resources</A></H4>
516
516
 
517
517
<DL COMPACT>
518
518
 
519
519
<DT><CODE>KernalName</CODE>
520
520
<DD>
521
 
<A NAME="IDX219"></A>
522
 
 
523
 
String specifying the name of the Kernal ROM (default <TT>`kernal'</TT>).
524
 
 
525
521
<A NAME="IDX220"></A>
 
522
 
 
523
String specifying the name of the Kernal ROM (default <TT>`kernal'</TT>).
 
524
 
 
525
<A NAME="IDX221"></A>
526
526
<DT><CODE>BasicName</CODE>
527
527
<DD>
528
528
String specifying the name of the Basic ROM (default <TT>`basic'</TT>).  In
529
529
the C128 emulator, the ROM image must actually include the editor ROM too.
530
530
 
531
 
<A NAME="IDX221"></A>
532
 
<DT><CODE>ChargenName</CODE>
533
 
<DD>
534
 
String specifying the name of the character generator ROM (default
535
 
<TT>`chargen'</TT>).
536
 
 
537
531
<A NAME="IDX222"></A>
 
532
<DT><CODE>ChargenName</CODE>
 
533
<DD>
 
534
String specifying the name of the character generator ROM (default
 
535
<TT>`chargen'</TT>).
 
536
 
 
537
<A NAME="IDX223"></A>
538
538
<DT><CODE>KernalRev</CODE>
539
539
<DD>
540
540
String specifying the Kernal revision.  This resource can be used to
568
568
 
569
569
 
570
570
 
571
 
<H4><A NAME="SEC88" HREF="vice_toc.html#TOC88">7.1.5.2  C64/128 system ROM command-line options</A></H4>
 
571
<H4><A NAME="SEC91" HREF="vice_toc.html#TOC91">7.1.5.2  C64/128 system ROM command-line options</A></H4>
572
572
 
573
573
<DL COMPACT>
574
574
 
575
575
<DT><CODE>-kernal NAME</CODE>
576
576
<DD>
577
 
<A NAME="IDX223"></A>
578
 
 
579
 
Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
580
 
 
581
577
<A NAME="IDX224"></A>
582
 
<DT><CODE>-basic NAME</CODE>
583
 
<DD>
584
 
Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
 
578
 
 
579
Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
585
580
 
586
581
<A NAME="IDX225"></A>
587
 
<DT><CODE>-chargen NAME</CODE>
 
582
<DT><CODE>-basic NAME</CODE>
588
583
<DD>
589
 
Specify <TT>`NAME'</TT> as the character generator ROM file
590
 
(<CODE>ChargenName</CODE>).
 
584
Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
591
585
 
592
586
<A NAME="IDX226"></A>
 
587
<DT><CODE>-chargen NAME</CODE>
 
588
<DD>
 
589
Specify <TT>`NAME'</TT> as the character generator ROM file
 
590
(<CODE>ChargenName</CODE>).
 
591
 
 
592
<A NAME="IDX227"></A>
593
593
<DT><CODE>-kernalrev REVISION</CODE>
594
594
<DD>
595
595
Specify Kernal revision (<CODE>KernalRev</CODE>).
598
598
 
599
599
 
600
600
 
601
 
<H2><A NAME="SEC89" HREF="vice_toc.html#TOC89">7.2  VIC20-specific commands and settings</A></H2>
 
601
<H2><A NAME="SEC92" HREF="vice_toc.html#TOC92">7.2  C64DTV-specific commands and settings</A></H2>
 
602
 
 
603
<P>
 
604
This section lists the settings and commands that are C64DTV specific
 
605
and thus are not present in the other emulators.
 
606
 
 
607
</P>
 
608
 
 
609
 
 
610
 
 
611
<H3><A NAME="SEC93" HREF="vice_toc.html#TOC93">7.2.1  C64DTV ROM image</A></H3>
 
612
 
 
613
<P>
 
614
The DTV has a 2MB Flash chip which contains the kernal, basic and
 
615
character set ROMs along with other data, such as games in the case of
 
616
the original C64DTV ROM.
 
617
 
 
618
</P>
 
619
<P>
 
620
The image file is a dump of the flash chip. It is exactly 2MB (2097152 bytes).
 
621
 
 
622
</P>
 
623
<P>
 
624
If you do not have a suitable image file, an image using the C64 kernal,
 
625
basic and charset is automatically created.
 
626
 
 
627
</P>
 
628
<P>
 
629
If writing to the C64DTV ROM is enabled, the image file is rewritten with
 
630
the current data when exiting x64dtv.
 
631
 
 
632
</P>
 
633
<P>
 
634
Note that x64dtv tries to load the image file from the C64DTV
 
635
directory first, and if it isn't found there, x64dtv tries to
 
636
load it from the current directory. If you do not have <TT>`dtvrom.bin'</TT>
 
637
in your C64DTV directory and writing to DTV ROM is enabled,
 
638
the <TT>`dtvrom.bin'</TT> file is created to the current directory.
 
639
 
 
640
</P>
 
641
<P>
 
642
NOTE: The original C64DTV ROM has somewhat distorted colors,
 
643
normally you should use a patched rom.
 
644
 
 
645
</P>
 
646
<DL COMPACT>
 
647
 
 
648
<DT><CODE>-c64dtvromimage NAME</CODE>
 
649
<DD>
 
650
<A NAME="IDX228"></A>
 
651
 
 
652
Specify <TT>`NAME'</TT> as the C64DTV ROM image
 
653
 
 
654
<A NAME="IDX229"></A>
 
655
<DT><CODE>-c64dtvromrw</CODE>
 
656
<DD>
 
657
<DT><CODE>+c64dtvromrw</CODE>
 
658
<DD>
 
659
Enable or disable writing to C64DTV ROM image
 
660
 
 
661
</DL>
 
662
 
 
663
<P>
 
664
The trueflashfs option is analogous to True drive emulation.  If disabled,
 
665
any file access to the flash filesystem (device 1) will go to the local
 
666
file system instead.
 
667
 
 
668
</P>
 
669
<DL COMPACT>
 
670
 
 
671
<DT><CODE>-trueflashfs</CODE>
 
672
<DD>
 
673
<A NAME="IDX230"></A>
 
674
 
 
675
<DT><CODE>+trueflashfs</CODE>
 
676
<DD>
 
677
Enable or disable true hardware flash file system
 
678
 
 
679
<A NAME="IDX231"></A>
 
680
<DT><CODE>-fsflash NAME</CODE>
 
681
<DD>
 
682
Specify <TT>`NAME'</TT> as directory for flash file system device
 
683
 
 
684
</DL>
 
685
 
 
686
 
 
687
 
 
688
<H3><A NAME="SEC94" HREF="vice_toc.html#TOC94">7.2.2  DTV revision</A></H3>
 
689
 
 
690
<P>
 
691
The DTV revision 2 has a bug in the Blitter. Using revision 3
 
692
is recommended. Emulation of DTV revision 2 including Blitter
 
693
bug is intended for testing DTV software.
 
694
 
 
695
</P>
 
696
<DL COMPACT>
 
697
 
 
698
<DT><CODE>-dtvrev REVISION</CODE>
 
699
<DD>
 
700
<A NAME="IDX232"></A>
 
701
 
 
702
Specify DTV <TT>`REVISION'</TT> (2 or 3)
 
703
 
 
704
</DL>
 
705
 
 
706
 
 
707
 
 
708
<H3><A NAME="SEC95" HREF="vice_toc.html#TOC95">7.2.3  LumaFix</A></H3>
 
709
 
 
710
<P>
 
711
The PAL C64DTVs have wrong resistors in the video output circuit,
 
712
which causes incorrect luminances. Several hardware solutions
 
713
("LumaFixes") have been developed to fix this flaw.
 
714
 
 
715
</P>
 
716
<P>
 
717
The fixed video output is emulated by selecting "New Luminances".
 
718
The unmodified C64DTV video output can be emulated with "Old Luminances".
 
719
 
 
720
</P>
 
721
<P>
 
722
The default setting is "New Luminances".
 
723
 
 
724
</P>
 
725
 
 
726
 
 
727
 
 
728
<H3><A NAME="SEC96" HREF="vice_toc.html#TOC96">7.2.4  Userport</A></H3>
 
729
 
 
730
<P>
 
731
The C64DTV userport emulation currently supports three devices:
 
732
Hummer ADC, userport joystick and PS/2 mouse.
 
733
 
 
734
</P>
 
735
<P>
 
736
The joystick that controls either the Hummer ADC or userport joystick
 
737
can be selected using the same parameter or menu option.
 
738
 
 
739
</P>
 
740
<P>
 
741
While using the Hummer ADC, joystick UP and DOWN are mapped to
 
742
the Hummer buttons A and B respectively. LEFT and RIGHT set the ADCs
 
743
output to 0 and 255. Centering the joystick results in the ADC value of 128.
 
744
 
 
745
</P>
 
746
<P>
 
747
Currently the Hummer ADC and userport joystick are mutually exclusive.
 
748
This means that enabling one disables the other. PS/2 mouse emulation
 
749
can be used simultaneously with either Hummer ADC or userport joystick.
 
750
 
 
751
</P>
 
752
<DL COMPACT>
 
753
 
 
754
<DT><CODE>-hummerusrdev DEVICE</CODE>
 
755
<DD>
 
756
<A NAME="IDX233"></A>
 
757
 
 
758
Select Hummer Userport device (0: None, 1: ADC, 2: Joystick)
 
759
 
 
760
<A NAME="IDX234"></A>
 
761
<DT><CODE>-hummerusrjoyport PORT</CODE>
 
762
<DD>
 
763
Select which joystick port should be mapped to the userport
 
764
 
 
765
<A NAME="IDX235"></A>
 
766
<DT><CODE>-ps2mouse</CODE>
 
767
<DD>
 
768
<DT><CODE>+ps2mouse</CODE>
 
769
<DD>
 
770
Enable or disable PS/2 mouse on userport
 
771
 
 
772
</DL>
 
773
 
 
774
 
 
775
 
 
776
<H3><A NAME="SEC97" HREF="vice_toc.html#TOC97">7.2.5  Debug</A></H3>
 
777
 
 
778
<P>
 
779
Debugging information on Blitter, DMA and Flash can be enabled with command
 
780
line parameters. This can be useful for DTV software development.
 
781
 
 
782
</P>
 
783
<DL COMPACT>
 
784
 
 
785
<DT><CODE>-dtvblitterlog</CODE>
 
786
<DD>
 
787
<A NAME="IDX236"></A>
 
788
 
 
789
<DT><CODE>+dtvblitterlog</CODE>
 
790
<DD>
 
791
Enable or disable DTV Blitter log
 
792
 
 
793
<A NAME="IDX237"></A>
 
794
<DT><CODE>-dtvdmalog</CODE>
 
795
<DD>
 
796
<DT><CODE>+dtvdmalog</CODE>
 
797
<DD>
 
798
Enable or disable DTV DMA log
 
799
 
 
800
<A NAME="IDX238"></A>
 
801
<DT><CODE>-dtvflashlog</CODE>
 
802
<DD>
 
803
<DT><CODE>+dtvflashlog</CODE>
 
804
<DD>
 
805
Enable or disable DTV Flash log
 
806
 
 
807
</DL>
 
808
 
 
809
 
 
810
 
 
811
<H3><A NAME="SEC98" HREF="vice_toc.html#TOC98">7.2.6  Monitor DTV features</A></H3>
 
812
 
 
813
<P>
 
814
Currently the registers A, Y and X are registers R0, R1 and R2 regardless of
 
815
the mapping, which can be seen and modified via the registers ACM and XYM.
 
816
 
 
817
</P>
 
818
<P>
 
819
The monitor can access all 2MB of RAM and 2MB of Flash, but only 64 kB at a time.
 
820
The 64kB bank can be selected with "bank ram00".."ram1f" for RAM and
 
821
"bank rom00".."rom1f" for Flash.
 
822
 
 
823
</P>
 
824
<P>
 
825
The "load" command can load large files (&#62;64kB) correctly if the bank is set
 
826
to "ramXX", where XX is the starting bank (usually "bank00").
 
827
 
 
828
</P>
 
829
 
 
830
 
 
831
 
 
832
<H2><A NAME="SEC99" HREF="vice_toc.html#TOC99">7.3  VIC20-specific commands and settings</A></H2>
602
833
 
603
834
<P>
604
835
This section lists the settings and commands that are VIC20-specific and
608
839
 
609
840
 
610
841
 
611
 
<H3><A NAME="SEC90" HREF="vice_toc.html#TOC90">7.2.1  Using cartridge images</A></H3>
 
842
<H3><A NAME="SEC100" HREF="vice_toc.html#TOC100">7.3.1  Using cartridge images</A></H3>
612
843
 
613
844
<P>
614
 
As with the C64 (see section <A HREF="vice_7.html#SEC76">7.1.1  Using cartridge images</A>), it is possible to attach
 
845
As with the C64 (see section <A HREF="vice_7.html#SEC79">7.1.1  Using cartridge images</A>), it is possible to attach
615
846
several types of cartridge images:
616
847
 
617
848
</P>
668
899
</P>
669
900
 
670
901
 
671
 
<H3><A NAME="SEC91" HREF="vice_toc.html#TOC91">7.2.2  Changing memory configuration</A></H3>
 
902
<H3><A NAME="SEC101" HREF="vice_toc.html#TOC101">7.3.2  Changing memory configuration</A></H3>
672
903
 
673
904
<P>
674
905
It is possible to change the VIC20 memory configuration in two ways: by
737
968
</UL>
738
969
 
739
970
<P>
740
 
As with the X64 (see section <A HREF="vice_7.html#SEC83">7.1.4  C64 I/O extension settings</A>), it is also
 
971
As with the X64 (see section <A HREF="vice_7.html#SEC86">7.1.4  C64 I/O extension settings</A>), it is also
741
972
possible to enable a special emulator identification mechanism that uses
742
973
certain memory locations to let a running program query information
743
974
about the emulator itself; this is enabled by the "Emulator
747
978
 
748
979
 
749
980
 
750
 
<H4><A NAME="SEC92" HREF="vice_toc.html#TOC92">7.2.2.1  VIC20 memory configuration resources</A></H4>
 
981
<H4><A NAME="SEC102" HREF="vice_toc.html#TOC102">7.3.2.1  VIC20 memory configuration resources</A></H4>
751
982
 
752
983
<DL COMPACT>
753
984
 
754
985
<DT><CODE>RAMBlock0</CODE>
755
986
<DD>
756
 
<A NAME="IDX227"></A>
 
987
<A NAME="IDX239"></A>
757
988
 
758
 
<A NAME="IDX228"></A>
 
989
<A NAME="IDX240"></A>
759
990
<DT><CODE>RAMBlock1</CODE>
760
991
<DD>
761
 
<A NAME="IDX229"></A>
 
992
<A NAME="IDX241"></A>
762
993
<DT><CODE>RAMBlock2</CODE>
763
994
<DD>
764
 
<A NAME="IDX230"></A>
 
995
<A NAME="IDX242"></A>
765
996
<DT><CODE>RAMBlock3</CODE>
766
997
<DD>
767
 
<A NAME="IDX231"></A>
 
998
<A NAME="IDX243"></A>
768
999
<DT><CODE>RAMBlock5</CODE>
769
1000
<DD>
770
1001
Booleans specifying whether RAM blocks 0, 1, 2, 3 and 5 must be enabled.
771
1002
 
772
 
<A NAME="IDX232"></A>
 
1003
<A NAME="IDX244"></A>
773
1004
<DT><CODE>EmuID</CODE>
774
1005
<DD>
775
1006
Boolean specifying whether the emulation identification extension must
779
1010
 
780
1011
 
781
1012
 
782
 
<H4><A NAME="SEC93" HREF="vice_toc.html#TOC93">7.2.2.2  VIC20 memory configuration command-line options</A></H4>
 
1013
<H4><A NAME="SEC103" HREF="vice_toc.html#TOC103">7.3.2.2  VIC20 memory configuration command-line options</A></H4>
783
1014
 
784
1015
<DL COMPACT>
785
1016
 
786
1017
<DT><CODE>-memory CONFIG</CODE>
787
1018
<DD>
788
 
<A NAME="IDX233"></A>
 
1019
<A NAME="IDX245"></A>
789
1020
 
790
1021
Specify memory configuration.  It must be a comma-separated list of
791
1022
options, each of which can be one the following:
844
1075
enables memory in blocks 3 and 5, which is the usual configuration for
845
1076
16k ROM modules.
846
1077
 
847
 
<A NAME="IDX234"></A>
 
1078
<A NAME="IDX246"></A>
848
1079
<DT><CODE>-emuid</CODE>
849
1080
<DD>
850
1081
<DT><CODE>+emuid</CODE>
856
1087
 
857
1088
 
858
1089
 
859
 
<H3><A NAME="SEC94" HREF="vice_toc.html#TOC94">7.2.3  VIC20 system ROM settings</A></H3>
 
1090
<H3><A NAME="SEC104" HREF="vice_toc.html#TOC104">7.3.3  VIC20 system ROM settings</A></H3>
860
1091
 
861
1092
<P>
862
1093
These settings can be used to control what system ROMs are loaded in the
866
1097
 
867
1098
 
868
1099
 
869
 
<H4><A NAME="SEC95" HREF="vice_toc.html#TOC95">7.2.3.1  VIC20 system ROM resources</A></H4>
 
1100
<H4><A NAME="SEC105" HREF="vice_toc.html#TOC105">7.3.3.1  VIC20 system ROM resources</A></H4>
870
1101
 
871
1102
<DL COMPACT>
872
1103
 
873
1104
<DT><CODE>KernalName</CODE>
874
1105
<DD>
875
 
<A NAME="IDX235"></A>
 
1106
<A NAME="IDX247"></A>
876
1107
 
877
1108
String specifying the name of the Kernal ROM (default <TT>`kernal'</TT>).
878
1109
 
879
 
<A NAME="IDX236"></A>
 
1110
<A NAME="IDX248"></A>
880
1111
<DT><CODE>BasicName</CODE>
881
1112
<DD>
882
1113
String specifying the name of the Basic ROM (default <TT>`basic'</TT>).
883
1114
 
884
 
<A NAME="IDX237"></A>
 
1115
<A NAME="IDX249"></A>
885
1116
<DT><CODE>ChargenName</CODE>
886
1117
<DD>
887
1118
String specifying the name of the character generator ROM (default
888
1119
<TT>`chargen'</TT>).
889
1120
 
890
 
<A NAME="IDX238"></A>
891
 
<A NAME="IDX239"></A>
892
 
<A NAME="IDX240"></A>
893
 
<A NAME="IDX241"></A>
894
 
<A NAME="IDX242"></A>
 
1121
<A NAME="IDX250"></A>
 
1122
<A NAME="IDX251"></A>
 
1123
<A NAME="IDX252"></A>
 
1124
<A NAME="IDX253"></A>
 
1125
<A NAME="IDX254"></A>
895
1126
<DT><CODE>CartridgeFile2000</CODE>
896
1127
<DD>
897
1128
<DT><CODE>CartridgeFile4000</CODE>
908
1139
 
909
1140
 
910
1141
 
911
 
<H4><A NAME="SEC96" HREF="vice_toc.html#TOC96">7.2.3.2  VIC20 system ROM command-line options</A></H4>
 
1142
<H4><A NAME="SEC106" HREF="vice_toc.html#TOC106">7.3.3.2  VIC20 system ROM command-line options</A></H4>
912
1143
 
913
1144
<DL COMPACT>
914
1145
 
915
1146
<DT><CODE>-kernal NAME</CODE>
916
1147
<DD>
917
 
<A NAME="IDX243"></A>
 
1148
<A NAME="IDX255"></A>
918
1149
 
919
1150
Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
920
1151
 
921
 
<A NAME="IDX244"></A>
 
1152
<A NAME="IDX256"></A>
922
1153
<DT><CODE>-basic NAME</CODE>
923
1154
<DD>
924
1155
Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
925
1156
 
926
 
<A NAME="IDX245"></A>
 
1157
<A NAME="IDX257"></A>
927
1158
<DT><CODE>-chargen NAME</CODE>
928
1159
<DD>
929
1160
Specify <TT>`NAME'</TT> as the character generator ROM file
930
1161
(<CODE>ChargenName</CODE>).
931
1162
 
932
 
<A NAME="IDX246"></A>
933
 
<A NAME="IDX247"></A>
934
 
<A NAME="IDX248"></A>
935
 
<A NAME="IDX249"></A>
936
 
<A NAME="IDX250"></A>
 
1163
<A NAME="IDX258"></A>
 
1164
<A NAME="IDX259"></A>
 
1165
<A NAME="IDX260"></A>
 
1166
<A NAME="IDX261"></A>
 
1167
<A NAME="IDX262"></A>
937
1168
<DT><CODE>-cart2 NAME</CODE>
938
1169
<DD>
939
1170
<DT><CODE>-cart4 NAME</CODE>
951
1182
 
952
1183
 
953
1184
 
954
 
<H2><A NAME="SEC97" HREF="vice_toc.html#TOC97">7.3  PET-specific commands and settings</A></H2>
 
1185
<H2><A NAME="SEC107" HREF="vice_toc.html#TOC107">7.4  PET-specific commands and settings</A></H2>
955
1186
 
956
1187
<P>
957
1188
This section lists the settings and commands that are PET-specific and
961
1192
 
962
1193
 
963
1194
 
964
 
<H3><A NAME="SEC98" HREF="vice_toc.html#TOC98">7.3.1  Changing PET model settings</A></H3>
 
1195
<H3><A NAME="SEC108" HREF="vice_toc.html#TOC108">7.4.1  Changing PET model settings</A></H3>
965
1196
 
966
1197
<P>
967
1198
With <CODE>xpet</CODE>, it is possible to change at runtime the
979
1210
 
980
1211
<DT><CODE>RamSize</CODE>
981
1212
<DD>
982
 
<A NAME="IDX251"></A>
 
1213
<A NAME="IDX263"></A>
983
1214
 
984
1215
Size of memory in kByte. 96k denotes a 8096, 128k a 8296.
985
1216
 
986
 
<A NAME="IDX252"></A>
 
1217
<A NAME="IDX264"></A>
987
1218
<DT><CODE>IOSize</CODE>
988
1219
<DD>
989
1220
Size of I/O area in Byte.  Either 2048 or 256 for 8296.
990
1221
 
991
 
<A NAME="IDX253"></A>
 
1222
<A NAME="IDX265"></A>
992
1223
<DT><CODE>Crtc</CODE>
993
1224
<DD>
994
1225
Enables CRTC 6545 emulation (all models from 40xx and above)
995
1226
 
996
 
<A NAME="IDX254"></A>
 
1227
<A NAME="IDX266"></A>
997
1228
<DT><CODE>VideoSize</CODE>
998
1229
<DD>
999
1230
The number of columns on the screen (40 or 80).  A 0 auto-detects this
1000
1231
from the ROM.
1001
1232
 
1002
 
<A NAME="IDX255"></A>
 
1233
<A NAME="IDX267"></A>
1003
1234
<DT><CODE>Ram9</CODE>
1004
1235
<DD>
1005
1236
The 8296 can map RAM into the address range $9***
1006
1237
 
1007
 
<A NAME="IDX256"></A>
 
1238
<A NAME="IDX268"></A>
1008
1239
<DT><CODE>RamA</CODE>
1009
1240
<DD>
1010
1241
The 8296 can map RAM into the address range $A***
1011
1242
 
1012
 
<A NAME="IDX257"></A>
 
1243
<A NAME="IDX269"></A>
1013
1244
<DT><CODE>SuperPET</CODE>
1014
1245
<DD>
1015
1246
This resource enables the SuperPET (MicroMainFrame 9000) I/O
1016
1247
and disables the 8x96 mappings.
1017
1248
 
1018
 
<A NAME="IDX258"></A>
 
1249
<A NAME="IDX270"></A>
1019
1250
<DT><CODE>Basic1</CODE>
1020
1251
<DD>
1021
1252
If (by checksum) a version 1 kernal is detected, then the 
1022
1253
kernal ROM is patched to make the IEEE488 interface work.
1023
1254
 
1024
 
<A NAME="IDX259"></A>
 
1255
<A NAME="IDX271"></A>
1025
1256
<DT><CODE>Basic1Chars</CODE>
1026
1257
<DD>
1027
1258
Exchanges some character in the character ROM that have changed
1028
1259
between the first PET 2001 and all newer versions.
1029
1260
 
1030
 
<A NAME="IDX260"></A>
 
1261
<A NAME="IDX272"></A>
1031
1262
<DT><CODE>EoiBlank</CODE>
1032
1263
<DD>
1033
1264
This resource enables the "blank screen on EOI" feature of the 
1034
1265
oldest PET 2001.
1035
1266
 
1036
 
<A NAME="IDX261"></A>
 
1267
<A NAME="IDX273"></A>
1037
1268
<DT><CODE>EmuID</CODE>
1038
1269
<DD>
1039
1270
Enable emulator ID (at <CODE>$e8a0-$e8ff</CODE>, for use see C64).
1040
1271
 
1041
 
<A NAME="IDX262"></A>
 
1272
<A NAME="IDX274"></A>
1042
1273
<DT><CODE>DiagPin</CODE>
1043
1274
<DD>
1044
1275
Set the diagnositc pin on the PET userport (see below).
1045
1276
 
1046
 
<A NAME="IDX263"></A>
 
1277
<A NAME="IDX275"></A>
1047
1278
<DT><CODE>ChargenName</CODE>
1048
1279
<DD>
1049
1280
Specify <TT>`NAME'</TT> as the character generator ROM file
1050
1281
 
1051
 
<A NAME="IDX264"></A>
 
1282
<A NAME="IDX276"></A>
1052
1283
<DT><CODE>KernalName</CODE>
1053
1284
<DD>
1054
1285
Specify <TT>`NAME'</TT> as the kernal ROM file.  This file contains the
1055
1286
complete BASIC, EDITOR and KERNAL ROMs and is either 16k (BASIC 1 and 2)
1056
1287
or 20k (BASIC 4) in size.
1057
1288
 
1058
 
<A NAME="IDX265"></A>
 
1289
<A NAME="IDX277"></A>
1059
1290
<DT><CODE>EditorName</CODE>
1060
1291
<DD>
1061
1292
Specify <TT>`NAME'</TT> as the editor ROM file.  This file contains
1062
1293
an overlay for the editor ROM at $E000-$E7FF if necessary.
1063
1294
 
1064
 
<A NAME="IDX266"></A>
 
1295
<A NAME="IDX278"></A>
1065
1296
<DT><CODE>RomModule9Name</CODE>
1066
1297
<DD>
1067
1298
Specify <TT>`NAME'</TT> as the $9*** Expansion ROM file.  This file contains
1068
1299
an expansion ROM image of 4k.
1069
1300
 
1070
 
<A NAME="IDX267"></A>
 
1301
<A NAME="IDX279"></A>
1071
1302
<DT><CODE>RomModuleAName</CODE>
1072
1303
<DD>
1073
1304
Specify <TT>`NAME'</TT> as the $A*** Expansion ROM file.  This file contains
1074
1305
an expansion ROM image of 4k.
1075
1306
 
1076
 
<A NAME="IDX268"></A>
 
1307
<A NAME="IDX280"></A>
1077
1308
<DT><CODE>RomModuleBName</CODE>
1078
1309
<DD>
1079
1310
Specify <TT>`NAME'</TT> as the $B*** Expansion ROM file.  This file contains
1142
1373
 
1143
1374
 
1144
1375
 
1145
 
<H3><A NAME="SEC99" HREF="vice_toc.html#TOC99">7.3.2  The PET diagnostic pin</A></H3>
 
1376
<H3><A NAME="SEC109" HREF="vice_toc.html#TOC109">7.4.2  The PET diagnostic pin</A></H3>
1146
1377
 
1147
1378
<P>
1148
1379
It is possible to enable or disable emulation of the PET diagnostic pin
1157
1388
</P>
1158
1389
 
1159
1390
 
1160
 
<H3><A NAME="SEC100" HREF="vice_toc.html#TOC100">7.3.3  PET command line options</A></H3>
 
1391
<H3><A NAME="SEC110" HREF="vice_toc.html#TOC110">7.4.3  PET command line options</A></H3>
1161
1392
 
1162
1393
<P>
1163
1394
These are the commandline options specific for the CBM-II models.
1167
1398
 
1168
1399
<DT><CODE>-model MODEL</CODE>
1169
1400
<DD>
1170
 
<A NAME="IDX269"></A>
 
1401
<A NAME="IDX281"></A>
1171
1402
 
1172
1403
Specify the PET model you want to emulate.
1173
1404
 
1174
 
<A NAME="IDX270"></A>
 
1405
<A NAME="IDX282"></A>
1175
1406
<DT><CODE>-kernal NAME</CODE>
1176
1407
<DD>
1177
1408
Specify <TT>`NAME'</TT> as the Kernal/BASIC ROM file (<CODE>KernalName</CODE>).
1178
1409
 
1179
 
<A NAME="IDX271"></A>
 
1410
<A NAME="IDX283"></A>
1180
1411
<DT><CODE>-editor NAME</CODE>
1181
1412
<DD>
1182
1413
Specify <TT>`NAME'</TT> as the editor ROM file (<CODE>EditorName</CODE>).
1183
1414
 
1184
 
<A NAME="IDX272"></A>
 
1415
<A NAME="IDX284"></A>
1185
1416
<DT><CODE>-chargen NAME</CODE>
1186
1417
<DD>
1187
1418
Specify <TT>`NAME'</TT> as the character generator ROM file
1188
1419
(<CODE>ChargenName</CODE>).
1189
1420
 
1190
 
<A NAME="IDX273"></A>
1191
 
<A NAME="IDX274"></A>
1192
 
<A NAME="IDX275"></A>
 
1421
<A NAME="IDX285"></A>
 
1422
<A NAME="IDX286"></A>
 
1423
<A NAME="IDX287"></A>
1193
1424
<DT><CODE>-rom9 NAME, -romA NAME, -romB NAME</CODE>
1194
1425
<DD>
1195
1426
Specify <TT>`NAME'</TT> as the ROM image file for the respective 
1196
1427
cartridge areas (<CODE>RomModule9Name</CODE>, <CODE>RomModuleAName</CODE>, 
1197
1428
<CODE>RomModuleBName</CODE>).
1198
1429
 
1199
 
<A NAME="IDX276"></A>
1200
 
<A NAME="IDX277"></A>
 
1430
<A NAME="IDX288"></A>
 
1431
<A NAME="IDX289"></A>
1201
1432
<DT><CODE>-petramA, -petramB</CODE>
1202
1433
<DD>
1203
1434
Switch on RAM mapping on addresses 
1204
1435
$9000-$9fff, $a000-$afff
1205
1436
(<CODE>Ram9</CODE>, <CODE>RamA</CODE>).
1206
1437
 
1207
 
<A NAME="IDX278"></A>
1208
 
<A NAME="IDX279"></A>
 
1438
<A NAME="IDX290"></A>
 
1439
<A NAME="IDX291"></A>
1209
1440
<DT><CODE>-superpet, +superpet</CODE>
1210
1441
<DD>
1211
1442
Enable/Disable SuperPET I/O emulation (<CODE>SuperPET</CODE>).
1212
1443
 
1213
 
<A NAME="IDX280"></A>
1214
 
<A NAME="IDX281"></A>
 
1444
<A NAME="IDX292"></A>
 
1445
<A NAME="IDX293"></A>
1215
1446
<DT><CODE>-basic1, +basic1</CODE>
1216
1447
<DD>
1217
1448
Enable/Disable patching the IEEE488 section of the PET2001 ROM when detected
1218
1449
(<CODE>Basic1</CODE>).
1219
1450
 
1220
 
<A NAME="IDX282"></A>
1221
 
<A NAME="IDX283"></A>
 
1451
<A NAME="IDX294"></A>
 
1452
<A NAME="IDX295"></A>
1222
1453
<DT><CODE>-basic1char, +basic1char</CODE>
1223
1454
<DD>
1224
1455
Enable/Disable PET 2001 character generator
1225
1456
(<CODE>Basic1Chars</CODE>).
1226
1457
 
1227
 
<A NAME="IDX284"></A>
1228
 
<A NAME="IDX285"></A>
 
1458
<A NAME="IDX296"></A>
 
1459
<A NAME="IDX297"></A>
1229
1460
<DT><CODE>-eoiblank, +eoiblank</CODE>
1230
1461
<DD>
1231
1462
Enable/Disable EOI blanking the screen
1232
1463
(<CODE>EoiBlank</CODE>).
1233
1464
 
1234
 
<A NAME="IDX286"></A>
 
1465
<A NAME="IDX298"></A>
1235
1466
<DT><CODE>-emuid</CODE>
1236
1467
<DD>
1237
1468
<DT><CODE>+emuid</CODE>
1239
1470
Enable (<CODE>EmuID=1</CODE>) or disable (<CODE>EmuID=0</CODE>) the emulation
1240
1471
identification extension (at <CODE>$e8a0-$e8ff</CODE>).
1241
1472
 
1242
 
<A NAME="IDX287"></A>
 
1473
<A NAME="IDX299"></A>
1243
1474
<DT><CODE>-diagpin</CODE>
1244
1475
<DD>
1245
1476
<DT><CODE>+diagpin</CODE>
1251
1482
 
1252
1483
 
1253
1484
 
1254
 
<H3><A NAME="SEC101" HREF="vice_toc.html#TOC101">7.3.4  Changing screen colors</A></H3>
 
1485
<H3><A NAME="SEC111" HREF="vice_toc.html#TOC111">7.4.4  Changing screen colors</A></H3>
1255
1486
 
1256
1487
<P>
1257
1488
It is also possible to choose what color set is used for the emulation
1258
 
window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC26">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
 
1489
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
1259
1490
following values:
1260
1491
 
1261
1492
</P>
1275
1506
 
1276
1507
 
1277
1508
 
1278
 
<H2><A NAME="SEC102" HREF="vice_toc.html#TOC102">7.4  CBM-II-specific commands and settings</A></H2>
 
1509
<H2><A NAME="SEC112" HREF="vice_toc.html#TOC112">7.5  CBM-II-specific commands and settings</A></H2>
1279
1510
 
1280
1511
<P>
1281
1512
This section lists the settings and commands that are CBM-II-specific and
1285
1516
 
1286
1517
 
1287
1518
 
1288
 
<H3><A NAME="SEC103" HREF="vice_toc.html#TOC103">7.4.1  Changing CBM-II model</A></H3>
 
1519
<H3><A NAME="SEC113" HREF="vice_toc.html#TOC113">7.5.1  Changing CBM-II model</A></H3>
1289
1520
 
1290
1521
<P>
1291
1522
With <CODE>xcbm2</CODE>, it is possible to change at runtime the
1303
1534
 
1304
1535
<DT><CODE>UseVicII</CODE>
1305
1536
<DD>
1306
 
<A NAME="IDX288"></A>
 
1537
<A NAME="IDX300"></A>
1307
1538
 
1308
1539
Whether to use VIC-II for video output (value 1) or the CRTC for the
1309
1540
other machines (value 0)
1310
1541
 
1311
 
<A NAME="IDX289"></A>
 
1542
<A NAME="IDX301"></A>
1312
1543
<DT><CODE>RamSize</CODE>
1313
1544
<DD>
1314
1545
Size of memory in kByte.  Possible values are 128, 256, 512 and 1024
1315
1546
 
1316
 
<A NAME="IDX290"></A>
1317
 
<A NAME="IDX291"></A>
1318
 
<A NAME="IDX292"></A>
1319
 
<A NAME="IDX293"></A>
1320
 
<A NAME="IDX294"></A>
1321
 
<A NAME="IDX295"></A>
 
1547
<A NAME="IDX302"></A>
 
1548
<A NAME="IDX303"></A>
 
1549
<A NAME="IDX304"></A>
 
1550
<A NAME="IDX305"></A>
 
1551
<A NAME="IDX306"></A>
 
1552
<A NAME="IDX307"></A>
1322
1553
<DT><CODE>Ram08, Ram1, Ram2, Ram4, Ram6, RamC</CODE>
1323
1554
<DD>
1324
1555
Expanded CBM-II models could map RAM to the expansion ROM areas
1325
1556
at $0800-$0fff, $1000-$1fff, $2000-$3FFF, $4000-$5FFF, $6000-$7FFF
1326
1557
and $c000-$cfff respectively.
1327
1558
 
1328
 
<A NAME="IDX296"></A>
1329
 
<A NAME="IDX297"></A>
1330
 
<A NAME="IDX298"></A>
 
1559
<A NAME="IDX308"></A>
 
1560
<A NAME="IDX309"></A>
 
1561
<A NAME="IDX310"></A>
1331
1562
<DT><CODE>Cart2Name, Cart4Name, Cart6Name</CODE>
1332
1563
<DD>
1333
1564
Specify <TT>`NAME'</TT> as the $2000-$3FFF, $4000-$5FFF or $6000-$6FFF
1334
1565
Expansion ROM file.  This file contains an 8k ROM dump.
1335
1566
 
1336
 
<A NAME="IDX299"></A>
 
1567
<A NAME="IDX311"></A>
1337
1568
<DT><CODE>ModelLine</CODE>
1338
1569
<DD>
1339
1570
The CBM-II business models have two hardcoded lines at one of the I/O ports.
1394
1625
</P>
1395
1626
 
1396
1627
 
1397
 
<H3><A NAME="SEC104" HREF="vice_toc.html#TOC104">7.4.2  CBM-II command line options</A></H3>
 
1628
<H3><A NAME="SEC114" HREF="vice_toc.html#TOC114">7.5.2  CBM-II command line options</A></H3>
1398
1629
 
1399
1630
<P>
1400
1631
These are the commandline options specific for the CBM-II models.
1404
1635
 
1405
1636
<DT><CODE>-usevicii</CODE>
1406
1637
<DD>
1407
 
<A NAME="IDX300"></A>
 
1638
<A NAME="IDX312"></A>
1408
1639
 
1409
1640
<DT><CODE>+usevicii</CODE>
1410
1641
<DD>
1411
1642
Specify whether to use (-usevicii) or not to use (+usevicii) the VIC-II 
1412
1643
emulation.
1413
1644
 
1414
 
<A NAME="IDX301"></A>
 
1645
<A NAME="IDX313"></A>
1415
1646
<DT><CODE>-kernal NAME</CODE>
1416
1647
<DD>
1417
1648
Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
1418
1649
 
1419
 
<A NAME="IDX302"></A>
 
1650
<A NAME="IDX314"></A>
1420
1651
<DT><CODE>-basic NAME</CODE>
1421
1652
<DD>
1422
1653
Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
1423
1654
 
1424
 
<A NAME="IDX303"></A>
 
1655
<A NAME="IDX315"></A>
1425
1656
<DT><CODE>-chargen NAME</CODE>
1426
1657
<DD>
1427
1658
Specify <TT>`NAME'</TT> as the character generator ROM file
1428
1659
(<CODE>ChargenName</CODE>).
1429
1660
 
1430
 
<A NAME="IDX304"></A>
1431
 
<A NAME="IDX305"></A>
1432
 
<A NAME="IDX306"></A>
 
1661
<A NAME="IDX316"></A>
 
1662
<A NAME="IDX317"></A>
 
1663
<A NAME="IDX318"></A>
1433
1664
<DT><CODE>-cart2 NAME, -cart4 NAME, -cart6 NAME</CODE>
1434
1665
<DD>
1435
1666
Specify <TT>`NAME'</TT> as the ROM image file for the respective 
1436
1667
cartridge areas (<CODE>Cart2Name</CODE>, <CODE>Cart4Name</CODE>, <CODE>Cart6Name</CODE>).
1437
1668
 
1438
 
<A NAME="IDX307"></A>
1439
 
<A NAME="IDX308"></A>
1440
 
<A NAME="IDX309"></A>
1441
 
<A NAME="IDX310"></A>
1442
 
<A NAME="IDX311"></A>
1443
 
<A NAME="IDX312"></A>
 
1669
<A NAME="IDX319"></A>
 
1670
<A NAME="IDX320"></A>
 
1671
<A NAME="IDX321"></A>
 
1672
<A NAME="IDX322"></A>
 
1673
<A NAME="IDX323"></A>
 
1674
<A NAME="IDX324"></A>
1444
1675
<DT><CODE>-ram08, -ram1, -ram2, -ram4, -ram6, -ramC</CODE>
1445
1676
<DD>
1446
1677
Switch on RAM mapping in bank 15 on addresses 
1448
1679
(<CODE>Ram08</CODE>, <CODE>Ram1</CODE>, <CODE>Ram2</CODE>, <CODE>Ram4</CODE>, <CODE>Ram6</CODE>,
1449
1680
<CODE>RamC</CODE>).
1450
1681
 
1451
 
<A NAME="IDX313"></A>
 
1682
<A NAME="IDX325"></A>
1452
1683
<DT><CODE>-modelline</CODE>
1453
1684
<DD>
1454
1685
Define the hardcoded model switch in the CBM-II models.
1457
1688
 
1458
1689
 
1459
1690
 
1460
 
<H3><A NAME="SEC105" HREF="vice_toc.html#TOC105">7.4.3  Changing screen colors</A></H3>
 
1691
<H3><A NAME="SEC115" HREF="vice_toc.html#TOC115">7.5.3  Changing screen colors</A></H3>
1461
1692
 
1462
1693
<P>
1463
1694
It is also possible to choose what color set is used for the emulation
1464
 
window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC26">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
 
1695
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
1465
1696
following values:
1466
1697
 
1467
1698
</P>