Лабораторная работа: Программа к лабораторным работам по цифровой электронике

The DOSBox Team

---------------

Sjoerd v.d. Berg <harekiet>

Peter Veenstra <qbix79>

Ulf Wohlers <finsterr>

Tommy Frцssman <fanskapet>

Dean Beeler <canadacow>

Sebastian Strohhдcker <c2woody>

nick_without_<> @ users.sourceforge.net

GNU GENERAL PUBLIC LICENSE

Version 2, June 1991

Copyright (C) 1989, 1991 Free Software Foundation, Inc.

59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Everyone is permitted to copy and distribute verbatim copies

of this license document, but changing it is not allowed.

Preamble

The licenses for most software are designed to take away your

freedom to share and change it. By contrast, the GNU General Public

License is intended to guarantee your freedom to share and change free

software--to make sure the software is free for all its users. This

General Public License applies to most of the Free Software

Foundation's software and to any other program whose authors commit to

using it. (Some other Free Software Foundation software is covered by

the GNU Library General Public License instead.) You can apply it to

your programs, too.

When we speak of free software, we are referring to freedom, not

price. Our General Public Licenses are designed to make sure that you

have the freedom to distribute copies of free software (and charge for

this service if you wish), that you receive source code or can get it

if you want it, that you can change the software or use pieces of it

in new free programs; and that you know you can do these things.

To protect your rights, we need to make restrictions that forbid

anyone to deny you these rights or to ask you to surrender the rights.

These restrictions translate to certain responsibilities for you if you

distribute copies of the software, or if you modify it.

For example, if you distribute copies of such a program, whether

gratis or for a fee, you must give the recipients all the rights that

you have. You must make sure that they, too, receive or can get the

source code. And you must show them these terms so they know their

rights.

We protect your rights with two steps: (1) copyright the software, and

(2) offer you this license which gives you legal permission to copy,

distribute and/or modify the software.

Also, for each author's protection and ours, we want to make certain

that everyone understands that there is no warranty for this free

software. If the software is modified by someone else and passed on, we

want its recipients to know that what they have is not the original, so

that any problems introduced by others will not reflect on the original

authors' reputations.

Finally, any free program is threatened constantly by software

patents. We wish to avoid the danger that redistributors of a free

program will individually obtain patent licenses, in effect making the

program proprietary. To prevent this, we have made it clear that any

patent must be licensed for everyone's free use or not licensed at all.

The precise terms and conditions for copying, distribution and

modification follow.

GNU GENERAL PUBLIC LICENSE

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. This License applies to any program or other work which contains

a notice placed by the copyright holder saying it may be distributed

under the terms of this General Public License. The "Program", below,

refers to any such program or work, and a "work based on the Program"

means either the Program or any derivative work under copyright law:

that is to say, a work containing the Program or a portion of it,

either verbatim or with modifications and/or translated into another

language. (Hereinafter, translation is included without limitation in

the term "modification".) Each licensee is addressed as "you".

Activities other than copying, distribution and modification are not

covered by this License; they are outside its scope. The act of

running the Program is not restricted, and the output from the Program

is covered only if its contents constitute a work based on the

Program (independent of having been made by running the Program).

Whether that is true depends on what the Program does.

1. You may copy and distribute verbatim copies of the Program's

source code as you receive it, in any medium, provided that you

conspicuously and appropriately publish on each copy an appropriate

copyright notice and disclaimer of warranty; keep intact all the

notices that refer to this License and to the absence of any warranty;

and give any other recipients of the Program a copy of this License

along with the Program.

You may charge a fee for the physical act of transferring a copy, and

you may at your option offer warranty protection in exchange for a fee.

2. You may modify your copy or copies of the Program or any portion

of it, thus forming a work based on the Program, and copy and

distribute such modifications or work under the terms of Section 1

above, provided that you also meet all of these conditions:

a) You must cause the modified files to carry prominent notices

stating that you changed the files and the date of any change.

b) You must cause any work that you distribute or publish, that in

whole or in part contains or is derived from the Program or any

part thereof, to be licensed as a whole at no charge to all third

parties under the terms of this License.

c) If the modified program normally reads commands interactively

when run, you must cause it, when started running for such

interactive use in the most ordinary way, to print or display an

announcement including an appropriate copyright notice and a

notice that there is no warranty (or else, saying that you provide

a warranty) and that users may redistribute the program under

these conditions, and telling the user how to view a copy of this

License. (Exception: if the Program itself is interactive but

does not normally print such an announcement, your work based on

the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole. If

identifiable sections of that work are not derived from the Program,

and can be reasonably considered independent and separate works in

themselves, then this License, and its terms, do not apply to those

sections when you distribute them as separate works. But when you

distribute the same sections as part of a whole which is a work based

on the Program, the distribution of the whole must be on the terms of

this License, whose permissions for other licensees extend to the

entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest

your rights to work written entirely by you; rather, the intent is to

exercise the right to control the distribution of derivative or

collective works based on the Program.

In addition, mere aggregation of another work not based on the Program

with the Program (or with a work based on the Program) on a volume of

a storage or distribution medium does not bring the other work under

the scope of this License.

3. You may copy and distribute the Program (or a work based on it,

under Section 2) in object code or executable form under the terms of

Sections 1 and 2 above provided that you also do one of the following:

a) Accompany it with the complete corresponding machine-readable

source code, which must be distributed under the terms of Sections

1 and 2 above on a medium customarily used for software interchange; or,

Things needed for compilation.

SDL

The Simple DirectMedia Library available at http://www.libsdl.org

The dll distributed with the windows version of DOSBox is slightly

modified. You can find the changes in the sourcepackage of DOSBox

(src/platform/sdl-win32.diff). If you want the patched sourcetree

send us an email. (see README)

Licensed under LGPL

Curses (optional)

If you want to enable the debugger you need a curses library.

ncurses should be installed on just about every unix distro.

For win32 get pdcurses at http://pdcurses.sourceforge.net

License: Open source

Libpng (optional)

Needed for the screenshots.

For win32 get libpng from http://gnuwin32.sourceforge.net/packages .html

See http://www.libpng.org/pub/png/ for more details.

License: Open Source

Zlib (optional)

Needed by libpng.

For win32 get libz (rename to zlib) from http://gnuwin32.sourceforge.net/packages .html

See http://www.zlib.net for more details.

License: Open Source

SDL_Net (optional)

For modem/ipx support. Get it from http://www.libsdl.org/projects/SDL_net/

Licensed under LGPL

SDL_Sound

For compressed audio on diskimages. (optional)

This is for cue/bin cdrom images with compressed (mp3/ogg) audio tracks.

Get it from http://icculus.org/SDL_sound

Licenced under LGPL

ALSA_Headers

(optional)

for Alsa support under linux. Part of the linux kernel sources

Licensed under LGPL

If you want compile from the CVS under a unix system, you'll also need

automake (>=1.6), autoconf(>=2.50). Should be available at http://www.gnu.org

For building on unix systems.

If you are building from the cvs run ./autogen.sh first before doing the following.

1. ./configure

2. make

In step 1 you could add the following switches:

--enable-debug

enables the internal debugger. --enable-debug=heavy enables even more

debug options. Dosbox should then be run from a xterm and when the sdl-

window is active press alt-pause to enter the debugger.

--enable-core-inline

enables some memory increasing inlines. This greatly increases

compiletime for maybe a increase in speed.

--disable-fpu

disables the emulated fpu. Although the fpu emulation code isn't

finished and isn't entirely accurate it's advised to leave it on.

--disable-fpu-x86

disables the assembly fpu core. Although relatively new the x86 fpu

core has more accuracy then the regular fpu core.

--disable-dynamic-x86

disables the dynamic x86 specific cpu core. Although it might be

be a bit unstable, it can greatly improve the speed of dosbox on x86

hosts.

Please note that this option on x86 will result in a different

dynamic/recompiling cpu core being compiled then the default.

For more information see the option --disable-dynrec

--disable-dynrec

disables the recompiling cpu core. Currently x86 and x86_64 only.

You can activate this core on x86 by disabling the dynamic-x86 core.

--disable-dynamic-core

disables all dynamic cores. (same effect as

--disable-dynamic-x86 --disable-dynrec)

--disable-unaligned-memory

disables unaligned memory access.

Check the src subdir for the binary.

NOTE: If capslock and numlock appear to be broken. open

src/ints/bios_keyboard.cpp and go to line 30 and read there how to fix it.

Build instructions for VC++6

Don't use VC++ 6:it creates faulty code in core_normal.cpp

0.72

- Fixed unitialized variable in joystick. (Fixes crashes on Vista and

Mac OS X)

- Some bugfixes and speedups to the 64 bit recompiling core.

- Fixed sign flag on soundblaster dma transfers (Space Quest 6 intro)

- Fixed a bug in keyboard layout processing code and fixed certain

layouts.

- Fixed Dreamweb.

- Improved speed unlocking when running cycles=max.

- Fixed a crash related to the tab completion in the shell.

- Improved aspect correction code. Should now be like how a real monitor

handles it.

- Fixed a bug in the xms status report code. (Blake Stone 1.0 shareware)

- Added a lot more keyboard layouts.

- Fix crash related to changing the scaler before a screen was created.

- Hopefully fixed compilation on *bsd.

- Enabled auto cpu core selection for recompiling core as well.

- Made the used joystick selectable when 4axis is specified.

- Added some hints for inexperienced DOS users to the shell.

0.71

- Add a new recompiling cpu core, which should be easier to port.

- Add 64 bit version of the recompiling core.

- Add mipsel 32 bit version of the recompiling core.

- Fix a few small problems with FCBs. (fixes Jewels of darkness and

cyrus chess)

- Raise some more exceptions. (fixes vbdos)

- Fix a few problems with the dynamic core. (fixes Inner Words,

Archmimedean Dynasty and others)

- Improve/Fix fallback code for certain graphics cards.

- Fix a few cd audio related bugs.

- Add an undocumented MSCDEX feature. (Fixes Ultimate Domain)

- Fix some pcspeaker mode. (fixes Test Drive and similar games)

- Improve dos keyinput handling. (fixes Wing Commander 3 exit dialog)

- Remove Exit condition on fully nested mode. (fixes some demo)

- Add image file size detection.

- Add/Fix some ansi codes. (fixes PC Larn and certain versions of

infocom games)

- Several general DOS fixes. (fixes nba95, hexit and various other games)

- Add some valid input checks. (fixes 3d body adventure and similar

games)

- Fix digital joystick centering problem.

- Reenable textmode 54 and 55.

- Fix a pelmask problem with univbe 5.0 lite. (fixes Panzer General)

- Fix minor mixer underflow.

- Some general image and bios disk emulation fixes.

- Hopefully fix compilation on BSD and darwin.

- Try using ioctl cdrom access by default if possible.

- Fix some svga detection routine. (fixes Grandest Fleet 2 and Bobby Fischer

Teaches Chess)

- You can now close DOSBox using the status window in win32.

- Add support for NX enabled systems.

- Fix a casting error which only showed with certain compilers. (fixes

various games under mac os x and 64 bit linux)

- Improve timer and add gate 2 support. (fixes various games and

joystick problems)

- Improve mouse. Add undocumented backdoor. (fixes Last half of Darkness,

PC-BLOX and others)

- Add/improve support for ~ and ~username in all commands.

- Fix a font problem with the pcjr/tandy. (fixes personal deskmate 2)

- Change dma routine a bit. (fixes ticks in sound in various games)

- Allow read-only diskimages to be booted. (fixes various booter

games)

- Add basic hidden file support on cdrom images. (fixes Player

Manager 2)

- Add some rarely used functionality to the int10 mode setup. (fixes

WW2 Battles of the South pacific)

- Add ability to force scaler usage.

- Speed up flag generation and make it more 386-like.

- Some colourful feedback in the mapper.

- General code cleanup.

0.70

- Improve register handling and support with XMS.

- Fix some issues with deleting open files.(windows only issue)

- Add dummy LPT1 class. (windows only issue)

- Improve some of the internal dos commands. (choice, copy and shift)

- Improve ROM area. (for games that use it for random numbers or

overwrite it as some sort of detection thing)

- Improve compatibility of dynamic core by making it handle certain

pagefaults earlier.

- Move internal dos tables around so we have more umb memory.

- Add some dos tables.

- Dynamic core supports io exceptions.

- Move some interrupt handlers to XT Bios locations.

- Add a dynamic fpu on x86.

- Improve fpu on non-x86.

- Trapflag gets strict priority over hardware IRQs.

- Trapflag support for the dynamic core.

- Add dummy TRx handling.

- Fix a few rarely used character functions.

- Improve auto cycle guessing code.

- Improve and extend the joystick support.

- Add autofire support.

- Improve the mapper so you can map keys to the joystick and vice versa.

- A few game specific video card fixes.

- Fix some 64 bit cpu bugs.

- Add support for certain cdrom detection schemes.

- Improve HSG/Red Book support.

- Improve MSCDEX.

- Improve dynamic core support under intel macs.

- Add basic support for clipper programs.

- Add support for different keyboard layouts.

- Add auto core guessing.

- Fix a few flags bugs.

- Fix a few small cpu bugs.

- Improve soundblaster detection rate by various programs.

- Improve EMS emulation. (allow mapping of non standard regions)

- Improve keyboard input codes on various OS-es.

- Fix problems with filenames having stackdata in them.

- Changed a few basic operations in DOSBox so they take emulated time.

- Improve dos ioctl functions.

- Extend cpu core so they are capable of detecting and raising a few

more exception types.

- Improve DOS functions when dealing with virtual drive.

- Improve FAT drives.

- Better handling of volume-labels in file functions.

- Image disk cycling capability. (prompt)

- Try to reduce the impact of using an analog joystick.

- Several measures to avoid code invalidation on certain types

of self modification in the dynamic core.

- Add dynamic core memory function inlining.

- A few small mouse improvements. (some games are using things they

shouldn't)

- Add nullmodem emulation.(h-a-l-9000)

- Some small cga and hercules fixes.

- Add more scalers (hq2x/hq3x/sai). (Kronuz)

- Change configuration file loading support. It now supports

multiple configuration files.

- Make dynamic core capable of running some win32s programs.

- Fix and add some rare soundblaster modes. (Srecko)

- Better soundblaster mixer controls. (Srecko)

- Make soundblaster installation under windows much easier.

- Add device control channel handling.

- GEMMIS support (ems under windows).

- Support more colours in win 3. (vasyl)

- Don't show unmounted drives in windows filemanager.

- Fix some bugs in the int13 handler.

- Simulate some side-effects of bios interrupt handlers on flags.

- Add IPX functions needed by netbios.

- Make ports take emulated time.

- Tabcompletion is now aware of the CD command.

- Add suppport for the dac pel mask.

- Fixes to hercules emulation, better detection and bank switching.

- Fixes to tandy emulation, 640x200x16 mode and different sizes bank.

- EGA/VGA memory changes detection for faster rendering.

- Gus 16 bit fixes.

- Many timer improvements.

- Some pcjr fixes.

- Some booter fixes.

- Many small fixes.

0.65

DOSBox v0.72

=====

NOTE:

=====

While we are hoping that one day DOSBox will run all programs ever

made for the PC, we are not there yet. At present, DOSBox running

on a high-end machine will roughly be the equivalent of a 486 PC.

DOSBox can be configured to run a wide range of DOS games, from

CGA/Tandy/PCjr classics up to games from the Quake era.

======

INDEX:

======

1. Quickstart

2. FAQ

3. Usage

4. Internal Programs

5. Special Keys

6. Mapper

7. Keyboard Layout

8. Serial Multiplayer feature

9. How to run resource-demanding games

10. Troubleshooting

11. The config file

12. The language file

13. Building your own version of DOSBox

14. Special thanks

15. Contact

==============

1. Quickstart:

==============

Type INTRO in DOSBox for a quick tour.

It is essential that you get familiar with the idea of mounting,

DOSBox does not automatically make any drive (or parts of it)

accessible to the emulation.

See the FAQ entry "I've got a Z instead of a C at the prompt" as

well as the description of the MOUNT command (section 4).

=======

2. FAQ:

=======

Some Frequently Asked Questions:

Q: I've got a Z instead of a C at the prompt.

Q: Do I always have to type these commands? Automation?

Q: How do I change to fullscreen?

Q: My CD-ROM doesn't work.

Q: The mouse doesn't work.

Q: There is no sound.

Q: The sound stutters or sounds stretched/weird.

Q: I can't type \ or : in DOSBox.

Q: The keyboard lags.

Q: The cursor always moves into one direction!

Q: The game/application can't find its CD-ROM.

Q: The game/application runs much too slow!

Q: Can DOSBox harm my computer?

Q: I would like to change the memory size/cpu speed/ems/soundblaster IRQ.

Q: What sound hardware does DOSBox presently emulate?

Q: DOSBox crashes on startup and I'm running arts.

Q: Great README, but I still don't get it.

Q: I've got a Z instead of a C at the prompt.

A: You have to make your directories available as drives in DOSBox by using

the "mount" command. For example, in Windows "mount C D:\GAMES" will give

you a C drive in DOSBox which points to your Windows D:\GAMES directory.

In Linux, "mount c /home/username" will give you a C drive in DOSBox

which points to /home/username in Linux.

To change to the drive mounted like above, type "C:". If everything went

fine, DOSBox will display the prompt "C:\>".

Q: Do I always have to type these commands? Automation?

A: In the DOSBox configuration file is an [autoexec] section. The commands

present there are run when DOSBox starts, so you can use this section

for the mounting.

Q: How do I change to fullscreen?

A: Press alt-enter. Alternatively: Edit the configuration file of DOSBox and

change the option fullscreen=false to fullscreen=true. If fullscreen looks

wrong in your opinion: Play with the option fullresolution in the

configuration file of DOSBox. To get back from fullscreen mode:

Press alt-enter again.

Q: My CD-ROM doesn't work.

A: To mount your CD-ROM in DOSBox you have to specify some additional options

when mounting the CD-ROM.

To enable CD-ROM support (includes MSCDEX):

- mount d f:\ -t cdrom

To enable low-level CD-ROM-support (uses ioctl if possible):

- mount d f:\ -t cdrom -usecd 0

To enable low-level SDL-support:

- mount d f:\ -t cdrom -usecd 0 -noioctl

To enable low-level aspi-support (win98 with aspi-layer installed):

- mount d f:\ -t cdrom -usecd 0 -aspi

In the commands: - d driveletter you will get in DOSBox

- f:\ location of CD-ROM on your PC.

- 0 The number of the CD-ROM drive, reported by mount -cd

See also the question: The game/application can't find its CD-ROM.

Q: The mouse doesn't work.

A: Usually, DOSBox detects when a game uses mouse control. When you click on

the screen it should get locked (confined to the DOSBox window) and work.

With certain games, the DOSBox mouse detection doesn't work. In that case

you will have to lock the mouse manually by pressing CTRL-F10.

Q: There is no sound.

A: Be sure that the sound is correctly configured in the game. This might be

done during the installation or with a setup/setsound utility that

accompanies the game. First see if an autodetection option is provided. If

there is none try selecting soundblaster or soundblaster16 with the default

settings being "address=220 irq=7 dma=1". You might also want to select

midi at address 330 as music device.

The parameters of the emulated soundcards can be changed in the DOSBox

configuration file.

If you still don't get any sound set the core to normal and use some lower

fixed cycles value (like cycles=2000). Also assure that your host operating

sound does provide sound.

Q: The sound stutters or sounds stretched/weird.

A: You're using too much CPU power to keep DOSBox running at the current speed.

You can lower the cycles, skip frames, reduce the sampling rate of

the respective sound device (see the DOSBox configuration file) or

the mixer device. You can also increase the prebuffer in the configfile.

If you are using cycles=max or =auto, then make sure that there no

background processes interfering! (especially if they access the harddisk)

Q: I can't type \ or : in DOSBox.

A: This is a known problem. It only occurs if your keyboard layout isn't US.

Some possible fixes:

1. Switch the keyboard layout of your operating system.

2. Use / instead.

3. Open dosbox.conf and change usescancodes=false to usescancodes=true.

4. Add the commands you want to execute to the "configfile".

5. Change the DOS keyboard layout (see Section 7 Keyboard Layout).

6. Use ALT-58 for : and ALT-92 for \.

7. for \ try the keys around "enter". For ":" try shift and the keys

between "enter" and "l" (US keyboard layout).

8. Try keyb.com from FreeDOS (http://projects.freedos.net/keyb/).

Look for keyb2.0 pre4 as older and newer versions are known to

have a bug in the loader routines.

Q: The keyboard lags.

A: Lower the priority setting in the DOSBox configuration file

like set "priority=normal,normal". You might also want to

try lowering the cycles.

Q: The cursor always moves into one direction!

A: See if it still happens if you disable the joystick emulation,

set joysticktype=none in the [joystick] section of your DOSBox

configuration file. Maybe also try unplugging any joystick.

If you want to use the joystick in the game, try setting timed=false

and be sure to calibrate the joystick (both in your OS as well as

in the game or the game's setup).

Q: The game/application can't find its CD-ROM.

A: Be sure to mount the CD-ROM with -t cdrom switch, this will enable the

MSCDEX interface required by DOS games to interface with CD-ROMs.

Also try adding the correct label (-label LABEL). To enable lower-level

CD-ROM support, add the following switch to mount: -usecd #, where # is

the number of your CD-ROM drive reported by mount -cd. Under Windows you

We would like to thank:

Vlad R. of the vdmsound project for excellent sound blaster info.

Tatsuyuki Satoh of the Mame Team for making an excellent FM emulator.

Jarek Burczynski for the new OPL emulator.

The Bochs and DOSemu projects which I used for information.

Freedos for ideas in making my shell.

Pierre-Yves Gйrardy for hosting the old Beta Board.

Colin Snover for hosting our forum.

Sourceforge for hosting our homepage and other development tools.

Mirek Luza, for his moderation of the forums.

eL_Pusher, DosFreak and MiniMax for their moderation of VOGONS forum.

crazyc and gulikoza for their work on the dynrec core.

Jantien for the version management.

Shawn, Johannes and Marcus for creating the MAC OS X version.

Jochen for creating the OS/2 version.

Ido Beeri for the icon.

All the people who submitted a bug.

The Beta Testers.

Starting with version 0.65, DOSBox allows you to create movies out of screen

output.

To record a movie, you have to press CTRL-ALT-F5.

To stop/end the recording, you have to press CTRL-ALT-F5 again.

To play the recorded movie, you need a movie player which can handle the

ZMBV codec. MS Windows users can find this codec in the start menu entry of

DOSBox. Users of Linux and other OSes should look for a movie player that

uses the ffmpeg libary (you may need to update or ask your distribution to

upgrade).

FAQ:

Q: During the display of the movies the sound is lagging.

A: Check your display properties to see whether your refresh rate is set to

at least 70 hz. Try playing the movie in virtualdub (http://virtualdub.sf.net)

Q: Why does the resulting movie consist of multiple files?

A: Each time the game changes resolution, DOSBox creates a new movie file,

because a movie file can only contain one resolution.

Q: Can I set the cycles higher than my PC can handle during recording?

A: Yes. During recording, the game might play slowly and stuttering, but the

resulting movie should play at the intended speed and have no stuttering.

Q: CTRL-ALT-F5 switches to the console under linux.

A: 1. Start DOSBox like this: dosbox -startmapper

2. Click on Video, click on Add

3. Press the key you want (for example scroll lock or printscreen)

4. Click exit.

5. You can make movies by pressing scroll lock or whichever key you

selected.

Q: The colours are wrong and I'm using 64 bit windows

A: Look here: http://vogons.zetafleet.com/viewtopic.ph p?t=12133