From 4692a57d17345a501c0a9cd2bb8598fbc2f02262 Mon Sep 17 00:00:00 2001 From: RichardG867 Date: Thu, 29 Jul 2021 21:17:36 -0300 Subject: [PATCH] The big storage update --- hardware/diskimages.rst | 40 ++++++++++++++++++++++++++++++++----- settings/storage.rst | 23 ++++++++++++--------- usage/images/cartridge.png | Bin 0 -> 1001 bytes usage/images/cassette.png | Bin 0 -> 1005 bytes usage/menubar.rst | 2 +- usage/statusbar.rst | 26 ++++++++++++++++++++++++ 6 files changed, 76 insertions(+), 15 deletions(-) create mode 100644 usage/images/cartridge.png create mode 100644 usage/images/cassette.png diff --git a/hardware/diskimages.rst b/hardware/diskimages.rst index f8cc8fc..bde3388 100644 --- a/hardware/diskimages.rst +++ b/hardware/diskimages.rst @@ -1,7 +1,7 @@ Disk images =========== -86Box supports a large variety of disk image formats for the emulated disk drives. +86Box supports a large variety of disk image formats for the emulated storage drives. .. |86f| replace:: :doc:`../dev/formats/86f` .. |hdx| replace:: :doc:`../dev/formats/hdx` @@ -50,9 +50,7 @@ There are limits to how big of a hard disk an emulated machine can accept. Such |86Box |131071 MB|Not applicable | +----------------+---------+-----------------------+ -The maximum supported disk image size for IDE or SCSI is - -Disk overlay software such as *Ontrack Disk Manager* can work around BIOS limits and allow booting of hard drives within the 86Box limit of 131071 MB, with the same caveats as using such software on a real machine. +The maximum supported disk image size for IDE or SCSI is 131071 MB. Disk overlay software such as *Ontrack Disk Manager* can work around BIOS limits and allow booting of IDE hard drives within the 131071 MB limit, with the same caveats as using such software on a real machine. Floppy disk images ------------------ @@ -133,6 +131,38 @@ Supported formats: CD audio ^^^^^^^^ -Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is supported on **Cue sheet** images. Audio output is unmuted on the first CD-ROM drive and muted on subsequent drives by default; individual drives can be muted or unmuted through the :ref:`status bar ` or :ref:`Media menu `. +Compact Disc Digital Audio (CDDA) playback through the emulated CD-ROM drives is supported on **Cue sheet** images. Audio output is enabled on the first CD-ROM drive and muted on subsequent drives by default; individual drives can be muted or unmuted through the :ref:`status bar ` or :ref:`Media menu `. .. note:: Only raw format (.bin) tracks are supported. Compressed or otherwise encapsulated audio tracks (.wav, .mp3, .ogg, .flac and other formats) are not supported. + +Cassette tape images +-------------------- + +Supported formats: + ++---------------------+--------------+ +|Format |File extension| ++=====================+==============+ +|**Raw PCM audio** |Many * | ++---------------------+--------------+ +|PCE cassette |.cas | ++---------------------+--------------+ +|Wave audio |.wav | ++---------------------+--------------+ + +\* Raw audio extensions recognized by 86Box include: .pcm .raw + +PCjr cartridge images +--------------------- + +Supported formats: + ++---------------------+--------------+ +|Format |File extension| ++=====================+==============+ +|**Raw image** |Many * | ++---------------------+--------------+ +|JRipCart |.jrc | ++---------------------+--------------+ + +\* Raw image extensions recognized by 86Box include: .a .b .bin diff --git a/settings/storage.rst b/settings/storage.rst index b3504d6..cb10df7 100644 --- a/settings/storage.rst +++ b/settings/storage.rst @@ -3,13 +3,6 @@ Storage controllers The *Storage controllers* page contains settings related to the emulated machine's disk drive controllers. -SCSI Controller ---------------- - -SCSI host bus adapter card to emulate. This box only lists cards supported by the machine's expansion buses. - -The *Configure* button opens a new window with settings specific to the selected SCSI card, such as the I/O port and IRQ for ISA cards. - HD Controller ------------- @@ -20,7 +13,7 @@ The *Configure* button opens a new window with settings specific to the selected FD Controller ------------- -Floppy disk drive controller card to emulate. Selecting a controller is not required, unless you wish to use the DTK controllers for adding high-density 1.44M floppy support to XT machines. +Floppy disk drive controller card to emulate. Selecting a controller is not required, unless you wish to use one of the add-on controllers for adding high-density 1.44M floppy support to XT machines. The BIOS option ROM address used by the selected controller can be configured through the *Settings* button. @@ -31,4 +24,16 @@ Add a third or fourth (respectively) IDE channel to the emulated machine, throug The IRQ used by each controller can be configured through its respective *Settings* button. -.. note:: The tertiary and quaternary controllers are not Plug and Play compliant; they may require manual configuration of emulated operating systems, and may not be bootable. See :doc:`../hardware/ideterqua` for more information. \ No newline at end of file +.. note:: The tertiary and quaternary controllers are not Plug and Play compliant; they may require manual configuration of emulated operating systems, and may not be bootable. See :doc:`../hardware/ideterqua` for more information. + +SCSI Controllers +---------------- + +SCSI host bus adapter cards to emulate. Up to 4 SCSI cards are supported. The selection boxes only list cards supported by the machine's expansion buses. + +The *Configure* buttons open a new window with settings specific to the corresponding SCSI card, such as the I/O port and IRQ for ISA cards. + +Cassette +-------- + +Enable IBM cassette tape emulation. The cassette deck can be controlled through the :ref:`status bar ` or :ref:`Media menu `. diff --git a/usage/images/cartridge.png b/usage/images/cartridge.png new file mode 100644 index 0000000000000000000000000000000000000000..fb7912da6d4b6172748daab71199769b5c2fdad7 GIT binary patch literal 1001 zcmZWmYiOHg6n?vI)ZLu@vF5ub-zB&2mVB3FxwxiHmzabup=r{lbvFCHw2hjkbg}8y z);VKWk-OXb3O~yb38AB)a4gM10Ip;jjIp;a> z@}B8Q#rE#Pb^!qPCgPD^Sf6ObW6dx-rF|J#wm%zAh5=Z4efJ|{2h`MXyf+EJtQ~;b zJOF>fR_#{+repx_=>P=Z0>E@^VIzGIfTrJi4rilqVS0RUyzul?$v9al)}~6QkB`lt z7<+ZPJm0|B%tWD>&lQivhk6f}hO(u6U-@W%*~pFSxiZAjTq&O&%5*2fotZ?S!{_M= zdL!+=SbHGW?vHl_;-NsIBM?34ds6enJ5(oULXj`zA)8Yd{6uwb|a!&riJkc1V(7!;#W%u0}M2d4_O1&33@j1m^u z#BmxyC=*H{D1+e=T;OR7iklIX#V{K@f}#w9(k7VUGNJN}8G%!bG@&et(I$jNaT>!F zo*~*0s?9`Um}KWCAq+g;hFJEStQa2DL`{-ZLGXxz&n5X>t^<eMY{{Vh@Q?)mh0iAb#C^kf)I~G|Qygs`QMN2i2jJDivAzOj@rQ5IFg{^yu zNH~jpJFM&aNTFzq4&VLhms@uX(3B6IY6{avYg(!7tk;&#t)9KI@X^BD;+yI~XS6Sw z96FTgJ`&6A6E95Y&yAD|1-(=%KHgTZuYS0?wzhKZ>WO39cl!gI{>_c`7pG@u{;KUb z`S+vdZKvlBb$$LB`{}kf(%&d675ev`XA(E`SI*tMx%$W1FR$ERc&4x3nLiaa(&=xUf;bwB}mA{!VDQb@AeR>ld%R|M9z5mp3n)#IL{qQ8jKY z-N;-@oewpO^5l2-1Cy7(I{%6O^WqnK_J9XQ$awkT!yfo*TQxdR9Wkn-!QmH1VF9YF zDw6Dz)Ie61gR&g-s*@R714Ba#1H&(%P{RubhEf9thF1v;3|2E37{m+a>e%kj?;n5t`1I??Ctp84`}XPC_b)HL ze}3`q)x+D@&)&Or{?3iFPwrjT(9n>Ukv)BU@8=KCAKky2lbsO|;GY;19TyvukdT;= znCS2C9~B*S_`r^DAD#jg%gM=~IkE5KyC>79O-xKm`t%l ztA~e+dsI|xVoG{Ue6pjfS42$Wx;4u_zI_aIEzmPEGID!&ZP>7M?yA1_L;JU#ytIAq zxz*>c?>}&UwN_SGS+My5q*3V=AgDGI9zL5n)M5ahaKEnVIQ1IaxWm zS$TOmIl0+c*_oNySs9t>K=Guc__(-eS$PF18950lIT=}5X&D&}O|6>Rx`4o-@W9a2 z)Qqayriz-zxa7>-qH<{&IayhdG8q|Jpr?R}W##077#JEL328}rIiR?ll(ejgi$M;{q{`|TK)bi)wp9}wf|Nae>`27cH$iMGT ze|`D%38?1h&+or}{`m9#@4vqwBmeyU`{xhP(67I~U40(8s~{I>KVy=&yUTg?wB^zicXG(K_S)Jbg(ElthUD^{({&d4&%c>UtlOKAxy$=Nez&5ZVlFp7x0 zePi0Rso^1Eq1SKRWZq$-#>o+G-hF8V{LC~Yjt;Vb3K0K*imC( zidJ2|WZBa6l(f|6Po6zB7P)fm+EsHCGc(ieTefYxB4#9V)pX0&a+8v6Wu@Q0eETXs z`Jp*Oos(`~`0YQS+@)IL8c~vxSdwa$T$Bo=7>s~E(KRsFHL?sbGO#i*ure{$H82J; xPQ2}oMA49&pOTqY3DsbvYhV&$Xl`X`. +This menu lists all storage drives attached to the emulated machine, and provides the same controls that are accessible by clicking the respective drive's icon on the :doc:`status bar `. Tools ----- diff --git a/usage/statusbar.rst b/usage/statusbar.rst index 54950bf..06c709e 100644 --- a/usage/statusbar.rst +++ b/usage/statusbar.rst @@ -5,6 +5,10 @@ The status bar located at the bottom of the 86Box window provides icons related .. |nbsp| unicode:: 0xA0 0xA0 :trim: +.. |cassette| image:: images/cassette.png + :scale: 150% +.. |cartridge| image:: images/cartridge.png + :scale: 150% .. |floppy_35| image:: images/floppy_35.png :scale: 150% .. |floppy_525| image:: images/floppy_525.png @@ -22,6 +26,28 @@ The status bar located at the bottom of the 86Box window provides icons related .. |sound| image:: images/sound.png :scale: 150% +|cassette| Cassette deck +------------------------ + +A cassette tape icon will appear if :ref:`IBM cassette emulation ` is enabled. + +* **New image:** create a new cassette tape image file. +* **Existing image:** insert a :ref:`cassette tape image file ` into the deck. +* **Existing image (Write-protected):** insert a cassette tape image file into the deck as a read-only tape. +* **Record:** start recording data to the cassette tape. Not available if the tape is read-only. +* **Play:** start playing the cassette tape. +* **Rewind to the beginning:** rewind the cassette tape to its beginning. +* **Fast forward to the end:** fast forward the cassette tape to its end. +* **Eject:** remove the currently-inserted cassette tape from the deck. + +|cartridge| PCjr cartridge slots +-------------------------------- + +Two cartridge icons will appear if the **IBM PCjr** is being emulated. + +* **Image:** insert a :ref:`cartridge image file ` into this slot. Inserting a cartridge will reset the PCjr. +* **Eject:** remove the currently-inserted cartridge from this slot. + |floppy_35| |floppy_525| |nbsp| Floppy drives ---------------------------------------------