DOSBoxWiki - User contributions [en]

SVN Builds

2010-11-18T21:08:13Z

H-a-l-9000:

This article is a discussion of the general purpose of DOSBox SVN builds, and a list of which known public ones exist and where to get them. The first part is a FAQ covering various questions regarding DOSBox SVN builds; it is followed by a listing, description of and links to known SVN builds, as well as a selection of useful related links.

==SVN Builds FAQ==

===What are SVN builds?===
SVN builds are versions of DOSBox that people have built from the latest version of the DOSBox source code, which is stored on [http://www.sourceforge.net/ sourceforge.net] in something called an SVN repository. SVN builds contain changes that have been made by the DOSBox developers since the latest official release. Some enhanced SVN builds also contain unofficial features and fixes that have been created by enthusiasts in the DOSBox development community.

===Why should I use an SVN build?===
Every so often a new official version of DOSBox is released. However, active development continues between releases, with new features and fixes continuously added to DOSBox's SVN repository that eventually result in the next release. If you're having trouble running a game with the current DOSBox release, it's worth trying an SVN build to see if the problem has been addressed since then. You may also want access to the new features or optimizations if you are having compatibility or performance issues.

===Which one should I use?===
That's up to you. Consult the list below to see which features the different builds contain and decide which one you want to try first. If you are interested in trying an SVN build in hopes that it will fix a problem you're having in the latest release version, you should probably start with a "plain" (no-enhancements) SVN build. Also, see replies to this post from the maintainers for additional info on their builds.

===How do I use it?===
Some SVN builds come packaged as a fully-functional DOSBox distribution, so you can simply unpack the archive into an empty folder and run it. Other builds contain only a custom dosbox executable binary (e.g. dosbox.exe) and possibly some supporting libraries, and require that you first install the latest official release of DOSBox and then unpack the SVN build over the top of it - replacing the release versions of the files with the SVN versions. Some developers also recommend regenerating your dosbox.conf configuration file so that you will see any new config options that have been added. Consult [http://vogons.zetafleet.com/viewtopic.php?p=68701#68701 this forum thread] for info on how to regenerate a config file.

===What do I do if I find bugs in an SVN build?===
First, search the DOSBox community forums to see if it's already been reported. If it hasn't, post as much information as possible (see the [http://vogons.zetafleet.com/viewtopic.php?t=2949 help request guidelines]). ''Update:'' Note that bugs in plain SVN builds are probably the only ones of interest to the DOSBox developers. Problem reports for the other builds should be addressed to their respective maintainers, as problems could be caused by experimental patches that aren't part of the official SVN source code.

===Where can I go to talk about SVN builds? (forum thread)===
Please feel free to discuss SVN build-related topics in the [http://vogons.zetafleet.com/viewtopic.php?t=9306 forum thread] where this article originally started.

==List of SVN Builds==

===Plain/vanilla/clean SVN builds===
The following SVN builds are based directly off of the official DOSBox SVN source code. Use these builds to test the latest official SVN changes.

* '''EmuCR'''
** Last updated: October 18, 2010
** URL: http://www.emucr.com/search/label/DOSBox
** Notes: Updated a few times a week. Haven't tried these myself yet; thanks to NoVaTuRiEnT for pointing them out.
** Compiled '''without''' screenshot, video recording and IPX support.

* '''Tharos (by XTale)'''
** Last updated: March 28, 2010
** URL: http://builds.tharos-online.de/index.php?dir=&sort=date&order=desc
** Notes: '''Daily builds seem to have stopped as of 3/28/10.'''

===Enhanced SVN builds===
The following SVN builds contain additional fixes and/or features that are not officially part of DOSBox. Many people prefer them due to the included extra features that are not included in in the SVN. Note that if you have problems with these builds, it may be due to the unofficial changes that have been made by their maintainers and not the official DOSBox code itself that is to blame.

* '''ykhwong'''
** Last updated: October 21, 2010
** URL: http://ykhwong.x-y.net/ (Windows binary, Linux x86 + x86-64 binaries?)
** URL: http://cafe.daum.net/dosbox
** Description: The Windows build incorporates Direct3D with pixelshaders, OpenglHQ, Innovation, Glide, zip/7z mount, Beep, NE2000 Ethernet, Graphis user interface (menu), Save/Load states, Vertical sync, CPU flags optimization, Various DOS commands (PROMPT, VOL, LABEL, MOUSE, etc) and CONFIG.SYS commands (DEVICE, BUFFERS, FILES, etc), Continuous turbo key, Core-switch key, Show details (from menu bar), Nice DOSBox icon, Font patch (cp437), COPY CON feature, MAKEIMG command, INTRO, Ctrl-break patch, DBCS support patch, Automatic mount, Printer output, MT-32, MP3CUE, Overscan border, Stereo-swap, SDL_Resize, MemSize128, etc.
** OS: Windows, Linux

* '''"UBER BUILD" (by Virusek)'''
** Last Updated: July 23, 2010
** URL: http://vogons.zetafleet.com/viewtopic.php?p=193022#193022 (Windows binary, source)
** Description: All patches from gulikoza's build (coreswitch, direct3d, glide, mt32, openglhq, physfs, NE2000, printer and oplpassthrough). Updated Glide patch by gulikoza to 24.11.2009. SDL_sound support. Some other small fixes (mostly VS2010 compatibility fixes).

* '''Zirias'''
** Last Updated: May 12, 2010
** URL: http://vogons.zetafleet.com/viewtopic.php?p=186679#186679 (Debian i386 + amd64 binary & source packages)
** Description: Debian Linux APT packaged version of DOSBox with Glide support.

* '''"Mega Build" series (by H-A-L-9000)'''
** Last updated: November 18, 2010
** URL: http://home.arcor.de/h-a-l-9000/ (Windows binary, Linux source, Intel Mac OS X port by thedoctor45)
** URL: http://vogons.zetafleet.com/viewtopic.php?t=26170 to discuss the Mac port
** Description: Builds of DOSBox focused on serial/networking support. Contains the NE2000 patch, parallel port passthrough and file forwarding, virtual printer, SVGA enhacements, OPL passthrough, and others. The Windows installer contains the debug-enabled build as option.

* '''gulikoza'''
** Last Updated: July 9, 2009
** URL: http://www.si-gamer.net/gulikoza/ (Windows binary, source)
** Description: Build of DOSBox focused on GLIDE support.

===Unofficial ports===
These builds are for other Operating Systems and are not in any way supported by the DOSBox team.

* '''DOSBox 0.74 for OS/2'''
** Last updated: September 17, 2010
** URL: http://www.os2site.com/sw/emulators/dosbox/index.html
** URL: http://www.joschs-robotics.de/dosbox/
** URL: http://wiki.netlabs.org/index.php/DOSBox_Port

* '''DOSBox 0.73 "aDOSBox" for Android OS'''
** Last Update: February 22, 2010
** URL: http://androiddosbox.appspot.com/

* '''DOSBox 0.73 for Pocket PC (by n0p)'''
** Last updated: July 6, 2009
** URL: http://n0p.tonych.info/?DOSBox_PPC (ARM & XScale builds)
** URL: http://www.e-lation.net/site/emufor_Pocket_PC.html#x86 (also contains links to other possible ports)

* '''DOSBox 0.72 for AmigaOS 4.0'''
** Last updated: June 14, 2009
** URL: http://www.os4depot.net/share/emulation/computer/dosbox.lha
** URL: http://www.os4depot.net/index.php?function=browse&cat=emulation/computer

* '''DOSBox 0.72 for GP2x'''
** Last updated: January 3, 2009
** URL: http://dl.openhandhelds.org/cgi-bin/gp2x.cgi?0,0,0,0,72,2534
** URL: http://wiki.gp2x.org/wiki/DosBox

* '''DOSBox 0.71 for IRIX'''
** Last Updated: 2007? (release dates not currently provided on the linked web site)
** URL: http://www.spam-filter.de/dosbox/dosbox_on_irix
** URL: http://www.enosnusnu.de/index.php?/archives/98-DOSBox-on-IRIX.html
** Notes: Original enosnusnu.de link seems to now redirect to spam-filter.de. I added a link to a DOSBox on IRIX page on the latter site, but it appears that it may only offer a source code tarball and no binary.

* '''DOSBox 0.70 "Optimized" for PXA270 (by wellswang & kkazakov)'''
** Last Updated: March 19, 2007
** URL: http://www.oesf.org/forum/index.php?showtopic=18415&st=270&p=156742&#entry156742
** URL: http://wells.osall.com/files/download.php?id=1727
** URL: http://www.oesf.org/forums/index.php?s=1dec7dd003587d385fbec45efb1ffbaa&showtopic=18415&st=270&p=156742&#entry156742

* '''DOSBox 0.60 for PSP'''
** Last Update: June 6, 2007
** URL: http://www.dcemu.co.uk/vbulletin/showthread.php?t=65494
** URL: http://forums.ps2dev.org/viewtopic.php?t=3179&start=60 (link nonresponsive as of 10/28/10)

* '''DOSBox 0.60 for Dreamcast'''
** Last Updated: 2005? (release dates not currently provided on the linked web site)
** URL: http://gpf.dcemu.co.uk/dcdoxbox.shtml

===Obsolete SVN/CVS builds===
These builds are no longer maintained and are listed here for historical reference.

* '''DOSBox for Mac OSX (by rhoenie/Marcus Herbert)'''
** Last updated: August 9, 2008
** URL: http://www.spam-filter.de/bastelstunde#dosbox
** Description: DosBox 0.72 for G3 & DosBox CVS for OSX (G4/G5/i386)

* '''DOSBox CVS for Linux (by Moe)'''
** Last updated: December 15, 2006
** URL: http://garni.ch/dosbox/
** Description: Recently Moe has decided to provide a DOSBox Linux (x86, 32-bit, Athlon64-optimized) binary including some useful patches. It is built against latest CVS and includes at least these patches: addkey, adlib optimize, Innovation SSI-2001, Self-Modifying-Code optimizations, SVGA chipsets, CD-Image cycling, Glide emulation, Printer emulation.
** Notes: Moe is also the creator of OPENGL-HQ. OPENGL-HQ is another scaler that is implemented in SDL.dll. Unfortunately it may be some time (or never), until OPENGL-HQ is implemented in the official SDL so until then you'll have to download it from here (or compile it yourself). Neat thing about this is that you can use this SDL.DLL with any SDL program (e.g. DOSBox, SCUMMVM...).

* '''DOSBox with MT-32 emulation (by Canadacow)'''
** Last updated: October 15, 2004
** URL: http://www.artworxinn.com/alex/downloads.htm
** Description: ''This build is no longer useful''; it was made before DOSBox 0.63 came out and contains MT-32 emulation code that is much older than the current Munt releases. Note that more current MT-32 emulation is also included as an unofficial feature of some of the newer SVN builds.

==Useful Links==

===SVN changelog===
The following links list the latest changes to the official DOSBox source code on its sourceforge.net SVN repository:
* http://source.dosbox.com/dosboxsvn.txt (auto-generated changelog provided by Qbix)
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/?view=log (auto-generated changelog created by sourceforge.net)
* http://github.com/Henne/dosbox-svn/commits/master (auto-generated changelog of unofficial git clone of DOSBox SVN)
* http://dosbox.linuxsecured.net/dosboxcvs.txt - '''broken link as of 10/25/10'''
* http://cvscompile.aep-emu.de/cl/dosboxChangeLog.txt - '''broken link as of 10/25/10'''

===SVN build news===
The following link(s) provide news related to DOSBox SVN builds:
* http://www.emucr.com/search/label/DOSBox (EmuCR posts with DOSBox tag, which includes news regarding DOSBox SVN builds, frontends and other DOSBox ports)

===Debugger-enabled builds===
Qbix has a thread on the DOSBox forum containing links to some special DOSBox builds that have a built-in debugger:
* http://vogons.zetafleet.com/viewtopic.php?t=7323

===Making your own SVN build===
The following DOSBoxWiki article discusses the process of making your own SVN build from the official DOSBox SVN source code:
* [[BuildingDOSBox]]

===Snapshot of latest DOSBox SVN source code===
Snapshots of the latest SVN versions of the DOSBox source code are available at the following URL(s) :
* http://source.dosbox.com/dosboxsvn.tgz (auto-generated tarball provided by Qbix)
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/?view=tar (auto-generated tarball created by sourceforge.net)
* http://sourceforge.net/scm/?type=svn&group_id=52551 (sourceforge.net instructions for accessing official DOSBox SVN repository)
* http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/ (sourceforge.net SVN browser for official DOSBox SVN repository)
* http://github.com/Henne/dosbox-svn (unofficial git clone of DOSBox SVN; auto-generated tarballs are also available there)
* http://dosbox.linuxsecured.net/dosboxcvs.tgz - '''broken link as of 10/25/10'''

SVN Builds

2010-10-27T09:59:04Z

H-a-l-9000: Details on EmuCR

This article is a discussion of the general purpose of DOSBox SVN builds, and a list of which known public ones exist and where to get them. The first part is a FAQ covering various questions regarding DOSBox SVN builds; it is followed by a listing, description of and links to known SVN builds, as well as a selection of useful related links.

==SVN Builds FAQ==

===What are SVN builds?===
SVN builds are versions of DOSBox that people have built from the latest version of the DOSBox source code, which is stored on [http://www.sourceforge.net/ sourceforge.net] in something called an SVN repository. SVN builds contain changes that have been made by the DOSBox developers since the latest official release. Some enhanced SVN builds also contain unofficial features and fixes that have been created by enthusiasts in the DOSBox development community.

===Why should I use an SVN build?===
Every so often a new official version of DOSBox is released. However, active development continues between releases, with new features and fixes continuously added to DOSBox's SVN repository that eventually result in the next release. If you're having trouble running a game with the current DOSBox release, it's worth trying an SVN build to see if the problem has been addressed since then. You may also want access to the new features or optimizations if you are having compatibility or performance issues.

===Which one should I use?===
That's up to you. Consult the list below to see which features the different builds contain and decide which one you want to try first. If you are interested in trying an SVN build in hopes that it will fix a problem you're having in the latest release version, you should probably start with a "plain" (no-enhancements) SVN build. Also, see replies to this post from the maintainers for additional info on their builds.

===How do I use it?===
Some SVN builds come packaged as a fully-functional DOSBox distribution, so you can simply unpack the archive into an empty folder and run it. Other builds contain only a custom dosbox executable binary (e.g. dosbox.exe) and possibly some supporting libraries, and require that you first install the latest official release of DOSBox and then unpack the SVN build over the top of it - replacing the release versions of the files with the SVN versions. Some developers also recommend regenerating your dosbox.conf configuration file so that you will see any new config options that have been added. Consult [http://vogons.zetafleet.com/viewtopic.php?p=68701#68701 this forum thread] for info on how to regenerate a config file.

===What do I do if I find bugs in an SVN build?===
First, search the DOSBox community forums to see if it's already been reported. If it hasn't, post as much information as possible (see the [http://vogons.zetafleet.com/viewtopic.php?t=2949 help request guidelines]). ''Update:'' Note that bugs in plain SVN builds are probably the only ones of interest to the DOSBox developers. Problem reports for the other builds should be addressed to their respective maintainers, as problems could be caused by experimental patches that aren't part of the official SVN source code.

===Where can I go to talk about SVN builds? (forum thread)===
Please feel free to discuss SVN build-related topics in the [http://vogons.zetafleet.com/viewtopic.php?t=9306 forum thread] where this article originally started.

==List of SVN Builds==

===Plain/vanilla/clean SVN builds===
The following SVN builds are based directly off of the official DOSBox SVN source code. Use these builds to test the latest official SVN changes.

* '''EmuCR'''
** Last updated: October 18, 2010
** URL: http://www.emucr.com/search/label/DOSBox
** Notes: Updated a few times a week. Haven't tried these myself yet; thanks to NoVaTuRiEnT for pointing them out.
** Compiled '''without''' screenshot, video recording and IPX support.

* '''Tharos (by XTale)'''
** Last updated: March 28, 2010
** URL: http://builds.tharos-online.de/index.php?dir=&sort=date&order=desc
** Notes: '''Daily builds seem to have stopped as of 3/28/10.'''

===Enhanced SVN builds===
The following SVN builds contain additional fixes and/or features that are not officially part of DOSBox. Many people prefer them due to the included extra features that are not included in in the SVN. Note that if you have problems with these builds, it may be due to the unofficial changes that have been made by their maintainers and not the official DOSBox code itself that is to blame.

* '''ykhwong'''
** Last updated: October 21, 2010
** URL: http://ykhwong.x-y.net/
** URL: http://cafe.daum.net/dosbox
** Description: The Windows build incorporates Direct3D with pixelshaders, OpenglHQ, Innovation, Glide, zip/7z mount, Beep, NE2000 Ethernet, Graphis user interface (menu), Save/Load states, Vertical sync, CPU flags optimization, Various DOS commands (PROMPT, VOL, LABEL, MOUSE, etc) and CONFIG.SYS commands (DEVICE, BUFFERS, FILES, etc), Continuous turbo key, Core-switch key, Show details (from menu bar), Nice DOSBox icon, Font patch (cp437), COPY CON feature, MAKEIMG command, INTRO, Ctrl-break patch, DBCS support patch, Automatic mount, Printer output, MT-32, MP3CUE, Overscan border, Stereo-swap, SDL_Resize, MemSize128, etc.
** OS: Windows, Linux

* '''DOSBox "Mega Build" series (by H-A-L-9000)'''
** Last updated: September 13, 2009
** URL: http://home.arcor.de/h-a-l-9000/
** Description: Builds of DOSBox focused on serial/networking support.

* '''gulikoza'''
** Last Updated: July 9, 2009
** URL: http://www.si-gamer.net/gulikoza/
** Description: Build of DOSBox focused on GLIDE support.

* '''Zirias'''
** Last Updated: May 12, 2010
** URL: http://vogons.zetafleet.com/viewtopic.php?p=186679#186679
** Description: Debian Linux APT packaged version of DOSBox with Glide support.

* '''"UBER BUILD" (by Virusek)'''
** Last Updated: July 23, 2010
** URL: http://vogons.zetafleet.com/viewtopic.php?p=193022#193022
** Description: All patches from gulikoza's build (coreswitch, direct3d, glide, mt32, openglhq, physfs, NE2000, printer and oplpassthrough). Updated Glide patch by gulikoza to 24.11.2009. SDL_sound support. Some other small fixes (mostly VS2010 compatibility fixes).

===Unofficial ports===
These builds are for other Operating Systems and are not in any way supported by the DOSBox team.

* '''DOSBox 0.72 for AmigaOS 4.0'''
** Last updated: June 14, 2009
** URL: http://www.os4depot.net/share/emulation/computer/dosbox.lha
** URL: http://www.os4depot.net/index.php?function=browse&cat=emulation/computer

* '''DOSBox for OS/2'''
** Last updated: September 17, 2010
** URL: http://www.joschs-robotics.de/dosbox/
** URL: http://www.os2site.com/sw/emulators/dosbox/index.html

* '''DOSBox v0.60 for Dreamcast'''
** Last Updated: ??? (release dates not currently provided on the linked web site)
** URL: http://gpf.dcemu.co.uk/dcdoxbox.shtml

* '''DOSBox for GP2x'''
** Last updated: January 3, 2009
** URL: http://dl.openhandhelds.org/cgi-bin/gp2x.cgi?0,0,0,0,72,2534
** URL: http://wiki.gp2x.org/wiki/DosBox

* '''DOSBox for IRIX'''
** Last Updated: ??? (release dates not currently provided on the linked web site)
** URL: http://www.enosnusnu.de/index.php?/archives/98-DOSBox-on-IRIX.html
** URL: http://www.spam-filter.de/dosbox/dosbox_on_irix
** Notes: Link seems to now redirect to spam-filter.de. I added a link to a DOSBox on IRIX page on that site, but it doesn't appear to have a binary.

* '''DOSBox for PSP'''
** URL: http://forums.ps2dev.org/viewtopic.php?t=3179&start=60
** URL: http://www.dcemu.co.uk/vbulletin/showthread.php?t=65494

* '''DOSBox for Pocket PC (by n0p)'''
** Last updated: July 6, 2009
** URL: http://n0p.tonych.info/?DOSBox_PPC

* '''DOSBox 0.70 Optimized for PXA270 (iwmmxt)'''
** URL: http://www.oesf.org/forums/index.php?s=1dec7dd003587d385fbec45efb1ffbaa&showtopic=18415&st=270&p=156742&#entry156742

* '''pDOSBox for Pocket PC'''
** URL: http://www.e-lation.net/site/emufor_Pocket_PC.html

* '''aDOSBox 0.73 for Android OS'''
** URL: http://androiddosbox.appspot.com/

===Obsolete SVN/CVS builds===
These builds are no longer maintained and are listed here for historical reference.

* '''DOSBox CVS for Linux (by Moe)'''
** Last updated: December 15, 2006
** URL: http://garni.ch/dosbox/
** Description: Recently Moe has decided to provide a DOSBox Linux (x86, 32-bit, Athlon64-optimized) binary including some useful patches. It is built against latest CVS and includes at least these patches: addkey, adlib optimize, Innovation SSI-2001, Self-Modifying-Code optimizations, SVGA chipsets, CD-Image cycling, Glide emulation, Printer emulation.
** Notes: Moe is also the creator of OPENGL-HQ. OPENGL-HQ is another scaler that is implemented in SDL.dll. Unfortunately it may be some time (or never), until OPENGL-HQ is implemented in the official SDL so until then you'll have to download it from here (or compile it yourself). Neat thing about this is that you can use this SDL.DLL with any SDL program (e.g. DOSBox, SCUMMVM...).

* '''DOSBox for Mac OSX (by rhoenie/Marcus Herbert)'''
** Last updated: August 9, 2008
** URL: http://www.spam-filter.de/bastelstunde#dosbox
** Description: DosBox 0.72 for G3 & DosBox CVS for OSX (G4/G5/i386)

* '''DOSBox with MT-32 emulation (by Canadacow)'''
** Last updated: October 15, 2004
** URL: http://www.artworxinn.com/alex/downloads.htm
** Description: ''This build is no longer useful''; it was made before DOSBox 0.63 came out and contains MT-32 emulation code that is much older than the current Munt releases. Note that more current MT-32 emulation is also included as an unofficial feature of some of the newer SVN builds.

==Useful Links==

===SVN changelog===
The following links list the latest changes to the official DOSBox source code on its sourceforge.net SVN repository:
* URL: http://source.dosbox.com/dosboxsvn.txt (auto-generated changelog provided by Qbix)
* URL: http://dosbox.svn.sourceforge.net/viewvc/dosbox/?view=log (auto-generated changelog created by sourceforge.net)
* URL: http://github.com/Henne/dosbox-svn/commits/master (auto-generated changelog of unofficial git clone of DOSBox SVN)
* URL: http://dosbox.linuxsecured.net/dosboxcvs.txt - '''broken link as of 10/25/10'''
* URL: http://cvscompile.aep-emu.de/cl/dosboxChangeLog.txt - '''broken link as of 10/25/10'''

===SVN build news===
The following link(s) provide news related to DOSBox SVN builds:
* URL: http://www.emucr.com/search/label/DOSBox (EmuCR posts with DOSBox tag, which includes news regarding DOSBox SVN builds, frontends and other DOSBox ports)

===Debugger-enabled builds===
Qbix has a thread on the DOSBox forum containing links to some special DOSBox builds that have a built-in debugger:
* URL: http://vogons.zetafleet.com/viewtopic.php?t=7323

===Making your own SVN build===
The following DOSBoxWiki article discusses the process of making your own SVN build from the official DOSBox SVN source code:
* URL: [[BuildingDOSBox]]

===Snapshot of latest DOSBox SVN source code===
Snapshots of the latest SVN versions of the DOSBox source code are available at the following URL(s) :
* URL: http://source.dosbox.com/dosboxsvn.tgz (auto-generated tarball provided by Qbix)
* URL: http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/?view=tar (auto-generated tarball created by sourceforge.net)
* URL: http://sourceforge.net/scm/?type=svn&group_id=52551 (sourceforge.net instructions for accessing official DOSBox SVN repository)
* URL: http://dosbox.svn.sourceforge.net/viewvc/dosbox/dosbox/trunk/ (sourceforge.net SVN browser for official DOSBox SVN repository)
* URL: http://github.com/Henne/dosbox-svn (unofficial git clone of DOSBox SVN; auto-generated tarballs are also available there)
* URL: http://dosbox.linuxsecured.net/dosboxcvs.tgz - '''broken link as of 10/25/10'''

Technical Info

2010-07-11T16:50:26Z

H-a-l-9000: Created page with 'This page contains links to technical documentation that is useful for emulator writers. === Video Hardware === ==== VGA ==== * [http://www.programmersheaven.com/download/15177/d…'

This page contains links to technical documentation that is useful for emulator writers.
=== Video Hardware ===
==== VGA ====
* [http://www.programmersheaven.com/download/15177/download.aspx VGADOC] - also has register info on many old SVGA chipsets, EGA, CGA, Hercules.
* [http://www.osdever.net/FreeVGA/home.htm FreeVGA]
* [http://www.datasheetarchive.com/82C451-datasheet.html 82C451 Datasheet]
* [http://www.mcamafia.de/pdf/pdfref.htm PS/2 Reference Manuals]

==== SVGA ====
* VGADOC
* The NT4 DDK contains example source of an S3 driver
* TODO Link to S3 Linux driver source
* RBIL\memory.lst, RBIL\PORTS
* [http://www.datasheetcatalog.net/de/datasheets_pdf/E/T/4/0/ET4000.shtml ET4000 Alpplication Note]
* [http://www.datasheetcatalog.com/datasheets_pdf/E/T/4/0/ET4000-W32P.shtml ET4000-W32 Datasheet]

==== EGA ====
* VGADOC (small inaccuracies)
* [http://www.datasheetarchive.com/82C435-datasheet.html 82C435 Datasheet]
* TODO IBM register/mode table scan hidden somewhere on the Vintage Computer Forum

==== Tandy ====
* [http://www.oldskool.org/guides/tvdog/documents.html Tandy Technical References] (hxtech, tltech, sxtech)

==== PCJr ====
* [http://www.retroarchive.org/dos/docs/index.html IBM PCJr Technical Reference]
* Some Tandy Technical References have register comparisons with PCJr

==== CGA ====
* [http://www.alldatasheet.net/datasheet-pdf/pdf/4159/MOTOROLA/MC6845.html MC6845 datasheet]
* [http://www.retroarchive.org/dos/docs/index.html IBM PC Technical Reference]
* VGADOC
* [http://www.datasheetarchive.com/V6366-datasheet.html V6366 CGA compatible display controller]

==== MDA ====
* [http://www.seasip.info/VintagePC/mda.html Info on the Monochrome Adapter]
* [http://www.retroarchive.org/dos/docs/index.html IBM PC Technical Reference]

==== Hercules ====
* VGADOC
* [http://www.seasip.info/VintagePC/mda.html Some notes on Hercules]

=== Sound ===
==== Soundblaster ====
* [http://irlp.kc6hur.net/SoundBlaster.pdf Creative Soundblaster Programming Guide]
* [http://the.earth.li/~tfm/oldpage/sb.html Soundblaster Commands/Register Details]
*

==== Emu8000 ====
* [http://www.phatcode.net/res/244/files/emu8kpgm.pdf EMU8000 Programmer's Reference]

==== Gravis Ultrasound ====
* RBIL\PORTS
* [http://www.gamedev.net/reference/articles/article448.asp Ultrasound Programming]
==== Adlib ====
* [http://www.alldatasheet.com/datasheet-pdf/pdf/103368/ETC/YMF262.html YMF262 Datasheet]
* [http://www.datasheetarchive.com/YAC512-M-datasheet.html YAC512 Datasheet (YMF262 DAC)]
* [http://www.alldatasheet.com/datasheet-pdf/pdf/84281/YAMAHA/YM3812.html YMF3812 Datasheet]

==== MIDI ====
==== MPU401 ====
* [http://qs.salientphotography.nl/files/Manuals%2C%20Docs%20%26%20Articles/Roland%20manuals/Roland%20MPU-401%20Manual%20%5BEngels%5D.pdf MPU-401 Reference Manual]

==== MIDI Modules ====
==== LPT DAC ====

=== Storage ===
==== ATA ====
==== ATAPI ====
==== Floppy ====
* [http://www.alldatasheet.com/view.jsp?Searchword=37C65 37C65 Datasheet]
* [http://www.isdaman.com/alsos/hardware/fdc/floppy.htm Programming Floppy Controllers]

=== Ports ===
* [http://www.alldatasheet.com/view.jsp?Searchword=16C550 16C550 Datasheet]
* [http://www.retroarchive.org/dos/docs/index.html IBM PC Technical Reference]

=== Mainboard ===
==== DMA ====
* [http://www.datasheetarchive.com/8237-datasheet.html 8237 Datasheets]
* [http://www.retroarchive.org/dos/docs/index.html IBM PC Technical Reference]

==== Interrupt ====
* [http://www.datasheetarchive.com/8259A-datasheet.html 8259 Datasheets]

==== Timer ====
* [http://www.datasheetcatalog.com/datasheets_pdf/8/2/5/3/8253.shtml 8253 Datasheet]
* [http://www.datasheetcatalog.com/datasheets_pdf/8/2/5/4/8254.shtml 8254 Datasheet]
* [http://www.datasheetcatalog.com/datasheets_pdf/8/2/C/5/82C54.shtml 82C54 Datasheet]

==== Keyboard ====
* [http://www.retroarchive.org/dos/docs/index.html IBM PC Technical Reference]
* [http://www.mcamafia.de/pdf/pdfref.htm PS/2 Reference Manuals]
* [http://www.datasheetcatalog.com/datasheets_pdf/K/B/D/4/KBD43W13.shtml KBD43W13 Keyboard/Mouse Controller Datasheet]

==== PC ====
* [http://www.ampro.com/tmp/ISAtiming.pdf ISA timing (PC104timing.pdf)]
* TODO PC AT schematic somewhere on the Vintage Computer Forum
* [http://www.datasheetarchive.com/82C206-datasheet.html PC-AT Chipset]

==== PCJr ====
* [http://www.retroarchive.org/dos/docs/index.html IBM PCJr Technical Reference]

==== Tandy ====
* [http://www.oldskool.org/guides/tvdog/documents.html Tandy Technical References] (hxtech, tltech, sxtech)

=== CPU ===
* [http://geezer.osdevbrasil.net/os/386intel.zip 80386 Manual]
* [http://www.rcollins.org/intel.doc/486Manuals.html CPU Manuals]
* [http://members.tripod.com/protected_mode/alexfru/pmtuts.html Protected Mode Programming Tutorials]
* [http://datasheets.chipdb.org/Intel/x86/486/datashts/27132903.PDF 486 Datasheet]
* [http://www.datasheetcatalog.org/datasheet/Intel/mXtuvqv.pdf 386 DX Datasheet]
* TODO same as above for 486, have it on disk but can't find it on the net right now

=== Software ===
==== BIOS ====
* [http://ctyme.com/intr/int.htm Ralf Browns Interrupt List]
* [http://versalogic.com/support/downloads/pdf/69030bg.pdf OEM VGA BIOS Specification]
* RBIL\memory.lst - BIOS data area
* [http://www.bioscentral.com/misc/bda.htm BIOS data area]
* The various Technical References mentioned above have BIOS info too

==== DOS ====
* RBIL
* [http://www.frontiernet.net/~fys/index.htm DOS programming and secrets]

==== Drivers ====
[http://cd.textfiles.com/knowledgemedia/CDROM/MSDOS/MSCDEX21/MSCDEX21.DOC MSCDEX Interface]

Configuration:CPU

2010-07-09T13:14:58Z

H-a-l-9000:

The CPU section controls how DOSBox tries to emulate the CPU, how fast the emulation should be, and to adjust it. DOSBox offers 4 different methods of [[/cpu/core/Intro|CPU emulation]].

==== core = [[/cpu/core/simple|simple]] | [[/cpu/core/normal|normal]]| [[/cpu/core/dynamic|dynamic]] | auto ====
[[/cpu/core/Intro|CPU core]] used in emulation. The choices result in a different efficency of DOSBox and in very rare cases have an effect on stability.

:{| class="wikitable"
|-
| '''normal''' || The program is interpreted instruction by instruction. This approach is a lot more CPU demanding than dynamic core but allows for a more fine-grained time emulation and is needed on platforms for which DOSBox doesn't have a dynamic core.
|-
| '''simple''' || Basically the same as normal, but optimized for real-mode (older) games. In case a protected-mode game is started, it automatically switches back to normal core.
|-
| '''dynamic''' || The program instructions are, in blocks, translated to host processor instructions that execute directly. See also [http://en.wikipedia.org/wiki/Just-in-time_compilation ]. In the most cases this approach is more efficent than interpretation, except for programs that employ massive self-modifying code. This option is not present on all host platforms.
|-
| '''auto''' || Real-mode programs are run with the normal core. For protected mode programs it switches to dynamic core, if available.
|-
| '''full''' || Deprecated.
|}

Default is '''auto'''.

==== cputype = auto | 386 | 386_slow | 486_slow | pentium_slow | 386_prefetch ====
CPU Type used in emulation. '''auto''' is the fastest choice.

:(since 0.73)

Default is '''auto'''.

==== cycles = fixed ''nnnn'' | max [''default''%] [limit ''cycle limit''] | auto [''realmode default''] [''protected mode default''%] [limit "cycle limit"] ====
Amount of instructions DOSBox tries to emulate each millisecond. Set to '''max''' to automatically run as many cycles as possible. '''auto''' setting switches to '''max''' if appropriate.

:{| class="wikitable"
|-
| '''fixed ''nnnn'' ''' || Sets the emulated CPU speed to a fixed amount of cycles (''nnnn''). A value of 3000 equates 3 MIPS. If this value is too high some games will run too fast or crash. How high you can go depends on the power of your host CPU and on the selected core (above). If the value is too high for your CPU the emulation will slow down and the sound starts to skip.
|-
| '''max''' || Automatically sets the cycles so approximately the (optional) ''default''%-value of your host CPU is used. If the value is not specified it defaults to 100%. The optional ''limit'' parameter limits the maximum speed to the specified value.
|-
| '''auto''' || For realmode games, this option switches to ''realmode default'' number of cycles or 3000 if not specified. When switching to protected mode, cycles is internally switched to '''max''' using the remaining optional parameters.
|}

Default is '''auto'''.
====== Examples: ======
* ''cycles=fixed 5000'', ''cycles=5000'' - All games you start are run with a fixed speed of ~5 MIPS. Useful for speed sensitive games or games that need a continuous CPU speed. You can change the actual value with Ctrl+F11 and Ctrl+F12 ([[SpecialKeys|keycombo]]) while DOSBox runs.
* ''cycles=max'' - All games you start run at the maximum speed your CPU permits. Use Ctrl+F11 and Ctrl+F12 to change the percentage of your CPU to be used.
* ''cycles=max limit 50000'' - All games you start run at up to 50000 cycles, depending on the power of your CPU.
* ''cycles=max 50%'' - About 50% of your CPU power will be used.
* ''cycles=auto'' - Realmode games will run at 3000 cycles. Protected mode games run with ''cycles=max''.
* ''cycles=auto 5000 50% limit 50000'' - Realmode games run with 5000 fixed cycles, protected mode games with ''cycles=max 50% limit 50000''.

==== cycleup = ''nnn'' ====
Amount of cycles to increase with [[SpecialKeys|keycombo]].

Default is '''10'''. Setting it lower than 100 will be a percentage of the current value.

==== cycledown = ''nnn'' ====
Amount of cycles to decrease with [[SpecialKeys|keycombo]].

Default is '''20'''. Setting it lower than 100 will be a percentage of the current value.

Talk:Sound

2009-12-02T22:54:46Z

H-a-l-9000: Additional info to be considered in the article

== Additional info on the DOSBox Disney implementation ==

Since version 0.73 the Disney device is actually about four devices in one. The type needed by the game is figured out by looking at how it controls the port.

- Disney device: FIFO-buffer with DAC and a fixed sampling rate of 7KHz.

- COVOX/R2R-DAC: Simple converter directly connected to the parallel port data lines.

- Latched mono DAC

- Stereo-in-one-DACs: Stereo playback on one port. Used by some demos.

== Adlib card is possible ==

With sbtype=none, you can still specify an oplmode which will be your Adlib card.

--[[User:H-a-l-9000|H-a-l-9000]] 22:54, 2 December 2009 (UTC)