← Back to branch summary

~ubuntu-branches/ubuntu/raring/vice/raring

« back to all changes in this revision

Viewing changes to doc/vice.info

  • Committer: Bazaar Package Importer
  • Author(s): Laszlo Boszormenyi (GCS)
  • Date: 2009-03-31 00:37:15 UTC
  • mfrom: (1.2.2 upstream)
  • mto: This revision was merged to the branch mainline in revision 17.
  • Revision ID: james.westby@ubuntu.com-20090331003715-mzclchtl0dp7fcl0
Tags: upstream-2.1.dfsg
Import upstream version 2.1.dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/vice.info
1
 
Dies ist vice.info, hergestellt von Makeinfo Version 4.8 aus vice.texi.
 
1
This is vice.info, produced by makeinfo version 4.8 from vice.texi.
2
2
 
3
3
START-INFO-DIR-ENTRY
4
4
* VICE: (vice).        VICE, the Versatile Commodore Emulator.
18
18
 
19
19
File: vice.info,  Node: Top,  Next: License,  Prev: (dir),  Up: (dir)
20
20
 
21
 
   This is the documentation for version 1.20 of VICE, the Versatile
 
21
   This is the documentation for version 2.1 of VICE, the Versatile
22
22
Commodore Emulator.
23
23
 
24
24
* Menu:
420
420
************
421
421
 
422
422
VICE is the one and only "Versatile Commodore Emulator".  It provides
423
 
emulation of the Commodore C64, C128, VIC20, PET, PLUS4 and CBM-II
424
 
computers within a single package.  The emulators run as separate
425
 
programs, but have the same user interface, share the same settings and
426
 
support the same file formats.
 
423
emulation of the Commodore C64, C64DTV, C128, VIC20, PET, PLUS4 and
 
424
CBM-II computers within a single package.  The emulators run as
 
425
separate programs, but have the same user interface, share the same
 
426
settings and support the same file formats.
427
427
 
428
428
   *Important notice:* If you have no idea what a Commodore 8-bit
429
429
computer is, or have questions about how these machines are used, how
438
438
accurate; it tries to emulate chip timings as precisely as possible and
439
439
does so _efficiently_.
440
440
 
441
 
   Please do _not_ expect the C128, PET, PLUS4 and CBM-II emulators to
442
 
be as good as the C64 or VIC20 one, as they are still under
443
 
construction.
 
441
   Please do _not_ expect the C64DTV, C128, PET, PLUS4 and CBM-II
 
442
emulators to be as good as the C64 or VIC20 one, as they are still
 
443
under construction.
444
444
 
445
445
   _Notice:_ This documentation is written for the Unix release of VICE.
446
446
 
447
447
* Menu:
448
448
 
449
449
* C64 emulator features::
 
450
* C64DTV emulator features::
450
451
* C128 emulator features::
451
452
* VIC20 emulator features::
452
453
* PET emulator features::
458
459
* Common problems::
459
460
 
460
461
 
461
 
File: vice.info,  Node: C64 emulator features,  Next: C128 emulator features,  Prev: Preface,  Up: Preface
 
462
File: vice.info,  Node: C64 emulator features,  Next: C64DTV emulator features,  Prev: Preface,  Up: Preface
462
463
 
463
464
2.1 C64 emulator features
464
465
=========================
471
472
   A rather complete emulation of the SID sound chip is also provided.
472
473
All the basic features are implemented as well as most of the complex
473
474
ones including synchronisation, ring modulation and filters.  There are
474
 
two emulators of the SID chip available: one is the "standard" VICE
475
 
emulator, available since VICE 0.12; the other one is Dag Lem's reSID
476
 
engine.  The reSID engine is a lot more accurate than the standard
477
 
engine, but it is also a lot slower, and only suitable for faster
478
 
machines.
 
475
three emulators of the SID chip available: first is the "standard" VICE
 
476
emulator, available since VICE 0.12; the second is Dag Lem's reSID
 
477
engine and the third one is reSID-fp. The reSID engines are a lot more
 
478
accurate than the standard engine, but they are also a lot slower, and
 
479
only suitable for faster machines.
479
480
 
480
481
   Naturally, also both CIAs (or VIAs, in some cases) are fully emulated
481
482
and cycle accurate.
482
483
 
483
484
 
484
 
File: vice.info,  Node: C128 emulator features,  Next: VIC20 emulator features,  Prev: C64 emulator features,  Up: Preface
485
 
 
486
 
2.2 C128 emulator features
 
485
File: vice.info,  Node: C64DTV emulator features,  Next: C128 emulator features,  Prev: C64 emulator features,  Up: Preface
 
486
 
 
487
2.2 C64DTV emulator features
 
488
============================
 
489
 
 
490
The C64DTV emulator, called `x64dtv', features emulation of C64DTV
 
491
revisions 2 and 3. The emulator is under construction, but most of the
 
492
DTV specific features are already supported (with varying accuracy).
 
493
 
 
494
   Video cache is disabled by default as it currently doesn't work with
 
495
some of C64DTV's new video modes. The new video modes have a simple
 
496
"fake" video cache implementation that may give incorrect results and
 
497
decreased performance.
 
498
 
 
499
 
 
500
File: vice.info,  Node: C128 emulator features,  Next: VIC20 emulator features,  Prev: C64DTV emulator features,  Up: Preface
 
501
 
 
502
2.3 C128 emulator features
487
503
==========================
488
504
 
489
505
The C128 emulator, called `x128', features a complete emulation of the
490
506
internal MMU ("Memory Management Unit"), 80 column VDC screen, fast IEC
491
 
bus emulation, Z80 emulation plus all the features of the C64 emulation.
492
 
The following things are missing, though:
493
 
 
494
 
   * 2 MHz mode;
 
507
bus emulation, 2 MHz mode, Z80 emulation plus all the features of the
 
508
C64 emulation.
495
509
 
496
510
 
497
511
File: vice.info,  Node: VIC20 emulator features,  Next: PET emulator features,  Prev: C128 emulator features,  Up: Preface
498
512
 
499
 
2.3 VIC20 emulator features
 
513
2.4 VIC20 emulator features
500
514
===========================
501
515
 
502
516
The VIC20 emulates all the internal hardware, including the VIA chips.
517
531
 
518
532
File: vice.info,  Node: PET emulator features,  Next: CBM-II emulator features,  Prev: VIC20 emulator features,  Up: Preface
519
533
 
520
 
2.4 PET emulator features
 
534
2.5 PET emulator features
521
535
=========================
522
536
 
523
537
The PET emulator emulates the 2001, 3032, 4032, 8032, 8096, 8296 and
574
588
 
575
589
File: vice.info,  Node: CBM-II emulator features,  Next: Keyboard emulation,  Prev: PET emulator features,  Up: Preface
576
590
 
577
 
2.5 CBM-II emulator features
 
591
2.6 CBM-II emulator features
578
592
============================
579
593
 
580
594
The CBM-II emulator emulates several types of CBM-II models.  Those
620
634
 
621
635
File: vice.info,  Node: Keyboard emulation,  Next: Joystick emulation,  Prev: CBM-II emulator features,  Up: Preface
622
636
 
623
 
2.6 The keyboard emulation
 
637
2.7 The keyboard emulation
624
638
==========================
625
639
 
626
640
There are two ways of emulating the keyboard in VICE.
665
679
 
666
680
File: vice.info,  Node: Joystick emulation,  Next: Disk drive emulation,  Prev: Keyboard emulation,  Up: Preface
667
681
 
668
 
2.7 The joystick emulation
 
682
2.8 The joystick emulation
669
683
==========================
670
684
 
671
685
Joysticks can be emulated both via the keyboard and via a real joystick
685
699
 
686
700
File: vice.info,  Node: Disk drive emulation,  Next: Supported file formats,  Prev: Joystick emulation,  Up: Preface
687
701
 
688
 
2.8 The disk drive emulation
 
702
2.9 The disk drive emulation
689
703
============================
690
704
 
691
705
All the emulators support up to 4 external disk drives as devices 8, 9,
802
816
 
803
817
File: vice.info,  Node: Supported file formats,  Next: Common problems,  Prev: Disk drive emulation,  Up: Preface
804
818
 
805
 
2.9 Supported file formats
806
 
==========================
 
819
2.10 Supported file formats
 
820
===========================
807
821
 
808
822
VICE supports the most popular Commodore file formats:
809
823
 
843
857
 
844
858
File: vice.info,  Node: Common problems,  Prev: Supported file formats,  Up: Preface
845
859
 
846
 
2.10 Common problems
 
860
2.11 Common problems
847
861
====================
848
862
 
849
863
This section tries to describe the most common known problems with VICE,
859
873
 
860
874
File: vice.info,  Node: Sound problems,  Next: Shared memory problems,  Prev: Common problems,  Up: Common problems
861
875
 
862
 
2.10.1 Sound problems
 
876
2.11.1 Sound problems
863
877
---------------------
864
878
 
865
879
VICE should compile and run without major problems on many UNIX systems,
885
899
 
886
900
File: vice.info,  Node: Shared memory problems,  Next: Printer problems,  Prev: Sound problems,  Up: Common problems
887
901
 
888
 
2.10.2 Shared memory problems
 
902
2.11.2 Shared memory problems
889
903
-----------------------------
890
904
 
891
905
If you cannot start VICE because you get errors about shared memory, try
914
928
 
915
929
File: vice.info,  Node: Printer problems,  Next: PET keyboard problems,  Prev: Shared memory problems,  Up: Common problems
916
930
 
917
 
2.10.3 Printer problems
 
931
2.11.3 Printer problems
918
932
-----------------------
919
933
 
920
934
VICE supports the emulation of a printer either on the userport or as
933
947
 
934
948
File: vice.info,  Node: PET keyboard problems,  Prev: Printer problems,  Up: Common problems
935
949
 
936
 
2.10.4 PET keyboard problems
 
950
2.11.4 PET keyboard problems
937
951
----------------------------
938
952
 
939
953
If you find that the German keyboard mapping (plus German charset) does
958
972
 
959
973
   * `x64', the C64 emulator
960
974
 
 
975
   * `x64dtv', the C64DTV emulator
 
976
 
961
977
   * `x128', the C128 emulator
962
978
 
963
979
   * `xvic', the VIC20 emulator
1789
1805
* Drive settings::              Settings that control disk-drive emulation.
1790
1806
* Peripheral settings::         Settings for emulated external devices.
1791
1807
* RS232 settings::              Settings for the RS232 emulation.
 
1808
* Monitor settings::            Settings for the built-in monitor.
1792
1809
* Misc settings::               Other settings.
1793
1810
 
1794
1811
 
2799
2816
 
2800
2817
 
2801
2818
 
2802
 
File: vice.info,  Node: RS232 settings,  Next: Misc settings,  Prev: Peripheral settings,  Up: Settings and resources
 
2819
File: vice.info,  Node: RS232 settings,  Next: Monitor settings,  Prev: Peripheral settings,  Up: Settings and resources
2803
2820
 
2804
2821
6.9 RS232 settings
2805
2822
==================
2990
3007
 
2991
3008
 
2992
3009
 
2993
 
File: vice.info,  Node: Misc settings,  Prev: RS232 settings,  Up: Settings and resources
2994
 
 
2995
 
6.10 Miscellaneous settings
 
3010
File: vice.info,  Node: Monitor settings,  Next: Misc settings,  Prev: RS232 settings,  Up: Settings and resources
 
3011
 
 
3012
6.10 Monitor settings
 
3013
=====================
 
3014
 
 
3015
This section lists command-line options specific to the built-in
 
3016
monitor.
 
3017
 
 
3018
* Menu:
 
3019
 
 
3020
* Monitor options::
 
3021
 
 
3022
 
 
3023
File: vice.info,  Node: Monitor options,  Up: Monitor settings
 
3024
 
 
3025
6.10.1 Monitor command-line options
 
3026
-----------------------------------
 
3027
 
 
3028
`-moncommand FILENAME'
 
3029
     Execute the commands from the file `FILENAME' in the monitor after
 
3030
     starting up. This command line switch is mainly thought to load
 
3031
     labels and to set breakpoints.  Not all other commands are useful
 
3032
     to be executed in this way, some may even lead to strange effects.
 
3033
 
 
3034
`-initbreak <address>'
 
3035
     Set an initial breakpoint for the monitor. Addresses with prefix
 
3036
     "0x" are hexadecimal.
 
3037
 
 
3038
 
 
3039
File: vice.info,  Node: Misc settings,  Prev: Monitor settings,  Up: Settings and resources
 
3040
 
 
3041
6.11 Miscellaneous settings
2996
3042
===========================
2997
3043
 
2998
3044
This section lists generic resources that do not fit in the other
3006
3052
 
3007
3053
File: vice.info,  Node: Misc resources,  Next: Misc options,  Prev: Misc settings,  Up: Misc settings
3008
3054
 
3009
 
6.10.1 Miscellaneous resources
 
3055
6.11.1 Miscellaneous resources
3010
3056
------------------------------
3011
3057
 
3012
3058
`Directory'
3070
3116
 
3071
3117
File: vice.info,  Node: Misc options,  Prev: Misc resources,  Up: Misc settings
3072
3118
 
3073
 
6.10.2 Miscellaneous command-line options
 
3119
6.11.2 Miscellaneous command-line options
3074
3120
-----------------------------------------
3075
3121
 
3076
3122
`-directory SEARCHPATH'
3105
3151
 
3106
3152
* C64/128-specific::            Commands and settings specific to the
3107
3153
                                C64/128 emulators
 
3154
* C64DTV-specific::             Commands and settings specific to the
 
3155
                                C64DTV emulator
3108
3156
* VIC20-specific::              Commands and settings specific to the
3109
3157
                                VIC20 emulator
3110
3158
* PET-specific::                Commands and settings specific to the
3111
3159
                                PET emulator
3112
3160
* CBM-II-specific::             Commands and settings specific to the
3113
 
                                CBM-II emulator
 
3161
                                CBM-II emulator
3114
3162
 
3115
3163
 
3116
 
File: vice.info,  Node: C64/128-specific,  Next: VIC20-specific,  Prev: Machine-specific features,  Up: Machine-specific features
 
3164
File: vice.info,  Node: C64/128-specific,  Next: C64DTV-specific,  Prev: Machine-specific features,  Up: Machine-specific features
3117
3165
 
3118
3166
7.1 C64/128-specific commands and settings
3119
3167
==========================================
3543
3591
 
3544
3592
 
3545
3593
 
3546
 
File: vice.info,  Node: VIC20-specific,  Next: PET-specific,  Prev: C64/128-specific,  Up: Machine-specific features
3547
 
 
3548
 
7.2 VIC20-specific commands and settings
 
3594
File: vice.info,  Node: C64DTV-specific,  Next: VIC20-specific,  Prev: C64/128-specific,  Up: Machine-specific features
 
3595
 
 
3596
7.2 C64DTV-specific commands and settings
 
3597
=========================================
 
3598
 
 
3599
This section lists the settings and commands that are C64DTV specific
 
3600
and thus are not present in the other emulators.
 
3601
 
 
3602
* Menu:
 
3603
 
 
3604
* C64DTV ROM image::
 
3605
* DTV revision::
 
3606
* LumaFix::
 
3607
* Userport::
 
3608
* Debug::
 
3609
* Monitor DTV features::
 
3610
 
 
3611
 
 
3612
File: vice.info,  Node: C64DTV ROM image,  Next: DTV revision,  Prev: C64DTV-specific,  Up: C64DTV-specific
 
3613
 
 
3614
7.2.1 C64DTV ROM image
 
3615
----------------------
 
3616
 
 
3617
The DTV has a 2MB Flash chip which contains the kernal, basic and
 
3618
character set ROMs along with other data, such as games in the case of
 
3619
the original C64DTV ROM.
 
3620
 
 
3621
   The image file is a dump of the flash chip. It is exactly 2MB
 
3622
(2097152 bytes).
 
3623
 
 
3624
   If you do not have a suitable image file, an image using the C64
 
3625
kernal, basic and charset is automatically created.
 
3626
 
 
3627
   If writing to the C64DTV ROM is enabled, the image file is rewritten
 
3628
with the current data when exiting x64dtv.
 
3629
 
 
3630
   Note that x64dtv tries to load the image file from the C64DTV
 
3631
directory first, and if it isn't found there, x64dtv tries to load it
 
3632
from the current directory. If you do not have `dtvrom.bin' in your
 
3633
C64DTV directory and writing to DTV ROM is enabled, the `dtvrom.bin'
 
3634
file is created to the current directory.
 
3635
 
 
3636
   NOTE: The original C64DTV ROM has somewhat distorted colors,
 
3637
normally you should use a patched rom.
 
3638
 
 
3639
`-c64dtvromimage NAME'
 
3640
     Specify `NAME' as the C64DTV ROM image
 
3641
 
 
3642
`-c64dtvromrw'
 
3643
`+c64dtvromrw'
 
3644
     Enable or disable writing to C64DTV ROM image
 
3645
 
 
3646
 
 
3647
   The trueflashfs option is analogous to True drive emulation.  If
 
3648
disabled, any file access to the flash filesystem (device 1) will go to
 
3649
the local file system instead.
 
3650
 
 
3651
`-trueflashfs'
 
3652
`+trueflashfs'
 
3653
     Enable or disable true hardware flash file system
 
3654
 
 
3655
`-fsflash NAME'
 
3656
     Specify `NAME' as directory for flash file system device
 
3657
 
 
3658
 
 
3659
 
 
3660
File: vice.info,  Node: DTV revision,  Next: LumaFix,  Prev: C64DTV ROM image,  Up: C64DTV-specific
 
3661
 
 
3662
7.2.2 DTV revision
 
3663
------------------
 
3664
 
 
3665
The DTV revision 2 has a bug in the Blitter. Using revision 3 is
 
3666
recommended. Emulation of DTV revision 2 including Blitter bug is
 
3667
intended for testing DTV software.
 
3668
 
 
3669
`-dtvrev REVISION'
 
3670
     Specify DTV `REVISION' (2 or 3)
 
3671
 
 
3672
 
 
3673
 
 
3674
File: vice.info,  Node: LumaFix,  Next: Userport,  Prev: DTV revision,  Up: C64DTV-specific
 
3675
 
 
3676
7.2.3 LumaFix
 
3677
-------------
 
3678
 
 
3679
The PAL C64DTVs have wrong resistors in the video output circuit, which
 
3680
causes incorrect luminances. Several hardware solutions ("LumaFixes")
 
3681
have been developed to fix this flaw.
 
3682
 
 
3683
   The fixed video output is emulated by selecting "New Luminances".
 
3684
The unmodified C64DTV video output can be emulated with "Old
 
3685
Luminances".
 
3686
 
 
3687
   The default setting is "New Luminances".
 
3688
 
 
3689
 
 
3690
File: vice.info,  Node: Userport,  Next: Debug,  Prev: LumaFix,  Up: C64DTV-specific
 
3691
 
 
3692
7.2.4 Userport
 
3693
--------------
 
3694
 
 
3695
The C64DTV userport emulation currently supports three devices: Hummer
 
3696
ADC, userport joystick and PS/2 mouse.
 
3697
 
 
3698
   The joystick that controls either the Hummer ADC or userport joystick
 
3699
can be selected using the same parameter or menu option.
 
3700
 
 
3701
   While using the Hummer ADC, joystick UP and DOWN are mapped to the
 
3702
Hummer buttons A and B respectively. LEFT and RIGHT set the ADCs output
 
3703
to 0 and 255. Centering the joystick results in the ADC value of 128.
 
3704
 
 
3705
   Currently the Hummer ADC and userport joystick are mutually
 
3706
exclusive.  This means that enabling one disables the other. PS/2 mouse
 
3707
emulation can be used simultaneously with either Hummer ADC or userport
 
3708
joystick.
 
3709
 
 
3710
`-hummerusrdev DEVICE'
 
3711
     Select Hummer Userport device (0: None, 1: ADC, 2: Joystick)
 
3712
 
 
3713
`-hummerusrjoyport PORT'
 
3714
     Select which joystick port should be mapped to the userport
 
3715
 
 
3716
`-ps2mouse'
 
3717
`+ps2mouse'
 
3718
     Enable or disable PS/2 mouse on userport
 
3719
 
 
3720
 
 
3721
 
 
3722
File: vice.info,  Node: Debug,  Next: Monitor DTV features,  Prev: Userport,  Up: C64DTV-specific
 
3723
 
 
3724
7.2.5 Debug
 
3725
-----------
 
3726
 
 
3727
Debugging information on Blitter, DMA and Flash can be enabled with
 
3728
command line parameters. This can be useful for DTV software
 
3729
development.
 
3730
 
 
3731
`-dtvblitterlog'
 
3732
`+dtvblitterlog'
 
3733
     Enable or disable DTV Blitter log
 
3734
 
 
3735
`-dtvdmalog'
 
3736
`+dtvdmalog'
 
3737
     Enable or disable DTV DMA log
 
3738
 
 
3739
`-dtvflashlog'
 
3740
`+dtvflashlog'
 
3741
     Enable or disable DTV Flash log
 
3742
 
 
3743
 
 
3744
 
 
3745
File: vice.info,  Node: Monitor DTV features,  Prev: Debug,  Up: C64DTV-specific
 
3746
 
 
3747
7.2.6 Monitor DTV features
 
3748
--------------------------
 
3749
 
 
3750
Currently the registers A, Y and X are registers R0, R1 and R2
 
3751
regardless of the mapping, which can be seen and modified via the
 
3752
registers ACM and XYM.
 
3753
 
 
3754
   The monitor can access all 2MB of RAM and 2MB of Flash, but only 64
 
3755
kB at a time.  The 64kB bank can be selected with "bank ram00".."ram1f"
 
3756
for RAM and "bank rom00".."rom1f" for Flash.
 
3757
 
 
3758
   The "load" command can load large files (>64kB) correctly if the
 
3759
bank is set to "ramXX", where XX is the starting bank (usually
 
3760
"bank00").
 
3761
 
 
3762
 
 
3763
File: vice.info,  Node: VIC20-specific,  Next: PET-specific,  Prev: C64DTV-specific,  Up: Machine-specific features
 
3764
 
 
3765
7.3 VIC20-specific commands and settings
3549
3766
========================================
3550
3767
 
3551
3768
This section lists the settings and commands that are VIC20-specific and
3560
3777
 
3561
3778
File: vice.info,  Node: VIC20 cartridges,  Next: VIC20 memory expansions,  Prev: VIC20-specific,  Up: VIC20-specific
3562
3779
 
3563
 
7.2.1 Using cartridge images
 
3780
7.3.1 Using cartridge images
3564
3781
----------------------------
3565
3782
 
3566
3783
As with the C64 (*note C64 cartridges::), it is possible to attach
3603
3820
 
3604
3821
File: vice.info,  Node: VIC20 memory expansions,  Next: VIC20 system ROM settings,  Prev: VIC20 cartridges,  Up: VIC20-specific
3605
3822
 
3606
 
7.2.2 Changing memory configuration
 
3823
7.3.2 Changing memory configuration
3607
3824
-----------------------------------
3608
3825
 
3609
3826
It is possible to change the VIC20 memory configuration in two ways: by
3659
3876
 
3660
3877
File: vice.info,  Node: VIC20 memconf resources,  Next: VIC20 memconf options,  Prev: VIC20 memory expansions,  Up: VIC20 memory expansions
3661
3878
 
3662
 
7.2.2.1 VIC20 memory configuration resources
 
3879
7.3.2.1 VIC20 memory configuration resources
3663
3880
............................................
3664
3881
 
3665
3882
`RAMBlock0'
3678
3895
 
3679
3896
File: vice.info,  Node: VIC20 memconf options,  Prev: VIC20 memconf resources,  Up: VIC20 memory expansions
3680
3897
 
3681
 
7.2.2.2 VIC20 memory configuration command-line options
 
3898
7.3.2.2 VIC20 memory configuration command-line options
3682
3899
.......................................................
3683
3900
 
3684
3901
`-memory CONFIG'
3725
3942
 
3726
3943
File: vice.info,  Node: VIC20 system ROM settings,  Prev: VIC20 memory expansions,  Up: VIC20-specific
3727
3944
 
3728
 
7.2.3 VIC20 system ROM settings
 
3945
7.3.3 VIC20 system ROM settings
3729
3946
-------------------------------
3730
3947
 
3731
3948
These settings can be used to control what system ROMs are loaded in the
3739
3956
 
3740
3957
File: vice.info,  Node: VIC20 system ROM resources,  Next: VIC20 system ROM options,  Prev: VIC20 system ROM settings,  Up: VIC20 system ROM settings
3741
3958
 
3742
 
7.2.3.1 VIC20 system ROM resources
 
3959
7.3.3.1 VIC20 system ROM resources
3743
3960
..................................
3744
3961
 
3745
3962
`KernalName'
3763
3980
 
3764
3981
File: vice.info,  Node: VIC20 system ROM options,  Prev: VIC20 system ROM resources,  Up: VIC20 system ROM settings
3765
3982
 
3766
 
7.2.3.2 VIC20 system ROM command-line options
 
3983
7.3.3.2 VIC20 system ROM command-line options
3767
3984
.............................................
3768
3985
 
3769
3986
`-kernal NAME'
3787
4004
 
3788
4005
File: vice.info,  Node: PET-specific,  Next: CBM-II-specific,  Prev: VIC20-specific,  Up: Machine-specific features
3789
4006
 
3790
 
7.3 PET-specific commands and settings
 
4007
7.4 PET-specific commands and settings
3791
4008
======================================
3792
4009
 
3793
4010
This section lists the settings and commands that are PET-specific and
3803
4020
 
3804
4021
File: vice.info,  Node: PET model,  Next: PET diagnostic pin,  Prev: PET-specific,  Up: PET-specific
3805
4022
 
3806
 
7.3.1 Changing PET model settings
 
4023
7.4.1 Changing PET model settings
3807
4024
---------------------------------
3808
4025
 
3809
4026
With `xpet', it is possible to change at runtime the characteristics of
3918
4135
 
3919
4136
File: vice.info,  Node: PET diagnostic pin,  Next: PET commandline options,  Prev: PET model,  Up: PET-specific
3920
4137
 
3921
 
7.3.2 The PET diagnostic pin
 
4138
7.4.2 The PET diagnostic pin
3922
4139
----------------------------
3923
4140
 
3924
4141
It is possible to enable or disable emulation of the PET diagnostic pin
3931
4148
 
3932
4149
File: vice.info,  Node: PET commandline options,  Next: PET colors,  Prev: PET diagnostic pin,  Up: PET-specific
3933
4150
 
3934
 
7.3.3 PET command line options
 
4151
7.4.3 PET command line options
3935
4152
------------------------------
3936
4153
 
3937
4154
These are the commandline options specific for the CBM-II models.
3983
4200
 
3984
4201
File: vice.info,  Node: PET colors,  Prev: PET commandline options,  Up: PET-specific
3985
4202
 
3986
 
7.3.4 Changing screen colors
 
4203
7.4.4 Changing screen colors
3987
4204
----------------------------
3988
4205
 
3989
4206
It is also possible to choose what color set is used for the emulation
4001
4218
 
4002
4219
File: vice.info,  Node: CBM-II-specific,  Prev: PET-specific,  Up: Machine-specific features
4003
4220
 
4004
 
7.4 CBM-II-specific commands and settings
 
4221
7.5 CBM-II-specific commands and settings
4005
4222
=========================================
4006
4223
 
4007
4224
This section lists the settings and commands that are CBM-II-specific
4016
4233
 
4017
4234
File: vice.info,  Node: CBM-II model,  Next: CBM-II commandline options,  Prev: CBM-II-specific,  Up: CBM-II-specific
4018
4235
 
4019
 
7.4.1 Changing CBM-II model
 
4236
7.5.1 Changing CBM-II model
4020
4237
---------------------------
4021
4238
 
4022
4239
With `xcbm2', it is possible to change at runtime the characteristics
4084
4301
 
4085
4302
File: vice.info,  Node: CBM-II commandline options,  Next: CBM-II colors,  Prev: CBM-II model,  Up: CBM-II-specific
4086
4303
 
4087
 
7.4.2 CBM-II command line options
 
4304
7.5.2 CBM-II command line options
4088
4305
---------------------------------
4089
4306
 
4090
4307
These are the commandline options specific for the CBM-II models.
4119
4336
 
4120
4337
File: vice.info,  Node: CBM-II colors,  Prev: CBM-II commandline options,  Up: CBM-II-specific
4121
4338
 
4122
 
7.4.3 Changing screen colors
 
4339
7.5.3 Changing screen colors
4123
4340
----------------------------
4124
4341
 
4125
4342
It is also possible to choose what color set is used for the emulation
5238
5455
     Watchpoints are triggered by a read and/or write to an address.
5239
5456
     When a watchpoint is triggered, the monitor is entered.
5240
5457
 
 
5458
`memmap'
 
5459
     The memmap keeps track of RAM/ROM/IO read/write/execute accesses.
 
5460
     The feature must be enabled with "-enable-memmap" configure
 
5461
     option, as it might decrease performance notably on slower
 
5462
     hardware. The option also enables CPU history.
 
5463
 
5241
5464
`<...>'
5242
5465
     A data type.
5243
5466
 
5254
5477
9.2 Machine state commands
5255
5478
==========================
5256
5479
 
 
5480
`backtrace'
 
5481
     Print JSR call chain (most recent call first). Stack offset
 
5482
     relative to SP+1 is printed in parentheses. This is a best guess
 
5483
     only.
 
5484
 
 
5485
`cpuhistory [<count>]'
 
5486
     Show <count> last executed commands.  (disabled by default;
 
5487
     configure with -enable-memmap to enable)
 
5488
 
5257
5489
`goto <address>'
5258
5490
     Change the PC to address and continue execution.
5259
5491
 
5268
5500
     Assign respective registers.  With no parameters, display register
5269
5501
     values.
5270
5502
 
 
5503
`reset [<type>]'
 
5504
     Reset the machine or drive.  `type': 0 = soft, 1 = hard, 8-11 =
 
5505
     drive.
 
5506
 
5271
5507
`return'
5272
5508
     Continues execution  and returns to the monitor just after the
5273
5509
     next RTS or RTI is executed.
5309
5545
     Hunt memory in the specified address range for the data in
5310
5546
     <data_list>.  If the data is found, the starting address of the
5311
5547
     match is displayed.  The entire range is searched for all possible
5312
 
     matches.
 
5548
     matches.  The data list may have `xx' as a wildcard.
5313
5549
 
5314
5550
`i <address_opt_range>'
5315
5551
     Display memory contents as PETSCII text.
5316
5552
 
 
5553
`ii <address_opt_range>'
 
5554
     Display memory contents as screen code text
 
5555
 
5317
5556
`m [<data_type>] [<address_opt_range>]'
5318
5557
     Display the contents of memory.  If no datatype is given, the
5319
5558
     default is used.  If only one address is specified, the length of
5320
5559
     data displayed is based on the datatype.  If no addresses are
5321
5560
     given, the 'dot' address is used.
5322
5561
 
 
5562
`memmapshow [<mask>] [<address_opt_range>]'
 
5563
     Show the memmap. The mask can be specified to show only those
 
5564
     locations with accesses of certain type(s). The mask is a number
 
5565
     with the bits "ioRWXrwx", where RWX are for ROM and rwx for RAM.
 
5566
     Optionally, an address range can be specified.  (disabled by
 
5567
     default; configure with -enable-memmap to enable)
 
5568
 
 
5569
`memmapzap'
 
5570
     Clear the memmap.  (disabled by default; configure with
 
5571
     -enable-memmap to enable)
 
5572
 
 
5573
`memmapsave "<filename>" <format>'
 
5574
     Save the memmap as a picture. `format': 0 = BMP, 1 = PCX, 2 = PNG,
 
5575
     3 = GIF, 4 = IFF.  (disabled by default; configure with
 
5576
     -enable-memmap to enable)
 
5577
 
5323
5578
`mc [<data_type>] [<address_opt_range>]'
5324
5579
     Display the contents of memory as character data.  If only one
5325
5580
     address is specified, only one character is displayed.  If no
5434
5689
     Set the default memory device to either the computer (`c:') or the
5435
5690
     disk (`d:').
5436
5691
 
 
5692
`dir [<directory>]'
 
5693
     Display the directory contents.
 
5694
 
 
5695
`pwd'
 
5696
     Show current working directory.
 
5697
 
5437
5698
`radix [H|D|O|B]'
5438
5699
     Set the default radix to hex, decimal, octal, or binary.  With no
5439
5700
     argument, the current radix is printed.
5455
5716
9.7 Disk commands
5456
5717
=================
5457
5718
 
 
5719
`attach <filename> <device>'
 
5720
     Attach file to device. (device 32 = cart)
 
5721
 
5458
5722
`br <track> <sector> [<address>]'
5459
5723
     Read the block at the specified track and sector.  If an address is
5460
5724
     specified, the data is loaded into memory.  If no address is given,
5464
5728
     Write a block of data at `address' to the specified track and
5465
5729
     sector of disk in drive 8.
5466
5730
 
 
5731
`detach <device>'
 
5732
     Detach file from device. (device 32 = cart)
 
5733
 
5467
5734
`@<disk command>'
5468
5735
     Perform a disk command on the currently attached disk image on
5469
5736
     drive 8.  The specified disk command is sent to the drive's
5477
5744
     are skipped.  If device is 0, the file is read from the file
5478
5745
     system.
5479
5746
 
 
5747
`bload "<filename>" <device> <address>'
 
5748
     Load the specified file into memory at the specified address.  If
 
5749
     device is 0, the file is read from the file system.
 
5750
 
5480
5751
`save "<filename>" <device> <address1> <address2>'
5481
5752
     Save the memory from address1 to address2 to the specified file.
 
5753
     Write two-byte load address.  If device is 0, the file is written
 
5754
     to the file system.
 
5755
 
 
5756
`bsave "<filename>" <device> <address1> <address2>'
 
5757
     Save the memory from address1 to address2 to the specified file.
5482
5758
     If device is 0, the file is written to the file system.
5483
5759
 
5484
5760
 
5519
5795
     Load a file containing a mapping of labels to addresses.  If no
5520
5796
     memory space is specified, the default readspace is used.
5521
5797
 
 
5798
     The file must contain commands the monitor understands, e.g.
 
5799
     add_label. The compiler cc65 can create such label files.
 
5800
 
 
5801
     Vice can also load label files created by the Acme assembler.
 
5802
     Their syntax is e.g. "labelname = $1234 ; Maybe a comment". A dot
 
5803
     will be added automatically to label names assigned in this way to
 
5804
     fit to the Vice label syntax. Normally the semicolon seperates
 
5805
     commands but after an assignment of this kind it may be used to
 
5806
     start a comment to end of line, so unchanged Acme label files can
 
5807
     be fed into Vice.
 
5808
 
5522
5809
`save_labels [<memspace>] "<filename>"'
5523
5810
     Save labels to a file.  If no memory space is specified, all of the
5524
5811
     labels are saved.
5534
5821
9.10 Miscellaneous commands
5535
5822
===========================
5536
5823
 
 
5824
`cartfreeze'
 
5825
     Use cartridge freeze.
 
5826
 
5537
5827
`exit'
5538
5828
     Leave the monitor and return to execution.
5539
5829
 
 
5830
`help [<command>]'
 
5831
     If no argument is given, prints out a list of all available
 
5832
     commands.  If an argument is given, prints out specific help for
 
5833
     that command.
 
5834
 
5540
5835
`print <expression>'
5541
5836
     Evaluate the specified expression and output the result.
5542
5837
 
 
5838
`resourceget "<resource>"'
 
5839
     Displays the value of the `resource'.
 
5840
 
 
5841
`resourceset "<resource>" "<value>"'
 
5842
     Sets the value of the `resource'.
 
5843
 
 
5844
`screenshot "<filename>" [<format>]'
 
5845
     Take a screenshot. `format': default = BMP, 1 = PCX, 2 = PNG, 3 =
 
5846
     GIF, 4 = IFF.
 
5847
 
 
5848
`tapectrl <command>'
 
5849
     Control the datasette. `command': 0 = stop, 1 = start, 2 =
 
5850
     forward, 3 = rewind, 4 = record, 5 = reset, 6 = reset counter.
 
5851
 
5543
5852
`quit'
5544
5853
     Exit the emulator immediately.
5545
5854
 
6151
6460
     emulation and some ui stuff in the Win32 and MSDOS port. He also
6152
6461
     wrote the BeOS port and implemented video/audio capture support.
6153
6462
     Improved history recording/playback and implented support for
6154
 
     video recording and netlink feature. Various bug(fixe)s. ;-)
 
6463
     video recording and netlink feature. Made the win32 user changable
 
6464
     keyboard shortcut system. Various bug(fixe)s. ;-)
6155
6465
 
6156
6466
   * Martin Pottendorfer Implemented Gnome Port based on Oliver
6157
6467
     Schaertels GTK+ port Added support code for internationalization
6158
 
     based on gettext Translated the Unix Port to German Implemented
6159
 
     the fliplists + ui (unix).
 
6468
     based on gettext Improved the *nix fullscreen support Translated
 
6469
     the Unix Port to German Implemented the fliplists + ui (unix).
6160
6470
 
6161
6471
   * Spiro Trikaliotis wrote the Win32 console implementation for the
6162
 
     built-in monitor, corrected some REU related bugs, added support
6163
 
     for the TFE and RR-Net (cs8900a), and wrote some further patches.
 
6472
     built-in monitor, corrected some REU related bugs, improved the
 
6473
     CIA emulation, added com-port CIA support to the win32 port, added
 
6474
     text copy and paste support to the win32 port, added support for
 
6475
     the TFE and RR-Net (cs8900a), and wrote some further patches.
6164
6476
 
6165
6477
   * Markus Brenner added VDC emulation to x128 and added support for
6166
6478
     some more cartridges.
6169
6481
     devices and improved the tape emulation.
6170
6482
 
6171
6483
   * Marco van den Heuvel Translated the UI to Dutch. Made the
6172
 
     internationalization support for the Win32 and Amiga ports. Wrote
 
6484
     Internationalization support for the Win32 and Amiga ports. Wrote
6173
6485
     the GEORAM and RamCart cartridge code. Wrote the c64 +60K, +256K
6174
6486
     and 256K memory expansions code. Wrote the pet REU code. Wrote the
6175
6487
     plus4 memory expansions code. Made the ethernet support for the
6176
 
     Msdos port. Maintains the RiscOS, QNX 6.x, Solaris, GP2X, Minix
6177
 
     3.x, Amiga, ppc-BeOS and newly resurrected OS/2 binary ports.
6178
 
     Added new .crt support. Added new screenshot formats.  Added new
6179
 
     sound recording support. Added SIDcart support for pet, plus4 and
6180
 
     vic20. Added digimax support. Improved the MMC64 emulation. Added
6181
 
     2 MHz mode to x128. And lots of other fixes and improvements.
 
6488
     Msdos port.  Maintains the RiscOS, QNX 4.x, QNX 6.x, SkyOS,
 
6489
     Solaris, Openserver, Unixware, HPUX, GP2X, Minix 3.x, Amiga,
 
6490
     ppc-BeOS and newly resurrected OS/2 binary ports. Added new .crt
 
6491
     support. Added new screenshot formats. Added new sound recording
 
6492
     support. Added SIDcart support for pet, plus4 and vic20. Improved
 
6493
     the MMC64 emulation. Added 2 MHz mode for x128. Added the Hummer
 
6494
     userport joystick emulation.  Added text copy and paste support to
 
6495
     the amiga and beos ports. Added DQBB and Isepic cartridge support.
 
6496
     And lots of other fixes and improvements.
6182
6497
 
6183
6498
   * Christian Vogelgsang maintains the Mac OS X port. Added Intel Mac
6184
6499
     support and universal binary creation. Wrote the build scripts for
6185
6500
     all external Mac libraries and the bindist bundle tool. Improved
6186
6501
     the TFE chip emulation. Added some Gtk+ fixes.
6187
6502
 
 
6503
   * Fabrizio Gennari added some improvements to the MSDOS- and GTK
 
6504
     port.
 
6505
 
 
6506
   * Hannu Nuotio implemented DTV flash emulation, DTV support in the
 
6507
     monitor, large parts of the DTV VIC emulation, burst mode and skip
 
6508
     cycle emulation as well as many other things. Added experimental
 
6509
     NEOS and Amiga mouse support. Fixed mouse support for single size
 
6510
     in unix.  Fixed mouse grab and menu popup for xaw. Added new
 
6511
     monitor commands and features. Added the memmap feature. Made MIDI
 
6512
     support and MIDI driver code for *nix.
 
6513
 
 
6514
   * M. Kiesel started implementing x64dtv. The C64DTV memory model and
 
6515
     early versions of the DMA and Blitter engine have been implemented
 
6516
     by him. Added new monitor commands and features.
 
6517
 
 
6518
   * Daniel Kahlin Worked on DTV VIC emulation, palette, DTV SID support
 
6519
     in resid, better DMA/Blitter support and did lots of refactoring.
 
6520
     Added new monitor commands and features. Improved the VIC
 
6521
     emulation for xvic.  Made MIDI driver code for win32.
 
6522
 
6188
6523
 
6189
6524
   Former team members:
6190
6525
 
6347
6682
 
6348
6683
   * ck! provided a win32 cbm character font.
6349
6684
 
6350
 
   * Fabrizio Gennari added some improvements to the MSDOS- and GTK
6351
 
     port.
6352
 
 
6353
6685
   * Dirk Jagdmann wrote the Catweasel sound driver.
6354
6686
 
6355
6687
   * Maciej Witkowiak did some IDE64 and C1541 fixes.
6358
6690
 
6359
6691
   * Rami Rasanen rewrote the VIC20 sound code.
6360
6692
 
6361
 
   * iAN CooG contributed various small patches.
 
6693
   * iAN CooG Added win32 vsid GUI and contributed various small
 
6694
     patches.
6362
6695
 
6363
6696
   * Mike Dawson provided the GP2X port and co-maintains the GP2X ports.
6364
6697
 
6375
6708
   * Ilkka "itix" Lehtoranta provided the routines for the
6376
6709
     cybergraphics support for the Amiga ports.
6377
6710
 
6378
 
   * Wolfgang Moser provided small optimization fixes to the GCR code.
6379
 
 
6380
 
   * Christian Vogelgsang resurrected the Mac OSX X11 port and added
6381
 
     support for an Intel build.
 
6711
   * Wolfgang Moser provided small optimization fixes to the GCR code,
 
6712
     provided an excellent REU test suite and added REU fixes, and is
 
6713
     always the good guy reviewing and commenting changes in the
 
6714
     background.
6382
6715
 
6383
6716
   * Peter Gordon provided support for native AmigaOS4 compiling.
6384
6717
 
6392
6725
   * Gunnar Ruthenberg provided some VIC-II enhancements and improved
6393
6726
     the win32 port.
6394
6727
 
 
6728
   * Groepaz/Hitmen Added new more precise PAL emulation. Added support
 
6729
     for the Action Replay 4 and StarDos cartridges. Provided several
 
6730
     fixes.
 
6731
 
 
6732
   * Ingo Korb Corrected block allocation and interleave for
 
6733
     c1541/vdrive.
 
6734
 
 
6735
   * Georg Feil Added support for toggling CB2 sound output line in the
 
6736
     PET emulator.
 
6737
 
 
6738
   * Greg King Added a working RTC to the emulation of the IDE64
 
6739
     cartridge.
 
6740
 
 
6741
   * Thomas Giesel Added new monitor commands and features.
 
6742
 
 
6743
   * Marcus Sutton Made some console, dialog and joystick fixes for the
 
6744
     BeOS port.
 
6745
 
 
6746
   * Antti Lankila Made the ReSID-fp engine and rewrote the PAL
 
6747
     emulation code.
 
6748
 
 
6749
   * Mustafa 'GnoStiC' Tufan Made improvements to the gp2x port.
 
6750
 
 
6751
   * Ville-Matias Heikkila Rewrote the vic20 sound code.
 
6752
 
6395
6753
 
6396
6754
   * Lutz Sammer
6397
6755
 
6431
6789
13 Copyright
6432
6790
************
6433
6791
 
6434
 
   * Copyright (C) 1998-2007 Andreas Boose
6435
 
 
6436
 
   * Copyright (C) 1998-2007 Dag Lem
6437
 
 
6438
 
   * Copyright (C) 1998-2007 Tibor Biczo
 
6792
   * Copyright (C) 1998-2008 Andreas Boose
 
6793
 
 
6794
   * Copyright (C) 1998-2008 Dag Lem
 
6795
 
 
6796
   * Copyright (C) 1998-2008 Tibor Biczo
 
6797
 
 
6798
   * Copyright (C) 1999-2008 Andreas Matthies
 
6799
 
 
6800
   * Copyright (C) 1999-2008 Martin Pottendorfer
 
6801
 
 
6802
   * Copyright (C) 2000-2008 Spiro Trikaliotis
 
6803
 
 
6804
   * Copyright (C) 2005-2008 Marco van den Heuvel
 
6805
 
 
6806
   * Copyright (C) 2006-2008 Christian Vogelgsang
 
6807
 
 
6808
   * Copyright (C) 2007-2008 Fabrizio Gennari
 
6809
 
 
6810
   * Copyright (C) 2007-2008 M. Kiesel
 
6811
 
 
6812
   * Copyright (C) 2007-2008 Hannu Nuotio
 
6813
 
 
6814
   * Copyright (C) 2007-2008 Daniel Kahlin
6439
6815
 
6440
6816
   * Copyright (C) 1999-2007 Andreas Dehmel
6441
6817
 
6442
 
   * Copyright (C) 1999-2007 Andreas Matthies
6443
 
 
6444
 
   * Copyright (C) 1999-2007 Martin Pottendorfer
6445
 
 
6446
 
   * Copyright (C) 2000-2007 Spiro Trikaliotis
6447
 
 
6448
 
   * Copyright (C) 2005-2007 Marco van den Heuvel
6449
 
 
6450
 
   * Copyright (C) 2006-2007 Christian Vogelgsang
6451
 
 
6452
6818
   * Copyright (C) 2003-2005 David Hansel
6453
6819
 
6454
6820
   * Copyright (C) 2000-2004 Markus Brenner
6506
6872
 
6507
6873
     http://www.viceteam.org/
6508
6874
 
 
6875
   VICE has moved its source repository to public services provided by
 
6876
SourceForge. You can find it at
 
6877
     http://sf.net/projects/vice-emu.
 
6878
 
 
6879
   We would like to thank the SourceForge staff for that help.
 
6880
 
6509
6881
   If you are going to report a bug, please check those pages _first_;
6510
6882
it is possible that the problem you encountered has already been fixed
6511
6883
with a newer version.
6512
6884
 
 
6885
   Please, also have a look at the VICE knowledge base at
 
6886
 
 
6887
     http://vicekb.trikaliotis.net/
 
6888
 
6513
6889
 
6514
6890
File: vice.info,  Node: Sending feedback,  Next: Contributing,  Prev: Home page,  Up: Contacts
6515
6891
 
6516
6892
14.2 How to send feedback
6517
6893
=========================
6518
6894
 
6519
 
If you want to report bugs, make suggestions or contribute to the
6520
 
project, please email the VICE team mailing list:
 
6895
Before contacting us, have a look at the VICE knowledge base at
 
6896
http://vicekb.trikaliotis.net/ if your question is answered there. Keep
 
6897
in mind that we work on VICE in our spare-time, so the more time we
 
6898
don't need to answer the same questions over and over again, the more
 
6899
time we have to improve the emulation itself. On the other hand, that
 
6900
does not mean that you should not contact us, especially if you find
 
6901
bugs or have suggestions which might improve the emulation.
 
6902
 
 
6903
   Bug reports, suggestions, support requests should be directed to the
 
6904
SourceForge trackers at
 
6905
 
 
6906
   * http://sourceforge.net/tracker/?group_id=223021.
 
6907
 
 
6908
   This way, you, the users, and we, the developers, can track what has
 
6909
been reported and what has been already fixed. Ideally, also sent the
 
6910
report to the mailing address of the Vice team at
6521
6911
 
6522
6912
   * VICE Mailing List (<vice-devel@firenze.linux.it>) for all general
6523
6913
     questions, bug reports, suggestions.
6524
6914
 
6525
6915
 
 
6916
   You can also contact (some of) us on IRC, at #vice-dev on freenode.
 
6917
 
6526
6918
   It's always nice to receive feedback and/or bugreports about VICE,
6527
6919
but please read these few notes before sending mail to anybody in the
6528
6920
team.
6546
6938
        * the VICE FAQ (it is available on the Internet, and reachable
6547
6939
          from the VICE home page: http://www.viceteam.org/);
6548
6940
 
 
6941
        * The VICE knowledge base (it is available on the Internet at
 
6942
          http://vicekb.trikaliotis.net/);
 
6943
 
6549
6944
        * the `comp.emulators.cbm' and `comp.sys.cbm' FAQs (*note FAQs
6550
6945
          you should read::).
6551
6946
 
6557
6952
   * Please don't ask us how to transfer original C64 disk or tapes to
6558
6953
     your PC; this has been asked a gazillion times through email.  To
6559
6954
     transfer disks, you can use the Star Commander
6560
 
     (http://sta.c64.org/sc.html).  And no, you cannot read C64 disks
6561
 
     with your old 5"1/4 PC drive.
 
6955
     (http://sta.c64.org/sc.html) on DOS, and OpenCBM
 
6956
     (http://www.trikaliotis.net/opencbm) on Windows and Linux.  And
 
6957
     no, you cannot read C64 disks with your old 5"1/4 PC drive.
6562
6958
 
6563
6959
   * Please don't ask us where to find games for the emulator on the
6564
6960
     Internet.
6589
6985
   If you are going to make a patch, please make sure the patch is
6590
6986
relative to the very latest version, and provide us with the following:
6591
6987
 
6592
 
   * a unified diff file containing all the changes you have made `diff
6593
 
     -u' is fine; please don't use plain `diff');
 
6988
   * Make sure you are giving us a diff against the latest Subversion
 
6989
     trunk version of VICE. For instructions on accessing the Subversion
 
6990
     repository, first read http://sourceforge.net/svn/?group_id=223021
 
6991
     and get it with the command:
 
6992
          `svn co https://vice-emu.svn.sourceforge.net/svnroot/vice-emu/trunk vice-src'
 
6993
 
 
6994
   * send a unified diff file against the trunk version of VICE (see
 
6995
     above bullet point) by using the command: `svn diff' inside of the
 
6996
     SVN workspace you checked out before.
 
6997
 
 
6998
   * If you cannot use SVN for one or the other reason, send a unified
 
6999
     diff file containing all the changes you have made `diff -u';
 
7000
     please don't use plain `diff'), as it adds much work for us to get
 
7001
     it working;
6594
7002
 
6595
7003
   * GNU-style `ChangeLog' entries with a description of the changes you
6596
7004
     have made (look at the `ChangeLog's provided with the original VICE
6601
7009
 
6602
7010
   People willing to port VICE to other platforms are always welcome.
6603
7011
But notice from experience it will take at least a full year of
6604
 
continious work to write a well working and stable port.
 
7012
continuous work to write a well working and stable port.
6605
7013
 
6606
7014
 
6607
7015
File: vice.info,  Node: Newsgroups,  Next: FAQs you should read,  Prev: Contributing,  Up: Contacts
6678
7086
                                                               (line 35)
6679
7087
* -bdesymkeymap -bdeposkeymap:           Keyboard options.     (line 29)
6680
7088
* -buksymkeymap -bukposkeymap:           Keyboard options.     (line 17)
 
7089
* -c64dtvromimage:                       C64DTV ROM image.     (line 28)
 
7090
* -c64dtvromrw, +c64dtvromrw:            C64DTV ROM image.     (line 31)
6681
7091
* -cart2 <1>:                            CBM-II commandline options.
6682
7092
                                                               (line 22)
6683
7093
* -cart2:                                VIC20 system ROM options.
6722
7132
* -drivesync:                            Drive options.        (line 43)
6723
7133
* -dscan, +dscan:                        Video options.        (line 15)
6724
7134
* -dsize, +dsize:                        Video options.        (line 10)
 
7135
* -dtvblitterlog, +dtvblitterlog:        Debug.                (line 10)
 
7136
* -dtvdmalog, +dtvdmalog:                Debug.                (line 14)
 
7137
* -dtvflashlog, +dtvflashlog:            Debug.                (line 18)
 
7138
* -dtvrev:                               DTV revision.         (line 10)
6725
7139
* -editor:                               PET commandline options.
6726
7140
                                                               (line 14)
6727
7141
* -emuid, +emuid <1>:                    PET commandline options.
6740
7154
                                                               (line  6)
6741
7155
* -fs9:                                  File system device options.
6742
7156
                                                               (line  7)
 
7157
* -fsflash:                              C64DTV ROM image.     (line 44)
6743
7158
* -grsymkeymap -grposkeymap:             Keyboard options.     (line 23)
6744
7159
* -help:                                 Command-line initialization.
6745
7160
                                                               (line 12)
6746
7161
* -htmlbrowser:                          Misc options.         (line  7)
 
7162
* -hummerusrdev:                         Userport.             (line 21)
 
7163
* -hummerusrjoyport:                     Userport.             (line 24)
6747
7164
* -ieee488, +ieee488:                    C64 I/O extension options.
6748
7165
                                                               (line  6)
6749
7166
* -install, +install:                    Video options.        (line 33)
6769
7186
                                                               (line  8)
6770
7187
* -modelline:                            CBM-II commandline options.
6771
7188
                                                               (line 31)
 
7189
* -moncommand:                           Monitor options.      (line  6)
6772
7190
* -ntscdrive:                            Drive options.        (line 39)
6773
7191
* -paldrive:                             Drive options.        (line 35)
6774
7192
* -palette, -crtcpalette:                Video options.        (line 41)
6786
7204
* -printer4, +printer4:                  Printer options.      (line 12)
6787
7205
* -pruser, +pruser:                      Printer options.      (line 20)
6788
7206
* -pruserdev:                            Printer options.      (line 25)
 
7207
* -ps2mouse, +ps2mouse:                  Userport.             (line 27)
6789
7208
* -ram08:                                CBM-II commandline options.
6790
7209
                                                               (line 26)
6791
7210
* -ram1:                                 CBM-II commandline options.
6836
7255
                                                               (line 28)
6837
7256
* -symkeymap:                            Keyboard options.     (line 11)
6838
7257
* -truedrive, +truedrive:                Drive options.        (line  6)
 
7258
* -trueflashfs, +trueflashfs:            C64DTV ROM image.     (line 40)
6839
7259
* -usevicii +usevicii:                   CBM-II commandline options.
6840
7260
                                                               (line  8)
6841
7261
* -vcache, +vcache:                      Video options.        (line  6)
7081
7501
 
7082
7502
 
7083
7503
Tag Table:
7084
 
Node: Top609
7085
 
Node: License1907
7086
 
Node: Preface21047
7087
 
Node: C64 emulator features22617
7088
 
Node: C128 emulator features23595
7089
 
Node: VIC20 emulator features24053
7090
 
Node: PET emulator features24974
7091
 
Node: CBM-II emulator features27919
7092
 
Node: Keyboard emulation30341
7093
 
Node: Joystick emulation32674
7094
 
Node: Disk drive emulation33395
7095
 
Node: Supported file formats39725
7096
 
Node: Common problems40766
7097
 
Node: Sound problems41099
7098
 
Node: Shared memory problems42291
7099
 
Node: Printer problems43557
7100
 
Node: PET keyboard problems44437
7101
 
Node: Usage45194
7102
 
Node: Command-line initialization46069
7103
 
Node: Command-line autostart47125
7104
 
Node: System files48436
7105
 
Node: ROM files50605
7106
 
Node: Keymap files56828
7107
 
Node: Palette files59569
7108
 
Node: Romset files60807
7109
 
Node: Basics61601
7110
 
Node: Emulation window62205
7111
 
Node: Menus63453
7112
 
Node: Help65030
7113
 
Node: File Selector65680
7114
 
Node: Disk and tape images66972
7115
 
Node: Previewing contents69169
7116
 
Node: Autostart69881
7117
 
Node: Compressed files70945
7118
 
Node: Zipcode and Lynx72281
7119
 
Node: Reset73686
7120
 
Node: Settings and resources74702
7121
 
Node: Resource files76983
7122
 
Node: Resources and command-line78510
7123
 
Node: Performance settings79781
7124
 
Node: Performance resources81415
7125
 
Node: Performance options81961
7126
 
Node: Video settings82568
7127
 
Node: Video resources84275
7128
 
Node: Video options86175
7129
 
Node: Keyboard settings87243
7130
 
Node: Keyboard resources87958
7131
 
Node: Keyboard options89392
7132
 
Node: Sound settings90515
7133
 
Node: Sound resources92399
7134
 
Node: Sound options95184
7135
 
Node: Drive settings95900
7136
 
Node: Drive resources100417
7137
 
Node: Drive options101717
7138
 
Node: Peripheral settings103280
7139
 
Node: File system device settings103964
7140
 
Node: File system device resources105837
7141
 
Node: File system device options106924
7142
 
Node: Printer settings107379
7143
 
Node: Printer resources108843
7144
 
Node: Printer options109573
7145
 
Node: No kernal traps110255
7146
 
Node: No traps resources110796
7147
 
Node: No traps options111269
7148
 
Node: RS232 settings111586
7149
 
Node: RS232 resources114521
7150
 
Node: RS232 options115761
7151
 
Node: RS232 usage116771
7152
 
Node: Misc settings118533
7153
 
Node: Misc resources118808
7154
 
Node: Misc options121384
7155
 
Node: Machine-specific features122129
7156
 
Node: C64/128-specific122750
7157
 
Node: C64 cartridges123462
7158
 
Node: VIC-II settings125054
7159
 
Node: VIC-II resources126652
7160
 
Node: VIC-II options127055
7161
 
Node: SID settings127542
7162
 
Node: SID resources130660
7163
 
Node: SID options131504
7164
 
Node: C64 I/O extension settings132505
7165
 
Node: C64 I/O extension resources133802
7166
 
Node: C64 I/O extension options134341
7167
 
Node: C64/128 system ROM settings134890
7168
 
Node: C64/128 system ROM resources135290
7169
 
Node: C64/128 system ROM options136521
7170
 
Node: VIC20-specific137048
7171
 
Node: VIC20 cartridges137459
7172
 
Node: VIC20 memory expansions139274
7173
 
Node: VIC20 memconf resources141081
7174
 
Node: VIC20 memconf options141562
7175
 
Node: VIC20 system ROM settings142698
7176
 
Node: VIC20 system ROM resources143080
7177
 
Node: VIC20 system ROM options143747
7178
 
Node: PET-specific144374
7179
 
Node: PET model144779
7180
 
Node: PET diagnostic pin147869
7181
 
Node: PET commandline options148350
7182
 
Node: PET colors149818
7183
 
Node: CBM-II-specific150389
7184
 
Node: CBM-II model150766
7185
 
Node: CBM-II commandline options153064
7186
 
Node: CBM-II colors154140
7187
 
Node: Snapshots154719
7188
 
Node: Snapshot usage155137
7189
 
Node: Snapshot format156049
7190
 
Node: Emulator modules156386
7191
 
Node: x64 modules156751
7192
 
Node: x128 modules158543
7193
 
Node: xvic modules160249
7194
 
Node: xpet modules161246
7195
 
Node: xcbm2 modules162614
7196
 
Node: Drive modules164545
7197
 
Node: Module formats164963
7198
 
Node: Module Terminology165845
7199
 
Node: Module framework166581
7200
 
Node: CPU 6502 module168388
7201
 
Node: CIA 6526 module169851
7202
 
Node: VIA 6522 module173311
7203
 
Node: PIA 6520 module175182
7204
 
Node: TPI 6525 module176139
7205
 
Node: RIOT 6532 module177504
7206
 
Node: SID 6581 module178944
7207
 
Node: ACIA 6551 module179148
7208
 
Node: VIC-I module180541
7209
 
Node: VIC-II module180745
7210
 
Node: CRTC module180946
7211
 
Node: C64 memory module187043
7212
 
Node: C128 memory module188334
7213
 
Node: VIC20 memory module189551
7214
 
Node: PET memory module192959
7215
 
Node: CBM-II memory module197173
7216
 
Node: C500 data module201201
7217
 
Node: Monitor201630
7218
 
Node: Terminology202473
7219
 
Node: Machine state commands204692
7220
 
Node: Memory commands205504
7221
 
Node: Assembly commands208354
7222
 
Node: Checkpoint commands209106
7223
 
Node: General commands211520
7224
 
Node: Disk commands212381
7225
 
Node: Command file commands213649
7226
 
Node: Label commands214181
7227
 
Node: Miscellaneous commands215080
7228
 
Node: c1541215492
7229
 
Node: c1541 file specification217068
7230
 
Node: c1541 quoting217672
7231
 
Node: c1541 commands and options218523
7232
 
Node: c1541 executing shell commands221708
7233
 
Node: File formats222111
7234
 
Node: T64222481
7235
 
Node: T64 file structure222893
7236
 
Node: T64 tape record223359
7237
 
Node: T64 file record224157
7238
 
Node: G64225417
7239
 
Node: Acknowledgments239411
7240
 
Node: Copyright250299
7241
 
Node: Contacts251924
7242
 
Node: Home page252436
7243
 
Node: Sending feedback252840
7244
 
Node: Contributing255190
7245
 
Node: Newsgroups256309
7246
 
Node: FAQs you should read256948
7247
 
Node: Concept Index257270
7248
 
Node: Resource Index278307
 
7504
Node: Top605
 
7505
Node: License1902
 
7506
Node: Preface21042
 
7507
Node: C64 emulator features22657
 
7508
Node: C64DTV emulator features23672
 
7509
Node: C128 emulator features24300
 
7510
Node: VIC20 emulator features24713
 
7511
Node: PET emulator features25634
 
7512
Node: CBM-II emulator features28579
 
7513
Node: Keyboard emulation31001
 
7514
Node: Joystick emulation33334
 
7515
Node: Disk drive emulation34055
 
7516
Node: Supported file formats40385
 
7517
Node: Common problems41428
 
7518
Node: Sound problems41761
 
7519
Node: Shared memory problems42953
 
7520
Node: Printer problems44219
 
7521
Node: PET keyboard problems45099
 
7522
Node: Usage45856
 
7523
Node: Command-line initialization46767
 
7524
Node: Command-line autostart47823
 
7525
Node: System files49134
 
7526
Node: ROM files51303
 
7527
Node: Keymap files57526
 
7528
Node: Palette files60267
 
7529
Node: Romset files61505
 
7530
Node: Basics62299
 
7531
Node: Emulation window62903
 
7532
Node: Menus64151
 
7533
Node: Help65728
 
7534
Node: File Selector66378
 
7535
Node: Disk and tape images67670
 
7536
Node: Previewing contents69867
 
7537
Node: Autostart70579
 
7538
Node: Compressed files71643
 
7539
Node: Zipcode and Lynx72979
 
7540
Node: Reset74384
 
7541
Node: Settings and resources75400
 
7542
Node: Resource files77748
 
7543
Node: Resources and command-line79275
 
7544
Node: Performance settings80546
 
7545
Node: Performance resources82180
 
7546
Node: Performance options82726
 
7547
Node: Video settings83333
 
7548
Node: Video resources85040
 
7549
Node: Video options86940
 
7550
Node: Keyboard settings88008
 
7551
Node: Keyboard resources88723
 
7552
Node: Keyboard options90157
 
7553
Node: Sound settings91280
 
7554
Node: Sound resources93164
 
7555
Node: Sound options95949
 
7556
Node: Drive settings96665
 
7557
Node: Drive resources101182
 
7558
Node: Drive options102482
 
7559
Node: Peripheral settings104045
 
7560
Node: File system device settings104729
 
7561
Node: File system device resources106602
 
7562
Node: File system device options107689
 
7563
Node: Printer settings108144
 
7564
Node: Printer resources109608
 
7565
Node: Printer options110338
 
7566
Node: No kernal traps111020
 
7567
Node: No traps resources111561
 
7568
Node: No traps options112034
 
7569
Node: RS232 settings112351
 
7570
Node: RS232 resources115289
 
7571
Node: RS232 options116529
 
7572
Node: RS232 usage117539
 
7573
Node: Monitor settings119301
 
7574
Node: Monitor options119569
 
7575
Node: Misc settings120137
 
7576
Node: Misc resources120414
 
7577
Node: Misc options122990
 
7578
Node: Machine-specific features123735
 
7579
Node: C64/128-specific124502
 
7580
Node: C64 cartridges125215
 
7581
Node: VIC-II settings126807
 
7582
Node: VIC-II resources128405
 
7583
Node: VIC-II options128808
 
7584
Node: SID settings129295
 
7585
Node: SID resources132413
 
7586
Node: SID options133257
 
7587
Node: C64 I/O extension settings134258
 
7588
Node: C64 I/O extension resources135555
 
7589
Node: C64 I/O extension options136094
 
7590
Node: C64/128 system ROM settings136643
 
7591
Node: C64/128 system ROM resources137043
 
7592
Node: C64/128 system ROM options138274
 
7593
Node: C64DTV-specific138801
 
7594
Node: C64DTV ROM image139237
 
7595
Node: DTV revision140786
 
7596
Node: LumaFix141153
 
7597
Node: Userport141647
 
7598
Node: Debug142692
 
7599
Node: Monitor DTV features143166
 
7600
Node: VIC20-specific143790
 
7601
Node: VIC20 cartridges144200
 
7602
Node: VIC20 memory expansions146015
 
7603
Node: VIC20 memconf resources147822
 
7604
Node: VIC20 memconf options148303
 
7605
Node: VIC20 system ROM settings149439
 
7606
Node: VIC20 system ROM resources149821
 
7607
Node: VIC20 system ROM options150488
 
7608
Node: PET-specific151115
 
7609
Node: PET model151520
 
7610
Node: PET diagnostic pin154610
 
7611
Node: PET commandline options155091
 
7612
Node: PET colors156559
 
7613
Node: CBM-II-specific157130
 
7614
Node: CBM-II model157507
 
7615
Node: CBM-II commandline options159805
 
7616
Node: CBM-II colors160881
 
7617
Node: Snapshots161460
 
7618
Node: Snapshot usage161878
 
7619
Node: Snapshot format162790
 
7620
Node: Emulator modules163127
 
7621
Node: x64 modules163492
 
7622
Node: x128 modules165284
 
7623
Node: xvic modules166990
 
7624
Node: xpet modules167987
 
7625
Node: xcbm2 modules169355
 
7626
Node: Drive modules171286
 
7627
Node: Module formats171704
 
7628
Node: Module Terminology172586
 
7629
Node: Module framework173322
 
7630
Node: CPU 6502 module175129
 
7631
Node: CIA 6526 module176592
 
7632
Node: VIA 6522 module180052
 
7633
Node: PIA 6520 module181923
 
7634
Node: TPI 6525 module182880
 
7635
Node: RIOT 6532 module184245
 
7636
Node: SID 6581 module185685
 
7637
Node: ACIA 6551 module185889
 
7638
Node: VIC-I module187282
 
7639
Node: VIC-II module187486
 
7640
Node: CRTC module187687
 
7641
Node: C64 memory module193784
 
7642
Node: C128 memory module195075
 
7643
Node: VIC20 memory module196292
 
7644
Node: PET memory module199700
 
7645
Node: CBM-II memory module203914
 
7646
Node: C500 data module207942
 
7647
Node: Monitor208371
 
7648
Node: Terminology209214
 
7649
Node: Machine state commands211695
 
7650
Node: Memory commands212900
 
7651
Node: Assembly commands216547
 
7652
Node: Checkpoint commands217299
 
7653
Node: General commands219713
 
7654
Node: Disk commands220676
 
7655
Node: Command file commands222477
 
7656
Node: Label commands223009
 
7657
Node: Miscellaneous commands224480
 
7658
Node: c1541225537
 
7659
Node: c1541 file specification227113
 
7660
Node: c1541 quoting227717
 
7661
Node: c1541 commands and options228568
 
7662
Node: c1541 executing shell commands231753
 
7663
Node: File formats232156
 
7664
Node: T64232526
 
7665
Node: T64 file structure232938
 
7666
Node: T64 tape record233404
 
7667
Node: T64 file record234202
 
7668
Node: G64235462
 
7669
Node: Acknowledgments249456
 
7670
Node: Copyright262548
 
7671
Node: Contacts264347
 
7672
Node: Home page264859
 
7673
Node: Sending feedback265565
 
7674
Node: Contributing268886
 
7675
Node: Newsgroups270633
 
7676
Node: FAQs you should read271272
 
7677
Node: Concept Index271594
 
7678
Node: Resource Index293507
7249
7679
 
7250
7680
End Tag Table