https://www.digitalmzx.com/wiki/api.php?action=feedcontributions&feedformat=atom&user=Lachesis 2026-05-07T10:00:14Z User contributions MediaWiki 1.39.7 https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9211 2024-03-17T01:33:20Z

<p>Lachesis: /* Variations */ Correct combination spacings.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How it works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX is derived from a horizontally adjacent pair of text mode pixels in the following manner:<br /> {|class=&quot;wikitable&quot;<br /> |+<br /> !Color<br /> !Left pixel<br /> !Right pixel<br /> |-<br /> |Color I<br /> |'''off'''<br /> |'''off'''<br /> |-<br /> |Color II<br /> |'''on'''<br /> |'''off'''<br /> |-<br /> |Color III<br /> |'''off'''<br /> |'''on'''<br /> |-<br /> |Color IV<br /> |'''on'''<br /> |'''on'''<br /> |}<br /> <br /> If colors II and III seem backwards to experienced programmers, it is not a mistake; this is how the original DOS versions defined these colors.<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first mode to allow full user control over the 256 color palette. It is internally identical to SMZX mode 1, but instead of generating the new colors from a user-defined 16 color palette, it allows direct reading and writing of all 256 colors either through the '''set color # to # # #''' command or with the counters '''SMZX_Rn''', '''SMZX_Gn''', and '''SMZX_Bn'''.<br /> <br /> All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG for the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> (Note that colors II and III are backwards here to compensate for the backwards definitions of colors II and III from the character data. In practice, this won't matter to most users.)<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 completely independent colors as opposed to the effective 16 &quot;base&quot; colors of modes 1 and 2. By default, the colors for each subpalette cXX are defined as:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> Subpalettes 253 through 255 &quot;wrap around&quot; the palette, so e.g. subpalette 253 will contain colors 253, 254, 255, and 0.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Hardware details==<br /> <br /> Super MegaZeux modes 1 and 2 are derived from a quirk of VGA (Video Graphics Array) compatible video adapters. In the video adapters that support SMZX, enabling the 8-bit color flag (0x40) of the Attribute Mode Control register (port 0x3C0 register 0x10) will combine two adjacent 4-bit EGA palette indices into a single 8-bit VGA palette index. This flag is intended for mode 13h only; enabling this in 14p text mode is undefined behavior. Most graphics chips do not render this 8-bit color text mode hack &quot;correctly&quot;.<br /> <br /> Example: given the text mode character byte 0x2d:<br /> <br /> ░░▓░▓▓░▓<br /> <br /> With the palette 0x4F, this text mode byte is typically expanded to 4-bit color indices (hex):<br /> <br /> 4 4 f 4 f f 4 f<br /> <br /> When the 8-bit color flag is enabled, two adjacent 4-bit indices are combined in a big endian manner to create a single 8-bit index (hex):<br /> <br /> 44 f4 ff 4f<br /> <br /> These 8-bit indices are used to index the VGA palette. This is a &quot;normal&quot; SMZX mode implementation.<br /> <br /> ===Variations===<br /> <br /> When combined with horizontal pixel panning (port 0x3C0 register 0x13), this combination usually behaves unexpectedly. For example, with a pixel panning value of 0x01 (shift left one pixel), and values ''x'' and ''y'' as 4-bit colors inherited from the neighboring characters, this same character combines into different colors:<br /> <br /> x 4 4 f 4 f f 4 f y<br /> <br /> x4 4f 4f f4 fy<br /> <br /> Another complication is that 9-pixel wide text modes will switch combination &quot;parity&quot; every other character (extra pixels in brackets):<br /> <br /> 4 4 f 4 f f 4 f [4] 4 4 f 4 f f 4 f [4]<br /> <br /> 44 f4 ff 4f [4]4 4f 4f f4 f[4]<br /> <br /> Typically laptop adapters that perform forced 9-pixel or wider text mode scaling can have this behavior disabled with an Fn+function key combination.<br /> <br /> ===Vendors===<br /> <br /> Chips &amp; Technologies (all models that have been tested), NVIDIA adapters (from between some time in the '90s and some time in the late '00s), and the later VIA S3 Graphics &quot;Chrome&quot; adapters implement &quot;normal&quot; SMZX text mode as described above. No compatibility hacks are required for these vendors.<br /> <br /> ATI graphics cards (from some time in the mid '90s until 2006) shift their text mode to the right by one pixel and seem to combine the 4-bit colors in a ''little'' endian manner, i.e. &quot;4 f&quot; are combined into &quot;f4&quot;. To correct this, MegaZeux applies a horizontal pixel panning value of 0x01 and reverses the index nibbles of all SMZX colors when sending them to the VGA.<br /> <br /> ''Some'' early Oak Technologies chips seem to combine the 4-bit colors in a little endian manner as well, but without the unusual pixel shift that ATI cards had. This needs more testing. MegaZeux currently has no method of detecting this.<br /> <br /> See the compatibility tables below for more info.<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 7000 (AGP)<br /> | 2001<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034280088829489 kepstin]<br /> | <br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | ATI Radeon 9100<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | asie<br /> |-<br /> | ATI Radeon 9200 SE<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034114772189201 kepstin]<br /> | <br /> |-<br /> | ATI Rage Mobility-P (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034067154516729 kepstin]<br /> | <br /> |-<br /> | ATI Rage XL (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034187074718574 kepstin]<br /> | <br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200/400<br /> | 2001<br /> | -<br /> | 2.70, smzxtest<br /> | No<br /> | No<br /> | Terryn, [https://tenforward.social/@kepstin/112034219820312089 kepstin]<br /> |<br /> |-<br /> | NVIDIA GeForce 4 MX420<br /> | 2002<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112034159810882881 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce FX 5200 (AGP)<br /> | 2003<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112040355023624578 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA GeForce 7600 GS (AGP)<br /> | 2006<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | asie<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | 3dfx Voodoo 3 2000 (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034014921477716 kepstin]<br /> | Doubles left pixel.<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling. (ATI detected)<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | No doubling. (ATI detected)<br /> |-<br /> | Cirrus Logic CL-GD5426<br /> | 1993<br /> | -<br /> | smzxtest<br /> | [https://mas.to/@dukeboitans/112100827940981639 dukeboitans]<br /> | Doubles right pixel.<br /> |-<br /> | Cirrus Logic CL-GD5440<br /> | 1995<br /> | -<br /> | smzxtest<br /> | asie<br /> | Doubles right pixel.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 520<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG (Core i5-6200U)<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Matrox MGA Millenium<br /> | 1995<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034329123345918 kepstin]<br /> | No doubling.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | Matrox Mystique<br /> | 1996<br /> | -<br /> | smzxtest<br /> | asie<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NVIDIA GeForce GTX 660<br /> | 2012<br /> | -<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V2/DX<br /> | 1996<br /> | HP Brio 8314<br /> | smzxtest<br /> | [https://misskey.resonite.love/notes/9qwod5kpd2 GreaseMonkey]<br /> | No doubling?<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel.<br /> |-<br /> | Tseng Labs ET4000 AX (ISA)<br /> | 1989<br /> | -<br /> | smzxtest<br /> | [https://mas.to/@dukeboitans/112100818549265679 dukeboitans]<br /> | No doubling.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9210 2024-03-17T01:30:02Z

<p>Lachesis: Add &quot;Hardware Details&quot; section.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How it works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX is derived from a horizontally adjacent pair of text mode pixels in the following manner:<br /> {|class=&quot;wikitable&quot;<br /> |+<br /> !Color<br /> !Left pixel<br /> !Right pixel<br /> |-<br /> |Color I<br /> |'''off'''<br /> |'''off'''<br /> |-<br /> |Color II<br /> |'''on'''<br /> |'''off'''<br /> |-<br /> |Color III<br /> |'''off'''<br /> |'''on'''<br /> |-<br /> |Color IV<br /> |'''on'''<br /> |'''on'''<br /> |}<br /> <br /> If colors II and III seem backwards to experienced programmers, it is not a mistake; this is how the original DOS versions defined these colors.<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first mode to allow full user control over the 256 color palette. It is internally identical to SMZX mode 1, but instead of generating the new colors from a user-defined 16 color palette, it allows direct reading and writing of all 256 colors either through the '''set color # to # # #''' command or with the counters '''SMZX_Rn''', '''SMZX_Gn''', and '''SMZX_Bn'''.<br /> <br /> All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG for the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> (Note that colors II and III are backwards here to compensate for the backwards definitions of colors II and III from the character data. In practice, this won't matter to most users.)<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 completely independent colors as opposed to the effective 16 &quot;base&quot; colors of modes 1 and 2. By default, the colors for each subpalette cXX are defined as:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> Subpalettes 253 through 255 &quot;wrap around&quot; the palette, so e.g. subpalette 253 will contain colors 253, 254, 255, and 0.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Hardware details==<br /> <br /> Super MegaZeux modes 1 and 2 are derived from a quirk of VGA (Video Graphics Array) compatible video adapters. In the video adapters that support SMZX, enabling the 8-bit color flag (0x40) of the Attribute Mode Control register (port 0x3C0 register 0x10) will combine two adjacent 4-bit EGA palette indices into a single 8-bit VGA palette index. This flag is intended for mode 13h only; enabling this in 14p text mode is undefined behavior. Most graphics chips do not render this 8-bit color text mode hack &quot;correctly&quot;.<br /> <br /> Example: given the text mode character byte 0x2d:<br /> <br /> ░░▓░▓▓░▓<br /> <br /> With the palette 0x4F, this text mode byte is typically expanded to 4-bit color indices (hex):<br /> <br /> 4 4 f 4 f f 4 f<br /> <br /> When the 8-bit color flag is enabled, two adjacent 4-bit indices are combined in a big endian manner to create a single 8-bit index (hex):<br /> <br /> 44 f4 ff 4f<br /> <br /> These 8-bit indices are used to index the VGA palette. This is a &quot;normal&quot; SMZX mode implementation.<br /> <br /> ===Variations===<br /> <br /> When combined with horizontal pixel panning (port 0x3C0 register 0x13), this combination usually behaves unexpectedly. For example, with a pixel panning value of 0x01 (shift left one pixel), and values ''x'' and ''y'' as 4-bit colors inherited from the neighboring characters, this same character combines into different colors:<br /> <br /> x 4 4 f 4 f f 4 f y<br /> <br /> x4 4f 4f f4 fy<br /> <br /> Another complication is that 9-pixel wide text modes will switch combination &quot;parity&quot; every other character (extra pixels in brackets):<br /> <br /> 4 4 f 4 f f 4 f [4] 4 4 f 4 f f 4 f [4]<br /> <br /> 44 f4 ff 4f [4]4 4f 4f f4 f[4]<br /> <br /> Typically laptop adapters that perform forced 9-pixel or wider text mode scaling can have this behavior disabled with an Fn+function key combination.<br /> <br /> ===Vendors===<br /> <br /> Chips &amp; Technologies (all models that have been tested), NVIDIA adapters (from between some time in the '90s and some time in the late '00s), and the later VIA S3 Graphics &quot;Chrome&quot; adapters implement &quot;normal&quot; SMZX text mode as described above. No compatibility hacks are required for these vendors.<br /> <br /> ATI graphics cards (from some time in the mid '90s until 2006) shift their text mode to the right by one pixel and seem to combine the 4-bit colors in a ''little'' endian manner, i.e. &quot;4 f&quot; are combined into &quot;f4&quot;. To correct this, MegaZeux applies a horizontal pixel panning value of 0x01 and reverses the index nibbles of all SMZX colors when sending them to the VGA.<br /> <br /> ''Some'' early Oak Technologies chips seem to combine the 4-bit colors in a little endian manner as well, but without the unusual pixel shift that ATI cards had. This needs more testing. MegaZeux currently has no method of detecting this.<br /> <br /> See the compatibility tables below for more info.<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 7000 (AGP)<br /> | 2001<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034280088829489 kepstin]<br /> | <br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | ATI Radeon 9100<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | asie<br /> |-<br /> | ATI Radeon 9200 SE<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034114772189201 kepstin]<br /> | <br /> |-<br /> | ATI Rage Mobility-P (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034067154516729 kepstin]<br /> | <br /> |-<br /> | ATI Rage XL (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034187074718574 kepstin]<br /> | <br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200/400<br /> | 2001<br /> | -<br /> | 2.70, smzxtest<br /> | No<br /> | No<br /> | Terryn, [https://tenforward.social/@kepstin/112034219820312089 kepstin]<br /> |<br /> |-<br /> | NVIDIA GeForce 4 MX420<br /> | 2002<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112034159810882881 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce FX 5200 (AGP)<br /> | 2003<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112040355023624578 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA GeForce 7600 GS (AGP)<br /> | 2006<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | asie<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | 3dfx Voodoo 3 2000 (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034014921477716 kepstin]<br /> | Doubles left pixel.<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling. (ATI detected)<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | No doubling. (ATI detected)<br /> |-<br /> | Cirrus Logic CL-GD5426<br /> | 1993<br /> | -<br /> | smzxtest<br /> | [https://mas.to/@dukeboitans/112100827940981639 dukeboitans]<br /> | Doubles right pixel.<br /> |-<br /> | Cirrus Logic CL-GD5440<br /> | 1995<br /> | -<br /> | smzxtest<br /> | asie<br /> | Doubles right pixel.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 520<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG (Core i5-6200U)<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Matrox MGA Millenium<br /> | 1995<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034329123345918 kepstin]<br /> | No doubling.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | Matrox Mystique<br /> | 1996<br /> | -<br /> | smzxtest<br /> | asie<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NVIDIA GeForce GTX 660<br /> | 2012<br /> | -<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V2/DX<br /> | 1996<br /> | HP Brio 8314<br /> | smzxtest<br /> | [https://misskey.resonite.love/notes/9qwod5kpd2 GreaseMonkey]<br /> | No doubling?<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel.<br /> |-<br /> | Tseng Labs ET4000 AX (ISA)<br /> | 1989<br /> | -<br /> | smzxtest<br /> | [https://mas.to/@dukeboitans/112100818549265679 dukeboitans]<br /> | No doubling.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9209 2024-03-16T20:52:25Z

<p>Lachesis: /* How It Works */ Clarify and fix typos.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How it works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX is derived from a horizontally adjacent pair of text mode pixels in the following manner:<br /> {|class=&quot;wikitable&quot;<br /> |+<br /> !Color<br /> !Left pixel<br /> !Right pixel<br /> |-<br /> |Color I<br /> |'''off'''<br /> |'''off'''<br /> |-<br /> |Color II<br /> |'''on'''<br /> |'''off'''<br /> |-<br /> |Color III<br /> |'''off'''<br /> |'''on'''<br /> |-<br /> |Color IV<br /> |'''on'''<br /> |'''on'''<br /> |}<br /> <br /> If colors II and III seem backwards to experienced programmers, it is not a mistake; this is how the original DOS versions defined these colors.<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first mode to allow full user control over the 256 color palette. It is internally identical to SMZX mode 1, but instead of generating the new colors from a user-defined 16 color palette, it allows direct reading and writing of all 256 colors either through the '''set color # to # # #''' command or with the counters '''SMZX_Rn''', '''SMZX_Gn''', and '''SMZX_Bn'''.<br /> <br /> All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG for the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> (Note that colors II and III are backwards here to compensate for the backwards definitions of colors II and III from the character data. In practice, this won't matter to most users.)<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 completely independent colors as opposed to the effective 16 &quot;base&quot; colors of modes 1 and 2. By default, the colors for each subpalette cXX are defined as:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> Subpalettes 253 through 255 &quot;wrap around&quot; the palette, so e.g. subpalette 253 will contain colors 253, 254, 255, and 0.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 7000 (AGP)<br /> | 2001<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034280088829489 kepstin]<br /> | <br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | ATI Radeon 9100<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | asie<br /> |-<br /> | ATI Radeon 9200 SE<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034114772189201 kepstin]<br /> | <br /> |-<br /> | ATI Rage Mobility-P (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034067154516729 kepstin]<br /> | <br /> |-<br /> | ATI Rage XL (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034187074718574 kepstin]<br /> | <br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200/400<br /> | 2001<br /> | -<br /> | 2.70, smzxtest<br /> | No<br /> | No<br /> | Terryn, [https://tenforward.social/@kepstin/112034219820312089 kepstin]<br /> |<br /> |-<br /> | NVIDIA GeForce 4 MX420<br /> | 2002<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112034159810882881 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce FX 5200 (AGP)<br /> | 2003<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112040355023624578 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA GeForce 7600 GS (AGP)<br /> | 2006<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | asie<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | 3dfx Voodoo 3 2000 (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034014921477716 kepstin]<br /> | Doubles left pixel.<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling. (ATI detected)<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | No doubling. (ATI detected)<br /> |-<br /> | Cirrus Logic CL-GD5426<br /> | 1993<br /> | -<br /> | smzxtest<br /> | [https://mas.to/@dukeboitans/112100827940981639 dukeboitans]<br /> | Doubles right pixel.<br /> |-<br /> | Cirrus Logic CL-GD5440<br /> | 1995<br /> | -<br /> | smzxtest<br /> | asie<br /> | Doubles right pixel.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 520<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG (Core i5-6200U)<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Matrox MGA Millenium<br /> | 1995<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034329123345918 kepstin]<br /> | No doubling.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | Matrox Mystique<br /> | 1996<br /> | -<br /> | smzxtest<br /> | asie<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NVIDIA GeForce GTX 660<br /> | 2012<br /> | -<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V2/DX<br /> | 1996<br /> | HP Brio 8314<br /> | smzxtest<br /> | [https://misskey.resonite.love/notes/9qwod5kpd2 GreaseMonkey]<br /> | No doubling?<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel.<br /> |-<br /> | Tseng Labs ET4000 AX (ISA)<br /> | 1989<br /> | -<br /> | smzxtest<br /> | [https://mas.to/@dukeboitans/112100818549265679 dukeboitans]<br /> | No doubling.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9204 2024-03-09T09:51:37Z

<p>Lachesis: /* Incompatible hardware */ Add NVIDIA GeForce GTX 660.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 7000 (AGP)<br /> | 2001<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034280088829489 kepstin]<br /> | <br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | ATI Radeon 9200 SE<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034114772189201 kepstin]<br /> | <br /> |-<br /> | ATI Rage Mobility-P (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034067154516729 kepstin]<br /> | <br /> |-<br /> | ATI Rage XL (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034187074718574 kepstin]<br /> | <br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200/400<br /> | 2001<br /> | -<br /> | 2.70, smzxtest<br /> | No<br /> | No<br /> | Terryn, [https://tenforward.social/@kepstin/112034219820312089 kepstin]<br /> |<br /> |-<br /> | NVIDIA GeForce 4 MX420<br /> | 2002<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112034159810882881 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce FX 5200 (AGP)<br /> | 2003<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112040355023624578 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | 3dfx Voodoo 3 2000 (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034014921477716 kepstin]<br /> | Doubles left pixel.<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling. (ATI detected)<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | No doubling. (ATI detected)<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 520<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG (Core i5-6200U)<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Matrox MGA Millenium<br /> | 1995<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034329123345918 kepstin]<br /> | No doubling.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NVIDIA GeForce GTX 660<br /> | 2012<br /> | -<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel.<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9203 2024-03-05T18:38:18Z

<p>Lachesis: /* Incompatible hardware */ Acer Aspire E 15 was most likely using the Intel HD, not the NVIDIA.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 7000 (AGP)<br /> | 2001<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034280088829489 kepstin]<br /> | <br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | ATI Radeon 9200 SE<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034114772189201 kepstin]<br /> | <br /> |-<br /> | ATI Rage Mobility-P (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034067154516729 kepstin]<br /> | <br /> |-<br /> | ATI Rage XL (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034187074718574 kepstin]<br /> | <br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200/400<br /> | 2001<br /> | -<br /> | 2.70, smzxtest<br /> | No<br /> | No<br /> | Terryn, [https://tenforward.social/@kepstin/112034219820312089 kepstin]<br /> |<br /> |-<br /> | NVIDIA GeForce 4 MX420<br /> | 2002<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112034159810882881 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce FX 5200 (AGP)<br /> | 2003<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112040355023624578 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | 3dfx Voodoo 3 2000 (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034014921477716 kepstin]<br /> | Doubles left pixel.<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling. (ATI detected)<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | No doubling. (ATI detected)<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 520<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG (Core i5-6200U)<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Matrox MGA Millenium<br /> | 1995<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034329123345918 kepstin]<br /> | No doubling.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel.<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9201 2024-03-04T19:33:19Z

<p>Lachesis: /* Incompatible hardware */ Remove &quot;first 16 colors&quot; since it's not really helpful.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 7000 (AGP)<br /> | 2001<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034280088829489 kepstin]<br /> | <br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | ATI Radeon 9200 SE<br /> | 2003<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034114772189201 kepstin]<br /> | <br /> |-<br /> | ATI Rage Mobility-P (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034067154516729 kepstin]<br /> | <br /> |-<br /> | ATI Rage XL (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | [https://tenforward.social/@kepstin/112034187074718574 kepstin]<br /> | <br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200/400<br /> | 2001<br /> | -<br /> | 2.70, smzxtest<br /> | No<br /> | No<br /> | Terryn, [https://tenforward.social/@kepstin/112034219820312089 kepstin]<br /> |<br /> |-<br /> | NVIDIA GeForce 4 MX420<br /> | 2002<br /> | -<br /> | smzxtest<br /> | No<br /> | No<br /> | [https://tenforward.social/@kepstin/112034159810882881 kepstin]<br /> | <br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | 3dfx Voodoo 3 2000 (AGP)<br /> | 1999<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034014921477716 kepstin]<br /> | Doubles left pixel.<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling. (ATI detected)<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | No doubling. (ATI detected)<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Matrox MGA Millenium<br /> | 1995<br /> | -<br /> | smzxtest<br /> | [https://tenforward.social/@kepstin/112034329123345918 kepstin]<br /> | No doubling.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | NVIDIA GeForce 940MX<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel.<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9199 2024-03-04T05:59:42Z

<p>Lachesis: /* Compatible hardware */ Add S3 UniChrome Pro.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200<br /> | 2001<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | Terryn<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |-<br /> | S3 UniChrome Pro (VIA VT3344)<br /> | 2006<br /> | Neoware CA21 (VIA CN700)<br /> | 2.93<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | Displays regular text mode, first 16 colors of VGA palette. The colors are derived from SMZX colors X0h and everything is shifted left by 1 pixel, suggesting ati_fix is being applied. This card needs further testing.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NVIDIA GeForce 940MX<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9198 2024-03-03T22:37:19Z

<p>Lachesis: /* Incompatible hardware */ Add NVIDIA GeForce 940MX.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X300<br /> | 2005<br /> | ThinkPad T43<br /> | smzxtest<br /> | Yes<br /> | Yes<br /> | pagerorgy<br /> |<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200<br /> | 2001<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | Terryn<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Oak Technology OTi037C<br /> | 1988<br /> | -<br /> | smzxtest<br /> | Yes<br /> | No<br /> | [https://cohost.org/asie/post/4858546-call-to-action-use#comment-7fc117fe-199a-4aca-9dfe-b87fa7234592 SpindleyQ]<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Mobility Radeon X1300<br /> | 2006<br /> | IBM ThinkPad T60<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | Displays regular text mode, first 16 colors of VGA palette. The colors are derived from SMZX colors X0h and everything is shifted left by 1 pixel, suggesting ati_fix is being applied. This card needs further testing.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Matrox Millenium G200 (AGP)<br /> | 1998<br /> | -<br /> | smzxtest<br /> | pagerorgy<br /> | No doubling.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256AV (NM2200)<br /> | 1998<br /> | IBM ThinkPad 380Z<br /> | smzxtest<br /> | [https://pouet.chapril.org/@bartitsu59/112033087218073323 bartitsu59]<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NVIDIA GeForce 940MX<br /> | 2016<br /> | Acer Aspire E 15 E5-575G-53VG<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | SiS 530<br /> | 1998<br /> | Compaq Presario 5184<br /> | smzxtest<br /> | [https://mastodon.social/@indigoparadox/112032243607415455 indigoparadox]<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9191 2024-03-03T06:00:46Z

<p>Lachesis: /* Incompatible hardware */ Add Intel HD Graphics 2000.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200<br /> | 2001<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | Terryn<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | Displays regular text mode, first 16 colors of VGA palette. The colors are derived from SMZX colors X0h and everything is shifted left by 1 pixel, suggesting ati_fix is being applied. This card needs further testing.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> <br /> |-<br /> | Intel HD Graphics 2000<br /> | 2011<br /> | Intel Core i5-2400<br /> | smzxtest<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9190 2024-02-26T03:11:27Z

<p>Lachesis: /* Windows with MSYS2 */ Add autotools, cmake, and diffutils.</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For developing and testing MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. MSYS2 no longer works on 32-bit Windows and recommends the UCRT64 environment, so that will be used here.<br /> <br /> It is no longer recommended to produce release builds with MSYS2, as they have increased the default architecture of MINGW32 to '''pentium4''' and the default architecture of MINGW64 to '''nocona'''. MegaZeux still targets '''i686''' and '''x86-64''' respectively. While most dependencies can be rebuilt, MSYS2 may or may not embed system library stubs that require the newer architectures into the binary (untested). Linux Mingw-w64 cross compilers are now recommended for release builds instead.<br /> <br /> ===Windows with MSYS2===<br /> Run '''ucrt64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-pkgconf<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''ucrt64.exe''', add the folder containing your dependencies (generally ''C:\msys64\ucrt64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S autoconf<br /> yes Y | pacman -S automake<br /> yes Y | pacman -S libtool<br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-clang<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-cmake<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-diffutils<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-imagemagick<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-ntldd<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\ucrt64\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''sdl12-compat-devel'' (''SDL-devel'' for older Fedora releases).<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.93<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Multiarchitecture .app===<br /> ''THIS SECTION IS A WORK IN PROGRESS.'' Please refer to the documentation in arch/darwin/ and docs/platform_matrix.html for more details.<br /> <br /> ====Environment Setup====<br /> This is heavily dependent on the architectures being targeted. For compilation on a Mac, typically select the highest Xcode being targeted as a base and install the lower versions using [https://github.com/devernay/xcodelegacy XcodeLegacy]. Linux cross compilation isn't tested currently.<br /> <br /> {|class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! MegaZeux PREFIX<br /> ! SDK version<br /> ! OS minimum version<br /> ! Xcode toolchain<br /> ! Cross toolchain<br /> ! Notes<br /> |-<br /> | arm64<br /> | PREFIX_ARM64<br /> | 11.0<br /> | 11.0<br /> | Xcode 12.2 or higher<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Untested.<br /> |-<br /> | arm64e<br /> | PREFIX_ARM64E<br /> | FIXME<br /> | FIXME<br /> | FIXME<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Untested.<br /> |-<br /> | i686<br /> | PREFIX_I686<br /> | 10.13<br /> | 10.6<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Mac OS X Snow Leopard is targeted to support Core Duo Macs.<br /> |-<br /> | x86_64<br /> | PREFIX_AMD64<br /> | 10.13<br /> | 10.6<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> |<br /> |-<br /> | x86_64h<br /> | PREFIX_AMD64H<br /> | 10.13<br /> | 10.9<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | OS X Mavericks is the minimum version for this architecture.<br /> |-<br /> | ppc<br /> | PREFIX_PPC<br /> | 10.4<br /> | 10.4<br /> | Xcode 3.2.6<br /> | [https://github.com/tpoechtrager/osxcross/blob/ppc-test/README.PPC-GCC-5.5.0-SDK-10.5.md osxcross (ppc-test)]<br /> | Mac OS X Tiger is targeted to support G3 Macs.<br /> |-<br /> | ppc64<br /> | PREFIX_PPC64<br /> | 10.5<br /> | 10.5<br /> | Xcode 3.2.6<br /> | [https://github.com/tpoechtrager/osxcross/blob/ppc-test/README.PPC-GCC-5.5.0-SDK-10.5.md osxcross (ppc-test)]<br /> | Mac OS X Leopard is targeted as Objective-C is broken for PowerPC64 in the Tiger SDK.<br /> |}<br /> <br /> WARNING: if targeting PowerPC64 via XcodeLegacy, you need to revert a fix that XcodeLegacy applies to libgcc_s.10.5.dylib.<br /> <br /> cp /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib.vectorfix<br /> cp /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib.bak /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib<br /> <br /> ====Other required tools====<br /> <br /> [https://github.com/auriamg/macdylibbundler dylibbundler], which can be installed using MacPorts:<br /> <br /> sudo port install dylibbundler<br /> <br /> WARNING: dylibbundler relies on otool and therefore llvm-objdump. LLVM currently lacks support for reading the LC_UNIXTHREAD load commands of PowerPC64 Mach-O executables, so bundling will fail. You may need to have a pre-LLVM Xcode selected to complete a PowerPC64 build.<br /> <br /> ====Dependencies====<br /> FIXME!<br /> <br /> ====Compilation====<br /> Unlike most other architectures, the prefix is provided PER ARCHITECTURE to a Makefile meta target.<br /> <br /> ./config.sh --platform darwin-dist --enable-release --enable-lto<br /> <br /> To compile for a given architecture, provide to Make one or more of the PREFIX variables defined in the table above:<br /> <br /> make PREFIX_I686=~/megazeux-dependencies/macos/i686 PREFIX_AMD64=~/megazeux-dependencies/macos/x86_64<br /> <br /> For each architecture, Make will invoke:<br /> <br /> make ARCH=[arch] PREFIX=[prefix] package<br /> make ARCH=[arch] PREFIX=[prefix] clean<br /> <br /> The &quot;package&quot; target is similar to &quot;all&quot;, except afterward, dylibbundler is used to generate a dependency bundle in &quot;bundles/&quot;, and then all binaries are moved to [binary].[arch].<br /> <br /> Finally, Make will perform<br /> <br /> make lipo<br /> <br /> to merge all of the currently existing [binary].[arch] files into a new multiarchitecture file [binary].<br /> <br /> ====Packaging====<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make archive<br /> You can test the .app files generated in build/darwin-dist/ to make sure they run. A .dmg will appear in build/dist/darwin-dist/ containing the generated .app files, documentation, and multiarchitecture utilities.<br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbis wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9189 2024-02-25T06:12:12Z

<p>Lachesis: /* Windows */ Replace MINGW64 and MINGW32 instructions with UCRT64.</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For developing and testing MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. MSYS2 no longer works on 32-bit Windows and recommends the UCRT64 environment, so that will be used here.<br /> <br /> It is no longer recommended to produce release builds with MSYS2, as they have increased the default architecture of MINGW32 to '''pentium4''' and the default architecture of MINGW64 to '''nocona'''. MegaZeux still targets '''i686''' and '''x86-64''' respectively. While most dependencies can be rebuilt, MSYS2 may or may not embed system library stubs that require the newer architectures into the binary (untested). Linux Mingw-w64 cross compilers are now recommended for release builds instead.<br /> <br /> ===Windows with MSYS2===<br /> Run '''ucrt64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-pkgconf<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''ucrt64.exe''', add the folder containing your dependencies (generally ''C:\msys64\ucrt64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-clang<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-imagemagick<br /> yes Y | pacman -S mingw-w64-ucrt-x86_64-ntldd<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\ucrt64\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''sdl12-compat-devel'' (''SDL-devel'' for older Fedora releases).<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.93<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Multiarchitecture .app===<br /> ''THIS SECTION IS A WORK IN PROGRESS.'' Please refer to the documentation in arch/darwin/ and docs/platform_matrix.html for more details.<br /> <br /> ====Environment Setup====<br /> This is heavily dependent on the architectures being targeted. For compilation on a Mac, typically select the highest Xcode being targeted as a base and install the lower versions using [https://github.com/devernay/xcodelegacy XcodeLegacy]. Linux cross compilation isn't tested currently.<br /> <br /> {|class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! MegaZeux PREFIX<br /> ! SDK version<br /> ! OS minimum version<br /> ! Xcode toolchain<br /> ! Cross toolchain<br /> ! Notes<br /> |-<br /> | arm64<br /> | PREFIX_ARM64<br /> | 11.0<br /> | 11.0<br /> | Xcode 12.2 or higher<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Untested.<br /> |-<br /> | arm64e<br /> | PREFIX_ARM64E<br /> | FIXME<br /> | FIXME<br /> | FIXME<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Untested.<br /> |-<br /> | i686<br /> | PREFIX_I686<br /> | 10.13<br /> | 10.6<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Mac OS X Snow Leopard is targeted to support Core Duo Macs.<br /> |-<br /> | x86_64<br /> | PREFIX_AMD64<br /> | 10.13<br /> | 10.6<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> |<br /> |-<br /> | x86_64h<br /> | PREFIX_AMD64H<br /> | 10.13<br /> | 10.9<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | OS X Mavericks is the minimum version for this architecture.<br /> |-<br /> | ppc<br /> | PREFIX_PPC<br /> | 10.4<br /> | 10.4<br /> | Xcode 3.2.6<br /> | [https://github.com/tpoechtrager/osxcross/blob/ppc-test/README.PPC-GCC-5.5.0-SDK-10.5.md osxcross (ppc-test)]<br /> | Mac OS X Tiger is targeted to support G3 Macs.<br /> |-<br /> | ppc64<br /> | PREFIX_PPC64<br /> | 10.5<br /> | 10.5<br /> | Xcode 3.2.6<br /> | [https://github.com/tpoechtrager/osxcross/blob/ppc-test/README.PPC-GCC-5.5.0-SDK-10.5.md osxcross (ppc-test)]<br /> | Mac OS X Leopard is targeted as Objective-C is broken for PowerPC64 in the Tiger SDK.<br /> |}<br /> <br /> WARNING: if targeting PowerPC64 via XcodeLegacy, you need to revert a fix that XcodeLegacy applies to libgcc_s.10.5.dylib.<br /> <br /> cp /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib.vectorfix<br /> cp /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib.bak /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib<br /> <br /> ====Other required tools====<br /> <br /> [https://github.com/auriamg/macdylibbundler dylibbundler], which can be installed using MacPorts:<br /> <br /> sudo port install dylibbundler<br /> <br /> WARNING: dylibbundler relies on otool and therefore llvm-objdump. LLVM currently lacks support for reading the LC_UNIXTHREAD load commands of PowerPC64 Mach-O executables, so bundling will fail. You may need to have a pre-LLVM Xcode selected to complete a PowerPC64 build.<br /> <br /> ====Dependencies====<br /> FIXME!<br /> <br /> ====Compilation====<br /> Unlike most other architectures, the prefix is provided PER ARCHITECTURE to a Makefile meta target.<br /> <br /> ./config.sh --platform darwin-dist --enable-release --enable-lto<br /> <br /> To compile for a given architecture, provide to Make one or more of the PREFIX variables defined in the table above:<br /> <br /> make PREFIX_I686=~/megazeux-dependencies/macos/i686 PREFIX_AMD64=~/megazeux-dependencies/macos/x86_64<br /> <br /> For each architecture, Make will invoke:<br /> <br /> make ARCH=[arch] PREFIX=[prefix] package<br /> make ARCH=[arch] PREFIX=[prefix] clean<br /> <br /> The &quot;package&quot; target is similar to &quot;all&quot;, except afterward, dylibbundler is used to generate a dependency bundle in &quot;bundles/&quot;, and then all binaries are moved to [binary].[arch].<br /> <br /> Finally, Make will perform<br /> <br /> make lipo<br /> <br /> to merge all of the currently existing [binary].[arch] files into a new multiarchitecture file [binary].<br /> <br /> ====Packaging====<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make archive<br /> You can test the .app files generated in build/darwin-dist/ to make sure they run. A .dmg will appear in build/dist/darwin-dist/ containing the generated .app files, documentation, and multiarchitecture utilities.<br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbis wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9188 2024-02-25T01:43:56Z

<p>Lachesis: /* Incompatible hardware */ Add Intel GMA 3100 and ATI Radeon HD 3450/B629.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200<br /> | 2001<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | Terryn<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon HD 3450 (B629)<br /> | 2007<br /> | -<br /> | 2.93<br /> | Lachesis<br /> | Displays regular text mode, first 16 colors of VGA palette. The colors are derived from SMZX colors X0h and everything is shifted left by 1 pixel, suggesting ati_fix is being applied. This card needs further testing.<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | Intel GMA 3100 (Intel G33)<br /> | 2007<br /> | Dell Inspiron 530<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9187 2024-02-23T19:10:49Z

<p>Lachesis: /* Compatible hardware */ The GeForce 2 was specifically a &quot;MX 100/200&quot; (according to the card or driver itself) and was reported by Terryn.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2 MX100/200<br /> | 2001<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | Terryn<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9186 2024-02-23T19:00:37Z

<p>Lachesis: /* Incompatible hardware */ Add Intel 852GMV.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | Intel 852GMV<br /> | 2004<br /> | Dell Inspiron 1150<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, first 16 colors of VGA palette.<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9185 2024-02-23T08:26:23Z

<p>Lachesis: /* Incompatible hardware */ Add NeoMagic MagicGraph256ZX.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD (NM2160)<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | NeoMagic MagicGraph256ZX (NM2360)<br /> | 1999<br /> | IBM ThinkPad 600X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9184 2024-02-22T21:46:01Z

<p>Lachesis: /* Compatible hardware */ Confirmed my old Toshiba model (sadly can't retest it, though).</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T CT65548<br /> | 1995<br /> | Toshiba Satellite 100CS<br /> | 2.70<br /> | No<br /> | No<br /> | Lachesis<br /> |<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9183 2024-02-22T21:20:57Z

<p>Lachesis: Split &quot;Compatibility&quot; from &quot;How It Works&quot;.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ==Compatibility==<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ===Compatible hardware===<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> Anecdotal hardware with no known specific version or verification:<br /> * Lachesis had a Toshiba Satellite Pro—likely 400CDS or 425CDS—with a C&amp;T chip that produced NVIDIA-style hardware SMZX with no issues.<br /> <br /> <br /> ===Incompatible hardware===<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9182 2024-02-22T21:20:08Z

<p>Lachesis: /* Compatibility */ Make the compatible/incompatible hardware tables their own sections.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> ====Compatible hardware====<br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> Anecdotal hardware with no known specific version or verification:<br /> * Lachesis had a Toshiba Satellite Pro—likely 400CDS or 425CDS—with a C&amp;T chip that produced NVIDIA-style hardware SMZX with no issues.<br /> <br /> <br /> ====Incompatible hardware====<br /> <br /> The most common failure mode for SMZX in video adapters seems to be a &quot;pseudo-SMZX&quot; mode with a 320x350 resolution where, for every pair of text mode pixels, the left 4-bit color is selected instead of combining their respective 4-bit colors into an 8-bit color.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9181 2024-02-20T23:00:12Z

<p>Lachesis: Fix NVIDIA and ATI capitalization in the summary (both are always allcaps, see previous edit), add C&amp;T to the list of confirmed vendors supporting SMZX.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported by NVIDIA, C&amp;T, ATI, and possibly other chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> * Anecdotal hardware with no known specific version or verification:<br /> ** Lachesis had a Toshiba Satellite Pro—likely 400CDS or 425CDS—with a C&amp;T chip that produced NVIDIA-style hardware SMZX with no issues.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9180 2024-02-20T22:57:49Z

<p>Lachesis: /* Compatibility */ Correct NVIDIA spelling. It is always all-caps, sometimes &quot;nVIDIA&quot; in very old official sources, &quot;Nvidia&quot; in non-official sources like news articles, but never &quot;nVidia&quot;.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported almost exclusively by nVidia and ATi chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> * Anecdotal hardware with no known specific version or verification:<br /> ** Lachesis had a Toshiba Satellite Pro—likely 400CDS or 425CDS—with a C&amp;T chip that produced NVIDIA-style hardware SMZX with no issues.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | NVIDIA GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | NVIDIA GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | NVIDIA RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9179 2024-02-20T21:27:53Z

<p>Lachesis: /* Compatibility */ Split working/nonworking tables; add Compaq and Toshiba adapters.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported almost exclusively by nVidia and ATi chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> * Anecdotal hardware with no known specific version or verification:<br /> ** Lachesis had a Toshiba Satellite Pro—likely 400CDS or 425CDS—with a C&amp;T chip that produced Nvidia-style hardware SMZX with no issues.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with Working SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Reported by<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | Yes<br /> | Yes<br /> | ?<br /> | ati_fix<br /> |-<br /> | C&amp;T F65554<br /> | 1997<br /> | Toshiba Satellite Pro 465CDX<br /> | 2.70<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> |<br /> |-<br /> | nVidia GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | nVidia GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |-<br /> | Nvidia GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 BFeely]<br /> |<br /> |-<br /> | nVidia RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | No<br /> | No<br /> | ?<br /> |<br /> |}<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+Hardware with No SMZX Support<br /> !Video Adapter<br /> !Year<br /> !Device(s)<br /> !Last tested MZX version<br /> !Reported by<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | IBM ThinkPad 560X<br /> | 2.93<br /> | Lachesis<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | Paradise/Western Digital SVGA (unknown model)<br /> | 1994<br /> | Compaq LTE Elite 4/50CX<br /> | 2.70<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1918121416 Jon Campbell]<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | S3 Trio64V<br /> | 1995<br /> | Compaq 4704<br /> | 2.93<br /> | Elig<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9178 2024-02-12T18:40:35Z

<p>Lachesis: /* Packaging */ replace with Multiarchitecture .app</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-pkgconf<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-pkgconf<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''sdl12-compat-devel'' (''SDL-devel'' for older Fedora releases).<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.93<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Multiarchitecture .app===<br /> ''THIS SECTION IS A WORK IN PROGRESS.'' Please refer to the documentation in arch/darwin/ and docs/platform_matrix.html for more details.<br /> <br /> ====Environment Setup====<br /> This is heavily dependent on the architectures being targeted. For compilation on a Mac, typically select the highest Xcode being targeted as a base and install the lower versions using [https://github.com/devernay/xcodelegacy XcodeLegacy]. Linux cross compilation isn't tested currently.<br /> <br /> {|class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! MegaZeux PREFIX<br /> ! SDK version<br /> ! OS minimum version<br /> ! Xcode toolchain<br /> ! Cross toolchain<br /> ! Notes<br /> |-<br /> | arm64<br /> | PREFIX_ARM64<br /> | 11.0<br /> | 11.0<br /> | Xcode 12.2 or higher<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Untested.<br /> |-<br /> | arm64e<br /> | PREFIX_ARM64E<br /> | FIXME<br /> | FIXME<br /> | FIXME<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Untested.<br /> |-<br /> | i686<br /> | PREFIX_I686<br /> | 10.13<br /> | 10.6<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | Mac OS X Snow Leopard is targeted to support Core Duo Macs.<br /> |-<br /> | x86_64<br /> | PREFIX_AMD64<br /> | 10.13<br /> | 10.6<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> |<br /> |-<br /> | x86_64h<br /> | PREFIX_AMD64H<br /> | 10.13<br /> | 10.9<br /> | Xcode 9.4.1<br /> | [https://github.com/tpoechtrager/osxcross osxcross]<br /> | OS X Mavericks is the minimum version for this architecture.<br /> |-<br /> | ppc<br /> | PREFIX_PPC<br /> | 10.4<br /> | 10.4<br /> | Xcode 3.2.6<br /> | [https://github.com/tpoechtrager/osxcross/blob/ppc-test/README.PPC-GCC-5.5.0-SDK-10.5.md osxcross (ppc-test)]<br /> | Mac OS X Tiger is targeted to support G3 Macs.<br /> |-<br /> | ppc64<br /> | PREFIX_PPC64<br /> | 10.5<br /> | 10.5<br /> | Xcode 3.2.6<br /> | [https://github.com/tpoechtrager/osxcross/blob/ppc-test/README.PPC-GCC-5.5.0-SDK-10.5.md osxcross (ppc-test)]<br /> | Mac OS X Leopard is targeted as Objective-C is broken for PowerPC64 in the Tiger SDK.<br /> |}<br /> <br /> WARNING: if targeting PowerPC64 via XcodeLegacy, you need to revert a fix that XcodeLegacy applies to libgcc_s.10.5.dylib.<br /> <br /> cp /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib.vectorfix<br /> cp /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib.bak /Developer/SDKs/MacOSX10.5.sdk/usr/lib/libgcc_s.10.5.dylib<br /> <br /> ====Other required tools====<br /> <br /> [https://github.com/auriamg/macdylibbundler dylibbundler], which can be installed using MacPorts:<br /> <br /> sudo port install dylibbundler<br /> <br /> WARNING: dylibbundler relies on otool and therefore llvm-objdump. LLVM currently lacks support for reading the LC_UNIXTHREAD load commands of PowerPC64 Mach-O executables, so bundling will fail. You may need to have a pre-LLVM Xcode selected to complete a PowerPC64 build.<br /> <br /> ====Dependencies====<br /> FIXME!<br /> <br /> ====Compilation====<br /> Unlike most other architectures, the prefix is provided PER ARCHITECTURE to a Makefile meta target.<br /> <br /> ./config.sh --platform darwin-dist --enable-release --enable-lto<br /> <br /> To compile for a given architecture, provide to Make one or more of the PREFIX variables defined in the table above:<br /> <br /> make PREFIX_I686=~/megazeux-dependencies/macos/i686 PREFIX_AMD64=~/megazeux-dependencies/macos/x86_64<br /> <br /> For each architecture, Make will invoke:<br /> <br /> make ARCH=[arch] PREFIX=[prefix] package<br /> make ARCH=[arch] PREFIX=[prefix] clean<br /> <br /> The &quot;package&quot; target is similar to &quot;all&quot;, except afterward, dylibbundler is used to generate a dependency bundle in &quot;bundles/&quot;, and then all binaries are moved to [binary].[arch].<br /> <br /> Finally, Make will perform<br /> <br /> make lipo<br /> <br /> to merge all of the currently existing [binary].[arch] files into a new multiarchitecture file [binary].<br /> <br /> ====Packaging====<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make archive<br /> You can test the .app files generated in build/darwin-dist/ to make sure they run. A .dmg will appear in build/dist/darwin-dist/ containing the generated .app files, documentation, and multiarchitecture utilities.<br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbis wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9177 2024-01-30T05:41:34Z

<p>Lachesis: /* Compatibility */ Add more detailed information about ATi hacks.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported almost exclusively by nVidia and ATi chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. This causes MegaZeux to tweak the horizontal pixel shift register and reverse the nibble order of each color. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software. This enables its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Support in Hardware<br /> !Video Adapter<br /> !Year<br /> !Device<br /> !Last tested MZX version<br /> !Last working MZX version<br /> !Works?<br /> !Reverse nibbles?<br /> !Horizontal shift hack?<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | 2.70<br /> | ?<br /> | Yes<br /> | Yes<br /> | Yes<br /> | ati_fix<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | ThinkPad 560X<br /> | 2.93<br /> | -<br /> | No<br /> | -<br /> | -<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | nVidia GeForce 2<br /> | 2000<br /> | -<br /> | 2.70<br /> | ?<br /> | Yes<br /> | No<br /> | No<br /> |<br /> |-<br /> | nVidia GeForce 4<br /> | 2002<br /> | -<br /> | 2.70<br /> | ?<br /> | Yes<br /> | No<br /> | No<br /> |<br /> |-<br /> | Nvidia GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | 2.93<br /> | 2.93<br /> | Yes<br /> | No<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 Reported by BFeely.]<br /> |-<br /> | nVidia RIVA TNT2<br /> | 1999<br /> | -<br /> | 2.70<br /> | ?<br /> | Yes<br /> | No<br /> | No<br /> |<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9176 2024-01-20T01:24:24Z

<p>Lachesis: /* Compatibility */ Add GeForce 6200 AGP, clarify mode 3 and lack of hardware support for separate UI rendering.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported almost exclusively by nVidia and ATi chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only work on selected video hardware in DOS versions. Most DOS emulators, including DOSBox, do not support SMZX. Mode 3 was invented for the SDL port and has no hardware equivalent.<br /> ** Prior to MegaZeux 2.93, to support Super MegaZeux correctly on DOS versions of MegaZeux combined with certain graphics cards, the creation of an &quot;ati_fix&quot; file in the same directory as the MegaZeux executable was required. Newer versions of MegaZeux attempt automatic detection.<br /> ** In MegaZeux 2.93 and above, the SVGA renderer can be used to draw SMZX in software, thus enabling its use on any SVGA-compatible graphics card, albeit at a performance cost compared to the EGA renderer.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette.<br /> ** Hardware SMZX in DOS does not support this and still draws the UI in SMZX mode.<br /> ** 8bpp software rendering also doesn't support this and will draw the UI in normal mode but with SMZX palette colors.<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Support in Hardware<br /> !Video Adapter<br /> !Year<br /> !Device<br /> !Working MZX version(s)<br /> !Last tested MZX version<br /> !ati_fix?<br /> !Notes<br /> |-<br /> | ATI Radeon 8500<br /> | 2001<br /> | -<br /> | ?<br /> | 2.70<br /> | Yes<br /> |<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | ThinkPad 560X<br /> | -<br /> | 2.93<br /> | -<br /> | Doubles left pixel, 16 colors.<br /> |-<br /> | nVidia GeForce 2<br /> | 2000<br /> | -<br /> | All<br /> | 2.70<br /> | No<br /> |<br /> |-<br /> | nVidia GeForce 4<br /> | 2002<br /> | -<br /> | All<br /> | 2.70<br /> | No<br /> |<br /> |-<br /> | Nvidia GeForce 6200 (AGP)<br /> | 2005<br /> | -<br /> | All<br /> | 2.93<br /> | No<br /> | [https://github.com/joncampbell123/dosbox-x/issues/4764#issuecomment-1901327031 Reported by BFeely.]<br /> |-<br /> | nVidia RIVA TNT2<br /> | 1999<br /> | -<br /> | All<br /> | 2.70<br /> | No<br /> |<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9175 2024-01-19T08:05:58Z

<p>Lachesis: /* Fedora */ SDL-devel was replaced with sdl12-compat-devel.</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-pkgconf<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-pkgconf<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''sdl12-compat-devel'' (''SDL-devel'' for older Fedora releases).<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.93<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Packaging===<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make lipo<br /> make archive<br /> A .dmg will appear in build/arch/darwin/. Please refer to the documentation in arch/darwin/ for more details.<br /> <br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbis wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9174 2024-01-19T08:02:36Z

<p>Lachesis: /* Windows */ Add pkgconf (required by SDL3).</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-pkgconf<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-pkgconf<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''SDL-devel''.<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.92c<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Packaging===<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make lipo<br /> make archive<br /> A .dmg will appear in build/arch/darwin/. Please refer to the documentation in arch/darwin/ for more details.<br /> <br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbis wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9171 2023-11-09T09:11:42Z

<p>Lachesis: /* Common */ Explicitly document build-base for Alpine.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. Linux and BSD ports are omitted from the table for obvious reasons.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup. For platforms where --enable-kvm is relevant, it was not used. <br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- x86_64 --&gt;<br /> <br /> | '''x86_64''' &lt;br&gt; qemu-system-x86_64 7.2.6<br /> |<br /> * Windows<br /> * Mac OS<br /> * Android<br /> | Debian 12.2<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -smp 4<br /> [image...]<br /> -vga qxl<br /> &lt;/pre&gt;<br /> | 5m06s (-j4) &lt;br&gt; 1m17s (-j4) &lt;br&gt; 23s<br /> | —<br /> | '''run.serial.sh''' currently does not work, use '''run.sh''' instead.<br /> | TODO<br /> | <br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If applicable, set up the '''run.serial.sh''' script (or '''run.sh''') and run it to start QEMU.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> # Debian<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> # Alpine<br /> sudo apk add build-base gdb git zlib-dev libpng-dev libogg-dev libvorbis-dev sdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> # Debian<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> # Alpine<br /> sudo apk cache clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install dialog screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi rxvt-unicode fonts-dejavu<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> sudo apt install dialog<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Place the following in your .profile or .bashrc file:<br /> # Optional: Sway hardware cursors may not work in VirtualBox or QEMU.<br /> export WLR_NO_HARDWARE_CURSORS=1<br /> # Enable tdm when starting either of the first two VTs.<br /> if [ -z &quot;$DISPLAY&quot; ] &amp;&amp; [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ]; then<br /> tdm --disable-long-names || true<br /> fi<br /> <br /> # Place the following line in your .xinitrc file:<br /> # i3 only: xrdb -merge &quot;$HOME&quot;/.Xresources<br /> exec tdm --xstart<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> xrdb -merge &quot;$HOME&quot;/.Xresources<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If applicable, set up the '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9170 2023-11-09T08:52:07Z

<p>Lachesis: /* Extra software */ Fixes for Alpine/i3</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. Linux and BSD ports are omitted from the table for obvious reasons.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup. For platforms where --enable-kvm is relevant, it was not used. <br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- x86_64 --&gt;<br /> <br /> | '''x86_64''' &lt;br&gt; qemu-system-x86_64 7.2.6<br /> |<br /> * Windows<br /> * Mac OS<br /> * Android<br /> | Debian 12.2<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -smp 4<br /> [image...]<br /> -vga qxl<br /> &lt;/pre&gt;<br /> | 5m06s (-j4) &lt;br&gt; 1m17s (-j4) &lt;br&gt; 23s<br /> | —<br /> | '''run.serial.sh''' currently does not work, use '''run.sh''' instead.<br /> | TODO<br /> | <br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If applicable, set up the '''run.serial.sh''' script (or '''run.sh''') and run it to start QEMU.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install dialog screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi rxvt-unicode fonts-dejavu<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> sudo apt install dialog<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Place the following in your .profile or .bashrc file:<br /> # Optional: Sway hardware cursors may not work in VirtualBox or QEMU.<br /> export WLR_NO_HARDWARE_CURSORS=1<br /> # Enable tdm when starting either of the first two VTs.<br /> if [ -z &quot;$DISPLAY&quot; ] &amp;&amp; [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ]; then<br /> tdm --disable-long-names || true<br /> fi<br /> <br /> # Place the following line in your .xinitrc file:<br /> # i3 only: xrdb -merge &quot;$HOME&quot;/.Xresources<br /> exec tdm --xstart<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> xrdb -merge &quot;$HOME&quot;/.Xresources<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If applicable, set up the '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9169 2023-11-03T06:04:45Z

<p>Lachesis: /* Setup */ Move .Xresources setup to the X11-only section.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. Linux and BSD ports are omitted from the table for obvious reasons.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup. For platforms where --enable-kvm is relevant, it was not used. <br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- x86_64 --&gt;<br /> <br /> | '''x86_64''' &lt;br&gt; qemu-system-x86_64 7.2.6<br /> |<br /> * Windows<br /> * Mac OS<br /> * Android<br /> | Debian 12.2<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -smp 4<br /> [image...]<br /> -vga qxl<br /> &lt;/pre&gt;<br /> | 5m06s (-j4) &lt;br&gt; 1m17s (-j4) &lt;br&gt; 23s<br /> | —<br /> | '''run.serial.sh''' currently does not work, use '''run.sh''' instead.<br /> | TODO<br /> | <br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If applicable, set up the '''run.serial.sh''' script (or '''run.sh''') and run it to start QEMU.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> sudo apt install dialog<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Place the following in your .profile or .bashrc file:<br /> # Optional: Sway hardware cursors may not work in VirtualBox or QEMU.<br /> export WLR_NO_HARDWARE_CURSORS=1<br /> # Enable tdm when starting either of the first two VTs.<br /> if [ -z &quot;$DISPLAY&quot; ] &amp;&amp; [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ]; then<br /> tdm --disable-long-names || true<br /> fi<br /> <br /> # Place the following line in your .xinitrc file:<br /> exec tdm --xstart<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If applicable, set up the '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9168 2023-11-03T01:18:04Z

<p>Lachesis: /* Linux/BSD (main architectures) */ Add amd64.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. Linux and BSD ports are omitted from the table for obvious reasons.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup. For platforms where --enable-kvm is relevant, it was not used. <br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- x86_64 --&gt;<br /> <br /> | '''x86_64''' &lt;br&gt; qemu-system-x86_64 7.2.6<br /> |<br /> * Windows<br /> * Mac OS<br /> * Android<br /> | Debian 12.2<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -smp 4<br /> [image...]<br /> -vga qxl<br /> &lt;/pre&gt;<br /> | 5m06s (-j4) &lt;br&gt; 1m17s (-j4) &lt;br&gt; 23s<br /> | —<br /> | '''run.serial.sh''' currently does not work, use '''run.sh''' instead.<br /> | TODO<br /> | <br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> sudo apt install dialog<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Place the following in your .profile or .bashrc file:<br /> # Optional: Sway hardware cursors may not work in VirtualBox or QEMU.<br /> export WLR_NO_HARDWARE_CURSORS=1<br /> # Enable tdm when starting either of the first two VTs.<br /> if [ -z &quot;$DISPLAY&quot; ] &amp;&amp; [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ]; then<br /> tdm --disable-long-names || true<br /> fi<br /> <br /> # Place the following line in your .xinitrc file:<br /> exec tdm --xstart<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9167 2023-11-02T23:43:04Z

<p>Lachesis: /* Extra software */ Explicitly install dialog for tdm, since Debian doesn't have it by default.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> sudo apt install dialog<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Place the following in your .profile or .bashrc file:<br /> # Optional: Sway hardware cursors may not work in VirtualBox or QEMU.<br /> export WLR_NO_HARDWARE_CURSORS=1<br /> # Enable tdm when starting either of the first two VTs.<br /> if [ -z &quot;$DISPLAY&quot; ] &amp;&amp; [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ]; then<br /> tdm --disable-long-names || true<br /> fi<br /> <br /> # Place the following line in your .xinitrc file:<br /> exec tdm --xstart<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9166 2023-11-02T23:40:51Z

<p>Lachesis: /* Extra software */ Fix tdm instructions for Debian, add Sway hardware cursors hack.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Place the following in your .profile or .bashrc file:<br /> # Optional: Sway hardware cursors may not work in VirtualBox or QEMU.<br /> export WLR_NO_HARDWARE_CURSORS=1<br /> # Enable tdm when starting either of the first two VTs.<br /> if [ -z &quot;$DISPLAY&quot; ] &amp;&amp; [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ]; then<br /> tdm --disable-long-names || true<br /> fi<br /> <br /> # Place the following line in your .xinitrc file:<br /> exec tdm --xstart<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9165 2023-10-26T02:24:23Z

<p>Lachesis: /* Compatibility */</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported almost exclusively by nVidia and ATi chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only worked on selected video hardware in DOS versions. DOSBox does not support SMZX.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette. (The main exception to this is 8bpp indexed software rendering, which still has graphical issues.)<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Support in Hardware<br /> !Video Adapter<br /> !Year<br /> !Laptop<br /> !Working MZX version(s)<br /> !Last tested MZX version<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | 1998<br /> | ThinkPad 560X<br /> | -<br /> | 2.93<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Super_MegaZeux&diff=9164 2023-10-26T02:03:44Z

<p>Lachesis: /* Compatibility issues */ Add SMZX hardware support table, MagicGraph128XD.</p> <hr /> <div>{{Game<br /> |title = Super MegaZeux<br /> |image = And.png<br /> |creator = [[MadBrain]], [[Akwende]], [[Exophase]]<br /> |company = n/a<br /> |released = n/a<br /> |genre = [[MegaZeux|MegaZeux Fork]], regular feature since 2.69<br /> |vault = n/a<br /> }}<br /> <br /> '''Super MegaZeux''' (or '''SMZX mode''') is the name for an alternative graphics mode accessible through MegaZeux. Its first mode (SMZX mode 1) was first introduced by [[MadBrain]] in a fork of 2.51s3.2; this original version was referred to as Super MegaZeux 100 Alpha (smzx100a). It relied on a little-documented [[text mode]] supported almost exclusively by nVidia and ATi chipsets. SMZX mode 1 was included in [[MegaZeux#MZXak|MZXAk]], but not in any other MZX releases until MZX 2.69, which sported the original mode plus the more advanced mode 2. Mode 3 was introduced in [[MegaZeux#SDL Port|2.80]], and does not correlate to an actual hardware text mode (as MZX no longer actually relied on text mode).<br /> <br /> SMZX mode can be accessed by setting the '''SMZX_MODE''' counter to 1, 2, or 3. In the editor, the current SMZX mode can be changed with the Select Screen Mode dialog (F11).<br /> <br /> ==How It Works==<br /> SMZX Mode halves the horizontal screen resolution in favor of adding two colors per character, effectively making a color palette of 256 unique colors.<br /> <br /> Each &quot;pixel&quot; in SMZX can be either color I (represented in MZX mode as two 'off' pixels), color II ('on' and 'off'), color III ('off' and 'on') ad color IV (both 'on').<br /> <br /> <br /> ===SMZX Mode 1===<br /> SMZX mode 1, the original mode, generates two new palette colors as intermediates of the two normal-mode colors specified by the palette. This is the simplest Super MegaZeux mode to use, and is used in conjunction with a standard 16 color MZX palette. The example below uses the default palette for simplicity.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 1<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Background of specified palette<br /> |42, 0, 0 (color 4)<br /> |-<br /> |Color II<br /> |1/3 between BG and FG colors<br /> |49, 21, 21<br /> |-<br /> |Color III<br /> |2/3 between BG and FG colors<br /> |56, 42, 42<br /> |-<br /> |Color IV<br /> |Foreground of specified palette<br /> |63, 63, 63 (color 15)<br /> |}<br /> <br /> <br /> ===SMZX Mode 2===<br /> SMZX mode 2 was the first to allow 4 colors per character that the user had full control over. It uses the same color matrix as SMZX mode 1, but instead of automatically generating the new colors off of a standard 16 color palette, it references a user-defined 256 color palette to find the colors. All colors are defined in pairs of 2 hex digits, represented below by 0xNN. Given the same example palette as before, c4F, the colors are referenced as such:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 2<br /> !Palette color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |Uses the background color for both hex digits<br /> |Color #0x44 (68 decimal)<br /> |-<br /> |Color II<br /> |Uses the FG for the most significant hex digit and the BG for the least significant hex digit<br /> |Color #0xF4 (244 decimal)<br /> |-<br /> |Color III<br /> |Uses the BG for the most significant hex digit and the FG fore the least significant hex digit<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color IV<br /> |Uses the foreground color for both hex digits<br /> |Color #0xFF (255 decimal)<br /> |}<br /> <br /> If the color indexes for colors II and III seem backwards to experienced programmers, it is not a mistake; this is how they actually are.<br /> <br /> <br /> ===SMZX Mode 3===<br /> SMZX mode 3, which was added with the SDL port, uses a palette of 256 separate colors as opposed to 16 foreground and 16 background colors (each color, in hex, is a 2-digit pair consisting of the background color and the foreground color). Characters can access these as following:<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Mode 3<br /> !Palette Color<br /> !Derived by<br /> !Example (c4F)<br /> |-<br /> |Color I<br /> |The color in the palette specified by cXX<br /> |Color #0x4F (79 decimal)<br /> |-<br /> |Color II<br /> |Color I plus 1<br /> |Color #0x50 (80 decimal)<br /> |-<br /> |Color III<br /> |Color I plus 2<br /> |Color #0x51 (81 decimal)<br /> |-<br /> |Color IV<br /> |Color I plus 3<br /> |Color #0x52 (82 decimal)<br /> |}<br /> <br /> hence yielding a set of 64 unique color palettes. The colors wrap around, so a character set to color 255 (0xFF) will use color 0 for color II, etc.<br /> <br /> As of MegaZeux 2.90, the color mappings of all 256 subpalettes in SMZX mode 3 can be customized either by using the '''SMZX_IDXx,y''' counter or by reassigning them in the SMZX [[palette editor]].<br /> <br /> ===Compatibility===<br /> <br /> There are some minor and/or past issues with SMZX mode:<br /> <br /> * Modes 1 and 2 only worked on selected video hardware in DOS versions. DOSBox does not support SMZX.<br /> * Prior to MegaZeux 2.90, the Super MegaZeux modes did not leave room in the palette for the reserved UI colors, and thus the UI borrowed the game colors. This resulted in the UI palette looking corrupted, especially in SMZX mode 3. As of MegaZeux 2.90, the UI is almost always drawn in normal mode with the protected palette. (The main exception to this is 8bpp indexed software rendering, which still has graphical issues.)<br /> * SMZX modes are not supported by the (fairly limited) Nintendo DS port.<br /> <br /> {|class=&quot;wikitable&quot;<br /> |+SMZX Support in Hardware<br /> !Video Adapter<br /> !Laptop<br /> !Works?<br /> !Last working version<br /> !Last tested version<br /> !Notes<br /> |-<br /> | NeoMagic MagicGraph128XD<br /> | ThinkPad 560X<br /> | No<br /> | -<br /> | 2.93<br /> | Doubles left pixel, 16 colors.<br /> |}<br /> <br /> ==Notable games that use SMZX mode==<br /> * [[&amp;]] by [[Lancer-X]]<br /> * [[Celestial Altar]] by [[Lancer-X]]<br /> * [[red]] by [[Lancer-X]]<br /> * [[Ultima IV]] (port) by [[Lancer-X]]<br /> * [[Bloodlands]] by [[Maxim]] uses Mode 1 in a novel way: to blur the screen when the player takes damage.<br /> * [[Akwende]]'s Tetris, the pack-in game included with [[MegaZeux#MZXak|MZXak]] 1.0 and above<br /> * [[Kaboink!]] by [[Logicow]]<br /> * [[Hackers Can Turn Your Computer into a Bomb!]]<br /> * [[Murder on the Yellow Express]]<br /> <br /> [[Category:MegaZeux]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9163 2023-10-20T20:41:08Z

<p>Lachesis: /* Extra software */ Add display manager instructions.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> You may need to preset various user roles to use a graphical desktop:<br /> &lt;pre&gt;<br /> # For each user that will be using this:<br /> sudo usermod -a -G video [user]<br /> sudo usermod -a -G audio [user]<br /> sudo usermod -a -G input [user]<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> A launcher for i3 and/or Sway might be useful. By default, these installations use<br /> [https://github.com/dopsi/console-tdm TDM], a lightweight terminal-based startx wrapper<br /> (which also supports Wayland), but this can be done in several ways.<br /> &lt;ul&gt;<br /> &lt;li&gt;<br /> Set up tdm:<br /> &lt;pre&gt;<br /> git clone https://github.com/dopsi/console-tdm<br /> cd console-tdm<br /> sudo make install<br /> &lt;/pre&gt;<br /> For each user that will be using tdm:<br /> &lt;pre&gt;<br /> tdmctl init<br /> # You can skip whichever of these window managers isn't present.<br /> tdmctl add i3 /usr/bin/i3<br /> tdmctl add sway /usr/bin/sway extra<br /> <br /> # Enable an automatic prompt when starting either of the first two VTs.<br /> # Place the following line in your .profile or .bashrc file:<br /> [ -n &quot;$XDG_VTNR&quot; ] &amp;&amp; [ &quot;$XDG_VTNR&quot; -le 2 ] &amp;&amp; exec tdm --disable-long-names<br /> <br /> # Place the following line in your .xinitrc file:<br /> exec tdm --start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For a graphical login, xdm is tolerable in a VM and easy to set up:<br /> &lt;pre&gt;<br /> sudo make install xdm<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alternatively, just use &quot;startx&quot; or &quot;sway&quot; manually. In the case of the former, .xinitrc needs to be preset:<br /> &lt;pre&gt;<br /> exec i3<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9162 2023-10-20T05:06:24Z

<p>Lachesis: /* Setup */ Split &quot;extra packages&quot; off from &quot;common&quot;.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages for the tools and dependencies required to build MegaZeux:<br /> &lt;pre&gt;<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux and run the tests. Debug builds are used to measure the times in the table above, as release builds can be quite slow to make in these VMs. Video is not required for any of these steps.<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If the target supports video or needs extra packages, see &quot;extra software&quot;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Extra software ===<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> The following packages might be useful depending on the platform and setup:<br /> &lt;pre&gt;<br /> # Console utilities.<br /> sudo apt install screen lm-sensors lynx<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> X11 only: Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why QEMU options that have worked in the past are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9161 2023-10-19T10:15:52Z

<p>Lachesis: /* Common */ more optional packages.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages:<br /> &lt;pre&gt;<br /> # Tools and dependencies required to build MegaZeux.<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi lynx<br /> <br /> # Sway might work better on some setups (encountered on AML-S905X-CC v1).<br /> sudo apt install sway xwayland i3status rofi lynx<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # clang may be useful for its sanitizers and built-in fuzzer, but it is quite large.<br /> sudo apt install clang clang-tools llvm<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9160 2023-10-19T05:36:48Z

<p>Lachesis: /* Common */ Improve installed packages list, remove xdm, shorten .Xresources section.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources''' from [https://www.digitalmzx.com/lachesis/.Xresources here]. This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> cd ~<br /> wget https://www.digitalmzx.com/lachesis/.Xresources<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Block the installation of dmenu. In Debian, this is done by creating a file called /etc/apt/preferences.d/no_goosesteppers with the contents:<br /> &lt;pre&gt;<br /> Package: suckless-tools<br /> Pin: origin *<br /> Pin-Priority: -1<br /> &lt;/pre&gt;<br /> Update packages.<br /> &lt;pre&gt;<br /> sudo apt update<br /> sudo apt upgrade<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages:<br /> &lt;pre&gt;<br /> # Tools and dependencies required to build MegaZeux.<br /> sudo apt install build-essential gdb git zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev<br /> <br /> # Graphical environment and browser.<br /> sudo apt install xorg i3 i3lock i3status rofi lynx<br /> <br /> # Extra tools for building libxmp and xmp-cli from source.<br /> sudo apt install autoconf automake libtool pkg-config cmake<br /> <br /> # If this machine or VM is going to be shelled into:<br /> sudo apt install openssh-server<br /> <br /> # If memory compression is required:<br /> sudo apt install zram-tools<br /> &lt;/pre&gt;<br /> Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> cd ~<br /> git clone https://github.com/AliceLR/megazeux<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9159 2023-10-19T05:17:32Z

<p>Lachesis: /* Setup */ add a subsection for the common steps.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images or a similarly configured machine, this is how the VM images above were generated.<br /> <br /> === Common ===<br /> <br /> Debian is assumed in most of these steps, but they can be adapted to other distros. If one of the alternate setups is required, skip the installer steps in this section.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> ! &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages:<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status rofi rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Debian makes xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9158 2023-09-14T19:07:08Z

<p>Lachesis: /* Nintendo Wii U */ Fix packages for Wii U.</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''SDL-devel''.<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.92c<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Packaging===<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make lipo<br /> make archive<br /> A .dmg will appear in build/arch/darwin/. Please refer to the documentation in arch/darwin/ for more details.<br /> <br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbis wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9157 2022-08-31T12:55:42Z

<p>Lachesis: /* Setup */ # comments in .Xresources are nonstandard, use !</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images, this is roughly how all of the VM images above were generated.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> ! &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages (Debian assumed, will be different for other platforms):<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status rofi rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Some Debian i3 packages make xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9156 2022-08-21T20:50:20Z

<p>Lachesis: /* Nintendo Wii U */ The Wii U port has, in fact, been merged.</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''SDL-devel''.<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.92c<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Packaging===<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make lipo<br /> make archive<br /> A .dmg will appear in build/arch/darwin/. Please refer to the documentation in arch/darwin/ for more details.<br /> <br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-libogg ppc-libvorbisidec wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9155 2022-08-21T20:49:56Z

<p>Lachesis: /* DJGPP */ DJGPP has, in fact, been merged.</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''SDL-devel''.<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.92c<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Packaging===<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make lipo<br /> make archive<br /> A .dmg will appear in build/arch/darwin/. Please refer to the documentation in arch/darwin/ for more details.<br /> <br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> NOTE: [https://github.com/AliceLR/megazeux/pull/246/ this port has not yet been merged into mainline MZX.]<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-libogg ppc-libvorbisidec wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=Compiling_MegaZeux&diff=9154 2022-08-21T20:48:47Z

<p>Lachesis: /* DJGPP */</p> <hr /> <div>[[Category:Instructions]] [[Category:MegaZeux]]<br /> Compiling any MegaZeux 2.80 or later source requires a POSIX compatible shell (bash, dash) to be installed. Download the source .tar.bz2 or .tar.xz and extract it to a new folder.<br /> <br /> ==General Commands==<br /> ./config.sh<br /> This will give you help about how to configure MegaZeux.<br /> <br /> ./config.sh --platform unix<br /> To configure the sources. On OS X, the platform is &quot;darwin&quot;, and on Windows the platform is either &quot;win64&quot; or &quot;win32&quot;.<br /> <br /> make<br /> This will build MegaZeux from sources. If it fails, you probably don't have one of SDL, libvorbis, libogg, libpng, zlib or the corresponding dev packages installed.<br /> <br /> make install<br /> This will install MegaZeux to the system. This should not be used with the &quot;unix-devel&quot; platform or any other option intended to run straight out of the source directory.<br /> <br /> Please see debian/README for more information.<br /> <br /> <br /> ==Windows==<br /> For compiling MegaZeux with Windows, the generally supported POSIX platform is [https://www.msys2.org/ '''MSYS2''']. Other available options include MINGW32/msys, Cygwin, etc., but are typically more complicated than MSYS2. Download and install '''MSYS2''' before continuing. If you are using a 64-bit operating system, follow the 64-bit instructions below. If you are using a 32-bit operating system, follow the 32-bit instructions below.<br /> <br /> ===Windows with MSYS2 (64-bit)===<br /> Run '''mingw64.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw64 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-x86_64-zlib<br /> yes Y | pacman -S mingw-w64-x86_64-gcc<br /> yes Y | pacman -S mingw-w64-x86_64-gdb<br /> yes Y | pacman -S mingw-w64-x86_64-libpng<br /> yes Y | pacman -S mingw-w64-x86_64-libogg<br /> yes Y | pacman -S mingw-w64-x86_64-libvorbis<br /> yes Y | pacman -S mingw-w64-x86_64-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win64<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw64.exe''', add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-x86_64-clang<br /> yes Y | pacman -S mingw-w64-x86_64-imagemagick<br /> <br /> ===Windows with MSYS2 (32-bit)===<br /> Run '''mingw32.exe''' in the ''msys2'' directory. You will be in the &quot;{MSYS DIRECTORY}\home\{your username}\&quot; directory. (This will display in the mingw32 shell as either &quot;~&quot; or &quot;/home/{your username}&quot;) <br /> <br /> First, run this command. MSYS2 will need to restart when it is finished.<br /> <br /> yes Y | pacman -Syu<br /> <br /> After restarting MSYS2, run the following commands.<br /> <br /> yes Y | pacman -Su<br /> yes Y | pacman -S git<br /> yes Y | pacman -S make<br /> yes Y | pacman -S mingw-w64-i686-zlib<br /> yes Y | pacman -S mingw-w64-i686-gcc<br /> yes Y | pacman -S mingw-w64-i686-gdb<br /> yes Y | pacman -S mingw-w64-i686-libpng<br /> yes Y | pacman -S mingw-w64-i686-libogg<br /> yes Y | pacman -S mingw-w64-i686-libvorbis<br /> yes Y | pacman -S mingw-w64-i686-SDL2<br /> git clone https://github.com/AliceLR/megazeux.git<br /> cd megazeux<br /> ./config.sh --platform win32<br /> make<br /> <br /> MegaZeux should be built and ready to run! If you are not running MegaZeux from '''mingw32.exe''', add the folder containing your dependencies (generally ''C:\msys32\mingw32\bin'') to your Windows PATH variable. Otherwise, MegaZeux will not be able to start from Explorer.<br /> <br /> The following optional packages may be of use. They are not required or are part of the packaging process for some architectures.<br /> <br /> yes Y | pacman -S nano<br /> yes Y | pacman -S p7zip<br /> yes Y | pacman -S mingw-w64-i686-clang<br /> yes Y | pacman -S mingw-w64-i686-imagemagick<br /> <br /> ===Troubleshooting===<br /> - ''&quot;The program can't start because ___.dll is missing.&quot;''<br /> <br /> If you are running MegaZeux from Explorer, add the folder containing your dependencies (generally ''C:\msys64\mingw64\bin'' or ''C:\msys32\mingw32\bin'') to your Windows PATH variable.<br /> <br /> - ''&quot;The procedure entry point inflateReset2 could not be located in the dynamic link library zlib1.dll.&quot; (and similar errors)''<br /> <br /> This can happen because the Windows PATH variable contains a directory older copy of ''zlib1.dll'' (or the DLL in question). You can use '''where zlib1.dll''' in Command Prompt to view the different PATH locations that contain the DLL, as well as the order in which Windows will try to load it.<br /> <br /> <br /> ==Ubuntu/Debian==<br /> <br /> sudo apt install build-essential<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang.<br /> <br /> supo apt install libpng-dev libogg-dev libvorbis-dev libsdl2-dev <br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''libsdl1.2-dev''.<br /> <br /> To install the latest master, use:<br /> sudo apt install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> sudo apt install devscripts debhelper<br /> Download the packaging tools.<br /> <br /> From the MegaZeux source directory:<br /> debuild -us -uc<br /> <br /> ==Fedora==<br /> <br /> sudo dnf install gcc gcc-c++ make binutils<br /> Download compilers to build MegaZeux. MegaZeux will also build with clang/clang++.<br /> <br /> supo dnf install zlib-devel libpng-devel libogg-devel libvorbis-devel SDL2-devel<br /> Download the dependencies required to build MegaZeux. To build with SDL 1.2, install the package ''SDL-devel''.<br /> <br /> To install the latest master, use:<br /> sudo dnf install git<br /> git clone https://github.com/AliceLR/megazeux.git [dest dir]<br /> Alternatively, download and extract the [https://vault.digitalmzx.net/download.php?latest=src latest .tar.xz or .tar.bz2 source archive] to the desired location.<br /> <br /> See the &quot;general commands&quot; section above for more information.<br /> <br /> ===Packaging===<br /> <br /> The rpm-build package is required:<br /> <br /> sudo dnf install rpm-build<br /> <br /> If you're building from a cloned Git repository, checkout the appropriate MegaZeux version tag. For example:<br /> <br /> git checkout v2.92c<br /> <br /> To build the rpm:<br /> <br /> make distclean<br /> rpm-build -bb --build-in-place megazeux.spec<br /> <br /> <br /> ==Mac OS X==<br /> ===With MacPorts (testing only)===<br /> You will need to install XCode and MacPorts before continuing. This method is suitable only for testing builds, and should not be used to produce releases.<br /> <br /> Compile/install dependencies.<br /> sudo port install zlib libpng libogg libvorbis libsdl<br /> <br /> Navigate to the extracted source directory. If you're building MZX 2.90 and under, please download [https://github.com/AliceLR/megazeux/blob/master/arch/darwin/Makefile.in this updated Makefile.in] and put it in arch/darwin/, otherwise MegaZeux will fail to compile.<br /> <br /> Run ./config.sh with some or all of the following flags:<br /> --platform darwin-devel ---------- Mandatory.<br /> --prefix /opt/local ---------- Mandatory.<br /> --disable-libsdl2 ---------- Use this if building against SDL 1.2 (optional).<br /> --disable-utils ---------- This disables compilation of utilities such as downver and checkres (optional).<br /> --enable-release ---------- Enables optimizations, resulting in a faster executable.<br /> <br /> Build MegaZeux as usual:<br /> make -j8<br /> <br /> ===Packaging===<br /> Make sure there is not a &quot;MegaZeux&quot; volume mounted before continuing.<br /> <br /> rm -r build/<br /> make lipo<br /> make archive<br /> A .dmg will appear in build/arch/darwin/. Please refer to the documentation in arch/darwin/ for more details.<br /> <br /> <br /> ==HTML5 (Emscripten)==<br /> NOTE: emsdk may not function properly in MSYS2. Using Linux or similar is strongly recommended.<br /> <br /> Download and install emsdk.<br /> git clone https://github.com/emscripten-core/emsdk /opt/emsdk<br /> cd /opt/emsdk<br /> ./emsdk install latest<br /> ./emsdk activate latest<br /> . ./emsdk_env.sh<br /> <br /> Configure and build MZX:<br /> ./config.sh --platform emscripten --enable-release<br /> make -j8<br /> make archive<br /> <br /> Note that compiling MZX will make emsdk automatically install all required dependencies.<br /> <br /> ==devkitARM, devkitA64, and devkitPPC ==<br /> Follow the instructions [https://devkitpro.org/wiki/Getting_Started here] to install the devkitPro toolchains.<br /> <br /> Note that if you're using MSYS2 (or a Linux distribution with pacman already installed), you can simply add the devkitPro repository to your pacman.conf and install devkitpro-keyring:<br /> <br /> [dkp-libs]<br /> Server = http://downloads.devkitpro.org/packages<br /> <br /> [dkp-windows]<br /> Server = http://downloads.devkitpro.org/packages/windows<br /> <br /> ===Nintendo DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libnds libfat-nds maxmod-nds nds-zlib ndstool dstools<br /> <br /> Configure and build:<br /> arch/nds/CONFIG.NDS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo 3DS===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitARM libctru citro3d picasso 3dstools general-tools<br /> pacman --needed --noconfirm -S 3ds-zlib 3ds-libpng 3ds-libogg 3ds-libvorbisidec<br /> <br /> Configure and build:<br /> arch/3ds/CONFIG.3DS<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC libogc libfat-ogc gamecube-tools<br /> pacman --needed --noconfirm -S ppc-zlib ppc-libpng ppc-libogg ppc-libvorbisidec<br /> <br /> Configure and build:<br /> arch/wii/CONFIG.WII<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Wii U===<br /> NOTE: [https://github.com/AliceLR/megazeux/pull/246/ this port has not yet been merged into mainline MZX.]<br /> <br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitPPC wut wut-tools<br /> pacman --needed --noconfirm -S ppc-libogg ppc-libvorbisidec wiiu-sdl2<br /> <br /> Configure and build:<br /> arch/wiiu/CONFIG.WIIU<br /> make -j8<br /> make archive<br /> <br /> ===Nintendo Switch===<br /> Install the following packages:<br /> pacman --needed --noconfirm -S devkitA64 libnx switch-tools<br /> pacman --needed --noconfirm -S switch-glad switch-glm switch-mesa switch-libdrm_nouveau<br /> pacman --needed --noconfirm -S switch-zlib switch-libpng switch-libogg switch-libvorbis switch-sdl2<br /> <br /> Configure and build:<br /> arch/switch/CONFIG.SWITCH<br /> make -j8<br /> make archive<br /> <br /> ==DJGPP==<br /> NOTE: [https://github.com/AliceLR/megazeux/pull/201/ this port has not yet been merged into mainline MZX.]<br /> <br /> Get a pre-built copy of DJGPP for your operating system from [https://github.com/andrewwutw/build-djgpp here]. Create an environment variable DJGPP pointing to the location you extracted DJGPP and add the toolchain to your PATH variable:<br /> export DJGPP=/opt/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> or<br /> export DJGPP_PREFIX=/c/djgpp<br /> export PATH=&quot;$PATH:$DJGPP/bin&quot;<br /> <br /> Build [https://zlib.net zlib]:<br /> CHOST=i586-pc-msdosdjgpp ./configure --prefix=$DJGPP<br /> make -j8<br /> make install<br /> <br /> Build [http://www.libpng.org/pub/png/libpng.html libpng]:<br /> CFLAGS=&quot;-I$DJGPP/include&quot; \<br /> CPPFLAGS=&quot;-I$DJGPP/include&quot; \<br /> LDFLAGS=&quot;-L$DJGPP/lib -lz&quot; \<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build tremor (lowmem):<br /> git clone https://gitlab.xiph.org/xiph/tremor<br /> git checkout lowmem<br /> ./autogen.sh --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Build [https://xiph.org/downloads/ libogg and libvorbis]:<br /> ./configure --prefix=$DJGPP --host=i586-pc-msdosdjgpp --disable-shared --enable-static<br /> make -j8<br /> make install<br /> <br /> Configure and build MegaZeux (libpng disabled and using tremor by default):<br /> arch/djgpp/CONFIG.DJGPP<br /> make -j8<br /> make archive</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9153 2022-01-03T11:55:13Z

<p>Lachesis: Update Debian packages list.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images, this is roughly how all of the VM images above were generated.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> # &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages (Debian assumed, will be different for other platforms):<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status rofi rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Some Debian i3 packages make xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=List_of_known_worlds_that_fail_validation&diff=9152 2021-12-09T04:50:07Z

<p>Lachesis: Added invalid 1.x bytecode table (only known game is currently Chronos Stasis 1.01).</p> <hr /> <div>Several MegaZeux worlds, from infamous to little-known, fail MegaZeux's validation checks.<br /> <br /> == Major Errors ==<br /> This is for worlds that fail major validation checks -- worlds that completely fail or with one or more boards that are broken beyond repair.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Title !! Error type !! Description<br /> |-<br /> | Pre-2.83 SVN games<br /> | Board<br /> | Several games made with certain SVN versions of MZX contain 2.82X boards but have a 2.83 world magic, leading to errors when loaded in any official release version. See the appropriate section.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1002 Archer Gremory Is Thirsty]<br /> | World<br /> | This game attempts a swap world to an invalid file designed to pass as a locked world.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=887 Brotherhood, The: Legacy of Drake (HUNTDRAK.MZX)]<br /> | Board<br /> | Seven corrupt boards exist in the middle of the file.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=150 Civil War 2040]<br /> | Board<br /> | One board is corrupt or truncated.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1929 DA BOMB!!!!!!] (corrupt version)<br /> | World<br /> | All instances of the byte 0A were replaced with 0D 0A newlines due to FTP misuse, causing the world to fail validation. Version on DMZX is corrected.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=333 Final Fantasy: Dynasty Prelude Project Dump]<br /> | World (WORLD03.MZX), Robot (FFTOWNO.MZX), Board (all worlds failing a CRC check)<br /> | Akwende infamously released this ZIP file in his departure from the community.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1332 Lesbian Space Pirates (9.mzx)]<br /> | Board<br /> | Corrupt board. The global robot is also corrupt, but gets silently caught due to an early program end. This world was made in a hex editor.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1446 Mana Lust] (pre-fix)<br /> | Board<br /> | One of the boards has a subtly incorrect pointer from an unknown cause. The version available on DMZX has this corrected.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1770 MZX Target (pre-recovery)]<br /> | Board, Robot, Program<br /> | World is completely truncated starting at least one program from the end of the fifth or sixth board. A complete version has since been released.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=642 Star Quest (#4214)]<br /> | Board, Robot<br /> | Corrupt robots, several missing robots in a truncated board, the errors go on.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=774 Weirdland 3] (corrupt version)<br /> | World<br /> | Same issue as DA BOMB!!! above -- all 0A bytes were converted to 0D 0A.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1471 z1111000.mzx] (in the Fanye folder)<br /> | Program<br /> | Every single robot in the world has a corrupt program. This world was probably made in a hex editor.<br /> |-<br /> | Shaq Hut 2 (Project Dump)<br /> | Robot<br /> | This world has a corrupt global robot, and as a result nothing in the game works properly.<br /> |}<br /> <br /> === Pre-2.83 SVN games ===<br /> <br /> These files can be fixed by hex editing byte 28 from \x53 to \x52.<br /> <br /> *[https://www.digitalmzx.net/forums/index.php?app=tracker&amp;showissue=227 LPTW Season 2 Intro] (lptws2in.mzx)<br /> *[https://www.digitalmzx.com/show.php?id=1634 Revenge of the Toaster] (easy.mzx)<br /> *[https://www.digitalmzx.com/show.php?id=1809 Gravity by Revvy and Tixus] (tixrev2.mzx)<br /> <br /> The following games have been fixed:<br /> <br /> *[https://www.digitalmzx.com/show.php?id=1666 Bombin' Dude] (v2 was affected)<br /> *[https://www.digitalmzx.com/show.php?id=1665 Pretentia] (affected version is hidden)<br /> <br /> == Minor Errors ==<br /> This is for worlds that have one or two minor board issues, trigger the &quot;expected # robots&quot; error message, or attempt to use corrupt MZMs.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Title !! Description<br /> |-<br /> |-<br /> | HELL STAR<br /> | A board in this game contains one more robot than was specified in the robot data for the board.<br /> |-<br /> | instacrash.mzx<br /> | A world made by mzxrules. The end of the board is corrupt, making it think there are no robots when there really is one. MZX itself can't do anything about this but a utility could be made to recover &quot;missing&quot; programs such as this one.<br /> |}<br /> <br /> ==Invalid Programs==<br /> This is for games with invalid or corrupt Robotic programs. The severity of this varies from game to game but typically the programs in question ran fine to some degree and were never noticed until validation was added.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Title !! Description !! Invalid bytecode !! Fix<br /> |-<br /> | Anything made by mikawo's ZZT to MZX converter<br /> | The global robots produced by this converter are corrupt. This results in the cheats and (in the case of SaintZZT 7th) some options being inaccessible.<br /> *[https://www.digitalmzx.com/show.php?id=1925 Ep+Arp World MZX]<br /> *[https://www.digitalmzx.com/show.php?id=1745 SZZT7_ori.mzx]<br /> |<br /> 04 30 03 00 01 6E<br /> 00 23 00 FF 20 FF<br /> 20 FF 20<br /> FF 20 97 20 91 B2 DD 20 85<br /> B2 87 20<br /> 85 B2 DD 20 83 B2<br /> 8B 20 83 B2 DD 20<br /> 82 B2 8D<br /> 20<br /> |<br /> 04 30 00 26 00 04<br /> 04 5B 00 0E 00 04<br /> 01 00 01<br /> 07 6A 05 21 5E 77 6B 00 07<br /> 01 2C 01<br /> 04 30 00 26 00 04<br /> 04 5B 00 0F 00 04<br /> 01 00 01<br /> 00<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1513 Eternal Eclipse Taoyarin (v1.0 only)]<br /> | Several of the robotic bytecode files packaged with this game have malformed program ends. This causes a large number of errors to display in some MZX versions.<br /> |<br /> AE 00 (the first byte varies)<br /> |<br /> 00<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1386 Loco]<br /> | Loco has a robot with a corrupt program.<br /> |<br /> 04 1D 02 61 00 7E<br /> 04 0C 02 F7 74 1F<br /> 01 52 00 00 00 00 00 00<br /> |<br /> 04 1D 02 61 00 04<br /> 04 6A 02 62 00 04<br /> 19 4F 00 20 01 00 05 00<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=637 Manuel the Manx]<br /> | The control robot on the &quot;House&quot; board of Manuel the Manx is entirely corrupt starting about midway through. It doesn't matter much as this board is inaccessible.<br /> |<br /> 0F 6E 00 04 00 0A 6C 6F 6F 70 63 6F 75 6E 84 84 84<br /> |<br /> 00<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1207 Sidewinder's Engines]<br /> | Two robots have the last 00 byte replaced with FF.<br /> |<br /> FF<br /> |<br /> 00<br /> |}<br /> <br /> Some games have global robots marked &quot;unused&quot;. Some MZX versions would retain a program pointer and length and save garbage bytecode to the world file for these robots. From 2.84c until 2.92c these programs wouldn't be properly ignored, producing some error messages. From 2.92c onward these are silently replaced with a blank program.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Title !! Description !! Invalid bytecode !! Fix<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1424 Slave Pit]<br /> | Global robot.<br /> |<br /> FF<br /> FF FF FF 00 00 00 FF FF FF 88 01 00 ...<br /> |<br /> FF<br /> 00<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1327 Wes]<br /> | Global robot.<br /> |<br /> 42<br /> 00 00<br /> 00 43<br /> 00 00<br /> 00 B0<br /> 9A 95 00 00 9B 95 00 ...<br /> |<br /> FF<br /> 00<br /> |}<br /> <br /> ==Invalid Programs (1.x worlds)==<br /> Due to MegaZeux 1.x being much buggier than 2.x, corrupt programs seem to be more frequent in affected worlds. 1.x program conversion will do the bare minimum required to get these to &quot;work&quot; (usually trailing length byte replacement or program termination). Note the bytecode format here is 1.x bytecode and NOT usual 2.x bytecode.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Title !! Description !! Invalid bytecode !! Interpreted as<br /> |-<br /> | Chronos Stasis 1.01<br /> | FIXME unknown location.<br /> |<br /> 01 4D 00<br /> 00<br /> |<br /> 00<br /> |-<br /> | Chronos Stasis 1.01<br /> | Upper camera (17- Aviary Lab)<br /> |<br /> 02 4D 00 00 01 00 97 02<br /> 02 02 01 02<br /> 04 1D 64 6F 00 04<br /> 00<br /> |<br /> (Affected commands should presumably be 02 02 01 02 and 02 07 97 02.)<br /> 02 4D 00 02<br /> 01 00 01<br /> 02 02 02 02<br /> 00<br /> |-<br /> | Chronos Stasis 1.01<br /> | FIXME unknown location.<br /> |<br /> 04 1D 64 6F 00 FF<br /> 00<br /> |<br /> 04 1D 64 6F 00 04<br /> 00<br /> |-<br /> | Chronos Stasis 1.01<br /> | Red button near voice analyzer (22- Life support, etc).<br /> |<br /> 02 02 4D 00 00 01 00 02<br /> 01 00 01<br /> 00<br /> |<br /> 02 02 4D 02<br /> 00<br /> |-<br /> | Chronos Stasis 1.01<br /> | Door code '0' button (28- Meeting Rooms).<br /> |<br /> 07 1E 61 6C 6C 4D 00 00 01<br /> 00 08 FC 02 02 02 02 02 02 08 F4 02 FF 00 01 00<br /> |<br /> 07 1E 61 6C 6C 4D 00 00 07<br /> 00<br /> |}<br /> <br /> == No message displayed ==<br /> This is for development reference only, as most users will not be able to detect these errors. These are mostly early program ends and 0-length programs that are silently managed internally.<br /> <br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Title !! Error type !! Description<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1056 Aura MZX]<br /> | Program<br /> | Early program end.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1005 Catacombs of Zeux], probably countless other VER1TO2 worlds<br /> | Robot<br /> | Several robots exist with programs of length 0. These are harmless and ignored with no error.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1653 CR2-6]<br /> | Program<br /> | This game contains a line of bytecode with an extra byte, but was otherwise valid. It forced us to rewrite part of program validation! Giel's legacy.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1584 Musings]<br /> | Program<br /> | Early program end.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=79 Oh No! Not Another Star Wars Parody!]<br /> | Program<br /> | Early program end.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=1142 Postality]<br /> | Program<br /> | Early program end.<br /> |-<br /> | [https://www.digitalmzx.com/show.php?id=278 Quest for the Nobles Demo]<br /> | Program<br /> | Early program end.<br /> |}<br /> <br /> <br /> == See also ==<br /> [[Incompatibility|Worlds that are incompatible with the MegaZeux port]]</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9151 2021-08-28T14:50:51Z

<p>Lachesis: Remove qcow2 compression from the packaging instructions.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images, this is roughly how all of the VM images above were generated.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> # &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages (Debian assumed, will be different for other platforms):<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status suckless-tools rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Some Debian i3 packages make xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed tarball containing the image and scripts:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> <br /> # If you have several cores and don't mind using them all, this<br /> # makes xz use parallel compression to speed things up.<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9150 2021-08-28T14:38:55Z

<p>Lachesis: /* Linux/BSD (secondary architectures) */ Update m68k image.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m34s &lt;br&gt; 1m20s &lt;br&gt; 20s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210828.tar.xz 355MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images, this is roughly how all of the VM images above were generated.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> # &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages (Debian assumed, will be different for other platforms):<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status suckless-tools rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Some Debian i3 packages make xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed image for the tarball:<br /> &lt;pre&gt;<br /> qemu-img convert -c -O qcow2 arch.debian10.qcow2 arch.debian10.compressed.qcow2<br /> &lt;/pre&gt;<br /> <br /> Alternatively, instead of using qcow2 compression, just xz it as part of the tarball. This will take longer but the compression is better. This can be sped up with parallel compression using the '''XZ_OPT''' environment variable:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9149 2021-08-28T12:49:19Z

<p>Lachesis: /* Linux/BSD (secondary architectures) */ Update SH-4 image.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m19s &lt;br&gt; 2m30s &lt;br&gt; 22s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210417.tar 577MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m21s (-j4) &lt;br&gt; 26s (-j4) &lt;br&gt; 22s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210828.tar.xz 414MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images, this is roughly how all of the VM images above were generated.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> # &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages (Debian assumed, will be different for other platforms):<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status suckless-tools rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Some Debian i3 packages make xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed image for the tarball:<br /> &lt;pre&gt;<br /> qemu-img convert -c -O qcow2 arch.debian10.qcow2 arch.debian10.compressed.qcow2<br /> &lt;/pre&gt;<br /> <br /> Alternatively, instead of using qcow2 compression, just xz it as part of the tarball. This will take longer but the compression is better. This can be sped up with parallel compression using the '''XZ_OPT''' environment variable:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis https://www.digitalmzx.com/wiki/index.php?title=MegaZeux_Development_VMs&diff=9148 2021-08-28T03:18:38Z

<p>Lachesis: /* Linux/BSD (secondary architectures) */ Fix Alpha image size.</p> <hr /> <div>This page contains VM images for testing MegaZeux (and potentially other software) for non-x86 architectures via [https://www.qemu.org QEMU]. Each image contains a cloned copy of the MegaZeux Git repository, all tools required to build a local copy of MegaZeux, and a minimalist window environment ([https://i3wm.org i3] in Debian or [https://en.wikipedia.org/wiki/CTWM CTWM] in NetBSD) to run MegaZeux in.<br /> <br /> The login for all VMs is '''mzx''' with the password '''mzx''', and the MegaZeux Git repository is typically located at '''/megazeux'''.<br /> <br /> This page is currently a work-in-progress. Because of this, they are behind a password; ask Lachesis for it on Discord.<br /> <br /> == Linux/BSD (main architectures) ==<br /> <br /> These architectures usually correspond to existing or future MegaZeux ports and are fairly well-supported by Linux and/or BSD distributions. The x86_64 and i686 architectures are omitted because there is currently no point in maintaining development VMs for them.<br /> <br /> Build times provided were observed using an i7-7700 running QEMU from a hypervisor guest, and are mainly intended to give a sense of scale. These may vary significantly depending on your machine and setup.<br /> <br /> The current head in &lt;code&gt;/megazeux&lt;/code&gt; should be the most recent head a full build was tested with.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- ARMel --&gt;<br /> <br /> | '''ARMel''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Nintendo DS<br /> * Nintendo 3DS<br /> * Raspberry Pi<br /> * GP2X<br /> | Debian Unstable{{ref|armelsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M versatilepb -m 256M -cpu arm1176<br /> -kernel [...] -dtb [...] -append &quot;root=/dev/sda1 panic=10&quot;<br /> -hda [...]<br /> -no-reboot<br /> &lt;/pre&gt;<br /> | 9m24s &lt;br&gt; 2m44s &lt;br&gt; 27s<br /> | —<br /> | Testing MZX should be done in system emulation, as several vio tests and the test worlds fail with '''chroot.sh''' due to a [https://gitlab.com/qemu-project/qemu/-/issues/263 QEMU bug]. The red and blue video components are reversed.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armel-debian-u20210822.tar.xz 340MB]<br /> | [https://github.com/dhruvvyas90/qemu-rpi-kernel QEMU Raspberry Pi kernels and scripts.]<br /> |-<br /> <br /> &lt;!-- ARMhf --&gt;<br /> <br /> | '''ARMhf''' &lt;br&gt; qemu-system-arm 5.2.0<br /> |<br /> * Android<br /> * Raspberry Pi<br /> * PlayStation Vita<br /> * Pandora<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a15 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m13s (-j4) &lt;br&gt; 53s (-j4) &lt;br&gt; 17s<br /> | —<br /> | No working video. Use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-armhf-debian-10.10.tar.xz 413MB]<br /> | See ARM64.<br /> |-<br /> <br /> &lt;!-- ARM64 --&gt;<br /> <br /> | '''ARM64''' &lt;br&gt; qemu-system-aarch64 5.2.0<br /> |<br /> * Android<br /> * Nintendo Switch<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -m 2048 -cpu cortex-a57 -smp 4<br /> -kernel [...] -initrd [...] -append &quot;root=/dev/vda2&quot;<br /> -drive [...]<br /> -device virtio-blk-device,drive=hd0<br /> -netdev user,id=eth0 -device virtio-net-device,netdev=eth0<br /> -device VGA<br /> -usb -device usb-ehci,id=ehci<br /> -device usb-mouse,bus=ehci.0<br /> -device usb-kbd,bus=ehci.0<br /> &lt;/pre&gt;<br /> | 2m47s (-j4) &lt;br&gt; 59s (-j4) &lt;br&gt; 23s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-arm64-debian-10.10.tar.xz 427MB]<br /> | [https://wiki.debian.org/Arm64Qemu Debian Wiki] [https://web.archive.org/web/20210415230009/https://wiki.debian.org/Arm64Qemu (archived)] &lt;br&gt;<br /> [https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html Blog post with more detailed info.] [https://web.archive.org/web/20161115080530/https://kennedy-han.github.io/2015/06/16/QEMU-debian-ARMv8.html (archived)] &lt;br&gt;<br /> Both of these are outdated; the BIOS image seems to be included out of the box in newer QEMU versions.<br /> |-<br /> <br /> &lt;!-- MIPSeb --&gt;<br /> <br /> | '''MIPSeb''' &lt;br&gt; qemu-system-mips 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -drive [...]<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 33m21s &lt;br&gt; 9m42s &lt;br&gt; 43s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipseb-debian-10.10.tar.xz 424MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPSel --&gt;<br /> <br /> | '''MIPSel''' &lt;br&gt; qemu-system-mipsel 5.2.0<br /> |<br /> * PlayStation Portable<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 45m52s &lt;br&gt; 15m06s &lt;br&gt; 46s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mipsel-debian-10.10.tar.xz 408MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)]<br /> |-<br /> <br /> &lt;!-- MIPS64el --&gt;<br /> <br /> | '''MIPS64el''' &lt;br&gt; qemu-system-mips64el 5.2.0<br /> | —<br /> | Debian 10.10<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M malta -m 256 -cpu 5KEc<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 console=tty0&quot;<br /> -device usb-mouse -device usb-kbd<br /> -vga std<br /> &lt;/pre&gt;<br /> | 35m20s &lt;br&gt; 9m08s &lt;br&gt; 39s<br /> | —<br /> | RAM values above 256M don't work, may be a QEMU 5.2 bug or a kernel bug.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-mips64el-debian-10.10.tar.xz 414MB]<br /> | [https://www.aurel32.net/info/debian_mips_qemu.php Setup] [https://web.archive.org/web/20200817030436/https://www.aurel32.net/info/debian_mips_qemu.php (archived)] &lt;br&gt;<br /> [https://people.debian.org/~aurel32/qemu/mips/ More info] [https://web.archive.org/web/20210404205352/https://people.debian.org/~aurel32/qemu/mips/ (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC --&gt;<br /> <br /> | '''PowerPC''' &lt;br&gt; qemu-system-ppc 6.0.0<br /> |<br /> * Mac OS X<br /> * Nintendo Wii<br /> * Nintendo Wii U<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/powerpc/iso-cd/ Debian Unstable 10.0]{{ref|ppcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 1G<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 4m50s &lt;br&gt; 1m26s &lt;br&gt; 17s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc-debian-u20210823.tar.xz 459MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- PowerPC 64 --&gt;<br /> <br /> | '''PowerPC 64''' &lt;br&gt; qemu-system-ppc64 6.0.0<br /> |<br /> * Mac OS X<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/ppc64/iso-cd/ Debian Unstable 10.0]{{ref|ppc64setup}}{{ref|ppc64partition}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -L pc-bios -boot c<br /> -M mac99,via=pmu -m 2048 -cpu 970fx<br /> -prom-env &quot;boot-device=hd:,\yaboot&quot;<br /> -prom-env &quot;boot-args=conf=hd:,\yaboot.conf&quot;<br /> -drive [...]<br /> -serial stdio<br /> -g 1024x768x32<br /> &lt;/pre&gt;<br /> | 3m36s &lt;br&gt; 59s &lt;br&gt; 14s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-ppc64-debian-u20210823.tar.xz 483MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/PowerPC QEMU Wiki] [https://web.archive.org/web/20210410231026/https://wiki.qemu.org/Documentation/Platforms/PowerPC (archived)]<br /> |-<br /> <br /> &lt;!-- RISC-V RV64GC --&gt;<br /> <br /> | '''RISC-V RV64GC''' &lt;br&gt; qemu-system-riscv64 5.2.0<br /> | —<br /> | Debian Unstable{{ref|riscv64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M virt -smp 4 -m 2048M<br /> -bios opensbi/generic/fw_jump.elf<br /> -kernel u-boot/qemu-riscv64_smode/uboot.elf<br /> -append &quot;console=ttyS0 rw root=/dev/vda1&quot;<br /> -object rng-random,filename=/dev/urandom,id=rng0<br /> -device virtio-rng-device,rng=rng0<br /> -device virtio-blk-device,drive=hd0<br /> -drive file=[...],format=qcow2,id=hd0<br /> -device virtio-net-device,netdev=usernet<br /> -netdev user,id=usernet,hostfwd=tcp::22222-:22<br /> -device VGA \<br /> -usb -device usb-ehci,id=ehci \<br /> -device usb-mouse,bus=ehci.0 -device usb-kbd,bus=ehci.0 \<br /> &lt;/pre&gt;<br /> | 2m04s (-j4) &lt;br&gt; 48s (-j4) &lt;br&gt; 18s<br /> | —<br /> | Serial terminal is required to boot even with a VGA device (Ctrl+Alt+3).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-riscv64-debian-u20210822.tar.xz 481MB]<br /> | [https://wiki.debian.org/RISC-V Debian Wiki RISC-V article] [https://web.archive.org/web/20210818070052/https://wiki.debian.org/RISC-V (archived)]<br /> |}<br /> <br /> == Linux/BSD (secondary architectures) ==<br /> <br /> These architectures do not correspond to any current MegaZeux ports (Alpha, m68k, PA-RISC, SPARC) or are generally more effort to get set up than the rest (SH-4). MegaZeux will probably never run on actual hardware several of these architectures.<br /> <br /> {| class=&quot;wikitable&quot;<br /> ! Architecture<br /> ! Related Ports<br /> ! Distribution<br /> ! Options<br /> ! make &lt;br&gt; unit &lt;br&gt; testworlds<br /> ! Fails<br /> ! Other Issues<br /> ! Image<br /> ! Links<br /> |-<br /> <br /> &lt;!-- DEC Alpha --&gt;<br /> <br /> | '''DEC Alpha''' &lt;br&gt; qemu-system-alpha 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda3 rw&quot;<br /> -drive [...]<br /> -device VGA<br /> &lt;/pre&gt;<br /> | 4m15s &lt;br&gt; 1m09s &lt;br&gt; 14s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. D-Bus and X11 currently do not work correctly due to alignment issues, so use '''run.serial.sh'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-alpha-debian-u20210826.tar.xz 455MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/Alpha QEMU Wiki] [https://web.archive.org/web/20210107214027/https://wiki.qemu.org/Documentation/Platforms/Alpha (archived)]<br /> |-<br /> <br /> &lt;!-- Motorola 68000 --&gt;<br /> <br /> | '''Motorola 68000''' &lt;br&gt; qemu-system-m68k 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/snapshots/2021-04-17/ Debian Unstable 2021-04-17]<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M q800 -m 1000M<br /> -kernel [...] -initrd [...]<br /> -append &quot;root=/dev/sda1 rw console=ttyS0 console=tty&quot;<br /> -drive [...]<br /> -net nic,model=dp83932 -net user<br /> -g 800x600x16<br /> &lt;/pre&gt;<br /> | 4m19s &lt;br&gt; 2m30s &lt;br&gt; 22s<br /> | —<br /> | —<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-m68k-debian-u20210417.tar 577MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/m68k QEMU Wiki] [https://web.archive.org/web/20210110025158/https://wiki.qemu.org/Documentation/Platforms/m68k (archived)]<br /> |-<br /> <br /> &lt;!-- PA-RISC --&gt;<br /> <br /> | '''PA-RISC''' &lt;br&gt; qemu-system-hppa 5.2.0<br /> | —<br /> | [https://cdimage.debian.org/cdimage/ports/10.0/hppa/iso-cd/ Debian Unstable 10.0]{{ref|hppasetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048 -accel tcg,thread=multi -smp 4<br /> -drive [...]<br /> -global artist.width=800<br /> -global artist.height=600<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 34m51s (-j4) &lt;br&gt; 13m02s (-j4) &lt;br&gt; 1m51s<br /> | —<br /> | Use &lt;code&gt;--disable-stack-protector&lt;/code&gt;. Emulation is SLOW! Video doesn't work yet; use '''run.serial.sh''' (see setup notes).<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-hppa-debian-u20210826.tar.xz 432MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/HPPA QEMU Wiki] [https://web.archive.org/web/20201101190558/https://wiki.qemu.org/Documentation/Platforms/HPPA (archived)] &lt;br&gt; [https://parisc.wiki.kernel.org/index.php/Qemu PA-RISC Linux Wiki - QEMU] [https://web.archive.org/web/20210419222007/https://parisc.wiki.kernel.org/index.php/Qemu (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC --&gt;<br /> <br /> | '''SPARC''' &lt;br&gt; qemu-system-sparc 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparcsetup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -M SS-20<br /> -m 512M<br /> -drive [...]<br /> -net nic -net user<br /> &lt;/pre&gt;<br /> | 5m50s &lt;br&gt; 1m26s &lt;br&gt; 25s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors. May hang during IO operations, but so far this has only happened with '''pkgsrc'''.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc-netbsd-9.2.tar.xz 358MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- SPARC64 --&gt;<br /> <br /> | '''SPARC64''' &lt;br&gt; qemu-system-sparc64 6.0.0<br /> | —<br /> | [https://www.netbsd.org/releases/formal-9/NetBSD-9.2.html NetBSD 9.2]{{ref|sparc64setup}}<br /> | &lt;pre class=&quot;mw-collapsible mw-collapsed&quot;&gt;<br /> -m 2048M<br /> -drive [...]<br /> -serial mon:stdio<br /> &lt;/pre&gt;<br /> | 14m50s &lt;br&gt; 3m38s &lt;br&gt; 33s &lt;br&gt; (a173946a)<br /> | —<br /> | Use &lt;code&gt;--prefix /usr/pkg --disable-libsdl2&lt;/code&gt;. SDL2 works headless but can't find a texture format and is missing -Wl,-rpath. &lt;code&gt;force_bpp=16&lt;/code&gt; will match colors to the nearest indexed colors.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sparc64-netbsd-9.2.tar.xz 439MB]<br /> | [https://wiki.qemu.org/Documentation/Platforms/SPARC QEMU Wiki] [https://web.archive.org/web/20210815074550/https://wiki.qemu.org/Documentation/Platforms/SPARC (archived)]<br /> |-<br /> <br /> &lt;!-- Hitachi SH-4 --&gt;<br /> <br /> | '''SuperH SH-4''' &lt;br&gt; qemu-sh4-static 5.2.0<br /> |<br /> * Sega Dreamcast<br /> | Debian Unstable{{ref|sh4setup}}<br /> | n/a<br /> | 1m16s (-j4) &lt;br&gt; 33s (-j4) &lt;br&gt; 21s<br /> | —<br /> | Only works using user emulation right now; use '''chroot.sh'''. Since [https://people.debian.org/~aurel32/qemu/sh4/ this] VM does boot it might be an issue with newer kernels.<br /> | [https://www.digitalmzx.com/lachesis/VMs/vm-mzx-sh4-debian-u20210511.tar 571MB]<br /> | [https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html Building Debian VMs with debootstrap] [https://web.archive.org/web/20210507031949/https://blog.entek.org.uk/technology/2020/06/06/building-debian-vms-with-debootstrap.html (archived)]<br /> |}<br /> <br /> == Setup ==<br /> <br /> If (for whatever reason) you want to set up your own VM images, this is roughly how all of the VM images above were generated.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.debian10.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Extract installation media vmlinux/initrd from ISO (if needed) and set up initial '''install.sh''' script.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access. Do not install a desktop environment.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If needed, extract runtime vmlinux/vmlinuz/initrd from the virtual machine (required for ARM, MIPS, RISC-V, Alpha, m68k, and SH-4). The easiest way to do this is to use the '''guestfish''' utility from '''libguestfs'''.<br /> &lt;pre&gt;<br /> guestfish --ro -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> Then:<br /> &lt;pre&gt;<br /> copy-out /boot/vmlinux-X.XX.X-X-ARCH .<br /> copy-out /boot/initrd.img-X.XX.X-X-ARCH .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''~/.Xresources.''' This is required to make urxvt not look awful.<br /> &lt;pre&gt;<br /> # &quot;lumifoo&quot; by gutterslob.<br /> <br /> ! special<br /> *.foreground: #888a8c<br /> *.background: #1e2021<br /> *.cursorColor: #888a8c<br /> <br /> ! black<br /> *.color0: #515151<br /> *.color8: #707172<br /> <br /> ! red<br /> *.color1: #bf6382<br /> *.color9: #eaaec2<br /> <br /> ! green<br /> *.color2: #65a446<br /> *.color10: #aed49b<br /> <br /> ! yellow<br /> *.color3: #ad8a43<br /> *.color11: #d4c3a0<br /> <br /> ! blue<br /> *.color4: #6b85c2<br /> *.color12: #afc4e9<br /> <br /> ! magenta<br /> *.color5: #9e6bb8<br /> *.color13: #d2b1e2<br /> <br /> ! cyan<br /> *.color6: #5c9d88<br /> *.color14: #a4d0c1<br /> <br /> ! white<br /> *.color7: #919191<br /> *.color15: #d0d0d0<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''/bin/l''' (chmod a+x).<br /> &lt;pre&gt;<br /> #!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la --color=always --group-directories-first &quot;$@&quot;<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Install packages (Debian assumed, will be different for other platforms):<br /> &lt;pre&gt;<br /> sudo apt install git p7zip-full build-essential gdb zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev xorg i3 i3lock i3status suckless-tools rxvt-unicode xdm lynx<br /> &lt;/pre&gt;<br /> Some Debian i3 packages make xterm default instead of urxvt, so fix that:<br /> &lt;pre&gt;<br /> sudo update-alternatives --config x-terminal-emulator<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up MegaZeux repository:<br /> &lt;pre&gt;<br /> sudo mkdir /megazeux<br /> sudo chown mzx:mzx /megazeux<br /> cd /megazeux<br /> git clone https://github.com/AliceLR/megazeux .<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Build MegaZeux:<br /> &lt;pre&gt;<br /> ./config.sh --platform unix-devel --enable-fps [any other flags here. release builds are NOT recommended.]<br /> time make [use -jX with -smp]<br /> time make unittest [use -jX with -smp]<br /> time testworlds/run.sh unix-devel<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.sh''' script and make sure the VM can start up with graphics and run MegaZeux with the software renderer. This may take some trial and error to get right, which is why the QEMU options are provided in the above tables.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If preparing a VM tarball, some steps should be taken to reduce the size of the image.<br /> <br /> From the guest OS, clear the apt package cache:<br /> &lt;pre&gt;<br /> sudo apt clean<br /> &lt;/pre&gt;<br /> <br /> Using '''guestfish''' from the host OS, fill all unused space in the image with 0s. This will increase the size of the image to its maximum size. (This method seems to be faster than using the &lt;code&gt;dd if=/dev/zero&lt;/code&gt; trick some places cite or using &lt;code&gt;zerofree&lt;/code&gt; from a guest rescue disk.)<br /> &lt;pre&gt;<br /> guestfish --rw -a arch.debian10.qcow2 -i<br /> &lt;/pre&gt;<br /> &lt;pre&gt;<br /> zero-free-space /<br /> &lt;/pre&gt;<br /> <br /> To shrink your working copy of the image, compact it using &lt;code&gt;qemu-img&lt;/code&gt; (and then test it):<br /> &lt;pre&gt;<br /> mv arch.debian10.qcow2 arch.debian10.old.qcow2<br /> qemu-img convert -O qcow2 arch.debian10.old.qcow2 arch.debian10.qcow2<br /> &lt;/pre&gt;<br /> <br /> Finally, generate a compressed image for the tarball:<br /> &lt;pre&gt;<br /> qemu-img convert -c -O qcow2 arch.debian10.qcow2 arch.debian10.compressed.qcow2<br /> &lt;/pre&gt;<br /> <br /> Alternatively, instead of using qcow2 compression, just xz it as part of the tarball. This will take longer but the compression is better. This can be sped up with parallel compression using the '''XZ_OPT''' environment variable:<br /> &lt;pre&gt;<br /> mkdir arch/<br /> cp *.sh arch.debian10.qcow2 arch/<br /> XZ_OPT=&quot;-T0&quot; tar -cJf vm-mzx-arch-debian-10.0.tar.xz arch/<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === PowerPC/PPC64 (Debian Unstable) ===<br /> <br /> Setting up working Debian Unstable builds for PowerPC/PPC64 currently requires a little bit of extra work.<br /> <br /> :1. {{note|ppcsetup}}{{note|ppc64setup}} An old image supporting Yaboot is currently required because all Debian Unstable PPC/PPC64 installers based on grub-ieee1275 have major installation issues (as of 2021-05-09). Skip setting up an apt repository, then add this to &lt;code&gt;/etc/apt/sources.list&lt;/code&gt;, &lt;code&gt;sudo apt update&lt;/code&gt;, and &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;:<br /> <br /> deb [trusted=yes] http://ftp.debian.org/debian-ports sid main<br /> <br /> Install the following packages afterward to get the installation roughly equivalent to a standard install.<br /> <br /> sudo apt install wget curl ftp gnupg debian-keyring debian-archive-keyring<br /> <br /> Remove the old kernel and some large dependencies pulled in by '''mailutils''' (not required for these VMs):<br /> <br /> sudo apt remove linux-image-4.16.0-1-*<br /> sudo apt remove mailutils --purge<br /> sudo apt autoremove --purge<br /> <br /> :2. {{note|ppc64partition}} The version of Yaboot in older Debian Unstable PPC64 installers does not support ext4 (even though the equivalent PowerPC installer Yaboot does). Use manual partitioning instead of guided partitioning to create an ext2 &lt;code&gt;/boot&lt;/code&gt; partition:<br /> <br /> #1 Apple<br /> #2 1.0 MB boot<br /> #3 256.0 MB ext2 /boot<br /> #4 (drive size - 2GB - 258MB) ext4 /<br /> #5 2.0 GB swap<br /> <br /> === PA-RISC (Debian Unstable) ===<br /> <br /> :1. {{note|hppasetup}} The Debian Installer in newer installer images crashes prior to partitioning. Like PowerPC, an older image needs to be installed, followed by a dist-update and cleanup. Follow the PowerPC instructions above. Make sure you back up the installed image once you've verified that the installation worked. The upgrade process is slow and will involve trial and error.<br /> <br /> :2. Optional: upgrading systemd may cause the VM to get stuck in an endless boot loop while attempting to run systemd-timesyncd. It may be beneficial to place holds on the relevant systemd packages until after the initial update.<br /> <br /> sudo apt-mark hold libpam-systemd<br /> sudo apt-mark hold libsystemd0<br /> sudo apt-mark hold systemd<br /> sudo apt-mark hold systemd-sysv<br /> sudo apt-mark hold systemd-timesyncd<br /> <br /> :3. If the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt; fails because of '''libgcc-s4''', do the following, then repeat the &lt;code&gt;sudo apt dist-upgrade&lt;/code&gt;.<br /> <br /> sudo apt install -o Dpkg::Options::=&quot;--force-overwrite&quot; libgcc-s4<br /> <br /> :4. TODO: due to either Artist emulation bugs in QEMU or a lack of driver support in Linux, running this VM in graphical mode will result in the graphical terminal freezing at a certain point. The boot process will continue as usual and the VM can be used from the serial terminal in this situation. This Xorg config fragment can at least get X to successfully start, but the Artist window will still be frozen.<br /> <br /> Section &quot;Device&quot;<br /> Identifier &quot;Artist&quot;<br /> Driver &quot;fbdev&quot;<br /> Option &quot;ShadowFB&quot; &quot;off&quot;<br /> EndSection<br /> <br /> Section &quot;Screen&quot;<br /> Identifier &quot;Screen0&quot;<br /> Device &quot;Artist&quot;<br /> DefaultDepth 8<br /> DefaultFbBpp 8<br /> SubSection &quot;Display&quot;<br /> Depth 8<br /> Modes &quot;800x600_60.00&quot;<br /> EndSubSection<br /> EndSection<br /> <br /> === ARMel, RISC-V, and SH-4 (Debian Unstable) ===<br /> <br /> {{note|armelsetup}}{{note|riscv64setup}}{{note|sh4setup}} No Debian Installer image is available for this architecture and it must be set up manually. Overview:<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;Install '''debootstrap''', '''qemu-user-static''', and '''debian-ports-archive-keyring'''. If you aren't using Debian as a host, '''debian-ports-archive-keyring''' is available [http://ftp.us.debian.org/debian/pool/main/d/debian-ports-archive-keyring/ here].&lt;/li&gt;<br /> &lt;li&gt;&lt;pre&gt;qemu-img create -f qcow2 [arch here].debian10.qcow2 16G&lt;/pre&gt;&lt;/li&gt;<br /> &lt;li&gt;As root:<br /> &lt;pre&gt;<br /> modprobe nbd<br /> qemu-nbd -c /dev/nbd0 [arch here].debian10.qcow2<br /> parted -s -a optimal -- /dev/nbd0 mklabel msdos mkpart primary ext4 1MiB -2GiB mkpart primary linux-swap -2GiB -0<br /> mkfs -t ext4 -L root /dev/nbd0p1<br /> mkswap -L swap /dev/nbd0p2<br /> mount /dev/nbd0p1 /mnt<br /> <br /> # For ARMel:<br /> debootstrap --arch armel --keyring=/usr/share/keyrings/debian-archive-keyring.gpg unstable /mnt http://ftp.debian.org/debian<br /> <br /> # For RISC-V:<br /> debootstrap --arch riscv64 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> <br /> # For SH-4:<br /> debootstrap --arch sh4 --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg unstable /mnt http://ftp.ports.debian.org/debian-ports<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Mount and chroot:<br /> &lt;pre&gt;<br /> cp /usr/bin/qemu-[arch here]-static /mnt/bin<br /> mount -o bind,ro /dev /mnt/dev<br /> mount -t proc none /mnt/proc<br /> mount -t sysfs none /mnt/sys<br /> chroot /mnt<br /> uname -a # Verify machine name is armv7l (ARMel), riscv64 (RISC-V), or sh4 (SH-4).<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Edit &lt;code&gt;/etc/fstab&lt;/code&gt;:<br /> &lt;pre&gt;<br /> LABEL=swap none swap sw 0 0<br /> LABEL=root / ext4 defaults 0 1<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/eth0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This is the device name used by Debian and is needed for QEMU system emulation.<br /> allow-hotplug eth0<br /> iface eth0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/enp1s0&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This allows networking to work from a chroot from Fedora.<br /> allow-hotplug enp1s0<br /> iface enp1s0 inet dhcp<br /> &lt;/pre&gt;<br /> Create &lt;code&gt;/etc/network/interfaces.d/lo&lt;/code&gt;:<br /> &lt;pre&gt;<br /> # This configures the loopback interface.<br /> # This breaks booting in ARMel and can be omitted for that platform.<br /> auto lo<br /> iface lo inet loopback<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Install and configure some required packages:<br /> &lt;pre&gt;<br /> apt install debian-ports-archive-keyring<br /> apt install sudo man locales console-setup wget curl ftp gnupg<br /> # These images generally use US/Mountain but the specific timezone isn't that important.<br /> dpkg-reconfigure tzdata<br /> # Only select en_US.UTF-8 here; others can be added later if needed.<br /> dpkg-reconfigure locales<br /> systemctl enable serial-getty@ttyS0.service<br /> &lt;/pre&gt;<br /> '''RISC-V only''': install a kernel (the ~860MB install size is normal).<br /> &lt;pre&gt;<br /> apt install linux-image-riscv64<br /> <br /> # Also, some extra things to do here (see Debian Wiki RISC-V page):<br /> apt install u-boot-menu openntpd ntpdate<br /> sed -i 's/^DAEMON_OPTS=&quot;/DAEMON_OPTS=&quot;-s /' /etc/default/openntpd<br /> echo '<br /> UBOOT_PARAMETERS=&quot;rw noquiet root=/dev/vda&quot;<br /> U_BOOT_FDT_DIR=&quot;noexist&quot;' &gt;&gt; /etc/default/u-boot<br /> u-boot-update<br /> &lt;/pre&gt;<br /> '''SH-4 only''': install a kernel.<br /> &lt;pre&gt;<br /> apt install linux-image-sh7751r<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Setup user:<br /> &lt;pre&gt;<br /> adduser mzx<br /> usermod -a -G sudo mzx<br /> passwd -l root<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''ARMel only''': get a [https://github.com/dhruvvyas90/qemu-rpi-kernel Raspberry Pi Linux kernel (4.19.50) and versatile-pb-buster.dtb here].<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> '''RISC-V only''': get the latest copy of [https://packages.debian.org/opensbi OpenSBI] and [https://packages.debian.org/u-boot-qemu U-Boot for QEMU] from the Debian packages repository. Extract OpenSBI and the U-Boot riscv64_smode kernel; these are required to boot the virtual machine.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Setup (NetBSD) ==<br /> <br /> {{note|sparcsetup}}{{note|sparc64setup}} Setting up NetBSD is a little more involved than Debian. Note NetBSD also isn't aware of power management for some architectures and will use a full core while its VM is running.<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> Set up initial QEMU disk image.<br /> &lt;pre&gt;<br /> qemu-img create -f qcow2 arch.netbsd.qcow2 20G<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> For whatever reason, the QEMU -kernel option doesn't seem to work with any BSD kernels, so right now any QEMU that requires -kernel should use a Linux instead.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Run installer. Leave root password blank, create user '''mzx''' with password '''mzx''' and sudo access (if it doesn't give you the option, set the root password). Install all packages, including the X window system. Enable xdm and nptdate. If network autodetection doesn't work here (SPARC 32-bit), pkgin and pkgsrc will need to be set up manually after reboot. Otherwise, install both.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Set up '''run.serial.sh''' script and run.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set up '''/bin/l''':<br /> &lt;pre&gt;<br /> echo '#!/bin/sh<br /> <br /> LC_COLLATE=&quot;C&quot; \<br /> ls -la &quot;$@&quot;' &gt; /bin/l<br /> chmod a+x /bin/l<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, set a hostname, disable IPv6, enable DHCP (if it isn't already), and reboot:<br /> &lt;pre&gt;<br /> # Set a hostname for this architecture e.g. SPARC, SPARC64, ARMv6.<br /> echo &quot;SPARC&quot; &gt; /etc/myname<br /> <br /> # Disable IPv6 for DHCP.<br /> # This prevents issues where all downloads can hang for a long time before<br /> # the download starts (due to attempting IPv6 first and it timing out).<br /> cp /etc/dhcpcd.conf ~/<br /> echo '<br /> # Disable IPv6 Support.<br /> noipv6rs<br /> noipv6' &gt;&gt; /etc/dhcpcd.conf<br /> <br /> # If it wasn't enabled during install, you can enable DHCP like this.<br /> cp /etc/rc.conf ~/<br /> echo &quot;dhcpcd=yes&quot; &gt;&gt; /etc/rc.conf<br /> <br /> # Reboot for these changes to take effect.<br /> reboot<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgsrc'''. As root:<br /> &lt;pre&gt;<br /> ftp http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz<br /> tar -xzf pkgsrc.tar.gz -O /usr<br /> chown root:wheel -R /usr/pkgsrc<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> If network wasn't available during installation, manually install '''pkgin'''. As root:<br /> &lt;pre&gt;<br /> # Replace ARCH and VERSION for the applicable architecture (e.g. sparc) and version (e.g. 9.2).<br /> pkg_add http://cdn.netbsd.org/pub/pkgsrc/packages/NetBSD/ARCH/VERSION/All/pkgin<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> As root, install packages with '''pkgin''':<br /> &lt;pre&gt;<br /> pkgin install sudo bash gmake git nano p7zip<br /> pkgin install zlib png libogg libvorbis SDL SDL2<br /> pkgin install lynx openssl ca-certificates<br /> &lt;/pre&gt;<br /> If precompiled packages aren't available for this architecture, use '''pkgsrc''' to build and install these packages instead. WARNING: this will take a while.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> When configuring MegaZeux, make sure to use '''/usr/pkg''' as the prefix and to use '''gmake''' to invoke Makefile targets.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Preparing the image is a little different from Debian, mainly since the Linux kernel does not have write support for NetBSD's filesystem by default. As root, clear the pkgin cache and zero free space.<br /> &lt;pre&gt;<br /> pkgin clear<br /> cat /dev/zero &gt;delet_this<br /> sync<br /> rm delet_this<br /> &lt;/pre&gt;<br /> If pkgsrc was used, make sure there are no work directories leftover in the pkgsrc tree (TODO).<br /> <br /> The image is now ready to be shrunk with qemu-img.<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> === Links ===<br /> <br /> :1. [https://www.netbsd.org/docs/network/ NetBSD networking FAQ] [https://web.archive.org/web/20210425154205/https://www.netbsd.org/docs/network/ (archived)].<br /> :2. [https://www.netbsd.org/docs/pkgsrc/getting.html NetBSD pkgsrc guide] [https://web.archive.org/web/20210506032728/https://www.netbsd.org/docs/pkgsrc/getting.html (archived)].</div>

Lachesis