Subject: Port Dreamcast FAQ Overhaul (*with* patch)
To: None <port-dreamcast-maintainer@netbsd.org, port-dreamcast@netbsd.org,>
From: Jan Schaumann <jschauma@netbsd.org>
List: port-dreamcast
Date: 05/06/2002 09:46:58
--6c2NcOVqGQ03X4Wi
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

D'uh!


--6c2NcOVqGQ03X4Wi
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="dreamcast.faq.diff"

Index: htdocs/Ports/dreamcast/faq.list
===================================================================
RCS file: /cvsroot/htdocs/Ports/dreamcast/faq.list,v
retrieving revision 1.10
diff -u -r1.10 faq.list
--- faq.list	2002/01/19 15:50:19	1.10
+++ faq.list	2002/04/24 08:46:29
@@ -11,58 +11,145 @@
 
 <h1>NetBSD/dreamcast Frequently Asked Questions</h1>
 
+<p>
 It is intended for this to become a repository of frequently asked questions
-(and answers) specific to NetBSD/dreamcast.
+(and answers) specific to NetBSD/dreamcast.  It is currently very much
+incomplete with glaring omissions and oddities, take the inclusion of a
+question regarding building on Windows contrasted with the lack of an
+equivalent question about building on NetBSD.  This is due to the chronological
+trawling of the mailing list archives searching for suitable questions.  Be
+assured that there is work progressing to further enhance and round this
+document.  If your question remains unanswered then please consider submitting
+it to the NetBSD/dreamcast mailing list.
+</p>
 
 <LIST>
+
+<ENTRY>port_origins Where did the Dreamcast port come from?
+It was spun off from the NetBSD/evbsh3 port by Marcus Comstedt after Saitoh
+Masanobu managed to boot the evbsh3 code on a Dreamcast console.
+
+<ENTRY>cd-r_bootable Can all Dreamcast consoles boot from CD-R?
+The "Sakura Wars Limited Edition" is known to be incapable of booting from CD-R.
+  There may be others also.
+
+<ENTRY>cd-rw_bootable Can any Dreamcast consoles boot from CD-RW?
+There have been unsubstantiated rumours that a, very small, subset of Dreamcast
+consoles are capable of booting from CD-RW without modification.  Many others
+are capable of this with internal modification to the console.
+
+<ENTRY>what_is_bba What is the Broadband Adapter?
+Often abbreviated to simply `BBA', the Broadband Adapter is 10/100Mbit Ethernet
+module that replaces the console's modem.  It is driven by a Realtek 8139 chip
+that runs from a PCI bus in the Broadband Adapter.  The PCI bus is then
+translated into the console's native Maple Bus.
+
+<ENTRY>where_is_bba Where can I get a Broadband Adapter?
+eBay is a likely place and sometimes
+<a href="http://www.lik-sang.com/">Lik-Sang</a> have some.  They are generally
+very difficult to find now that Sega has ended Dreamcast production.  As such,
+highly inflated prices are often seen, with many Broadband Adapters selling for
+greater than the cost of the console they are to be employed in.
+
+<ENTRY>what_is_la What is the LAN Adapter?
+The LAN Adapter (HIT-0300) is essentially a Broadband Adapter with support for
+10Mbit rather than 10/100Mbit Ethernet.  It uses the MB86967 chip instead of the
+ Broadband Adapter's Realtek 8139.
+
+<ENTRY>where_is_la Where can I get a LAN Adapter?
+Some people have found the LAN Adapter more available than the actual Broadband
+Adapter but definitive sources of purchase are unavailable.  It was produced
+exclusively for the Japanese market but has been known to be exported
+unofficially to other countries by third-parties.
+
+<ENTRY>where_images Where can I find a bootable NetBSD/dreamcast CD image?
+There are some old but useful DiskJuggler images at
+<a href="http://www.roadsign.com/dc/">http://www.roadsign.com/dc/</a>.
+
+<ENTRY>where_dj Where can I find DiskJuggler?
+DiskJuggler is freely available (albeit in a crippled form, but still functional
+enough to burn the aforementioned images) from
+<a href="http://www.padus.com/free.htm">http://www.padus.com/free.htm</a>.
+
+<ENTRY>how_bootable_image How do I make a bootable NetBSD/dreamcast CD image?
+That is entirely dependent on your choice of CD burning software.  Marcus
+Comstedt has information on using cdrecord at
+<a href="http://mc.pp.se/dc/cdr.html">http://mc.pp.se/dc/cdr.html</a> while
+information for using Ahead's Nero can be found at
+<a href="http://nero.julesdcdev.com/">http://nero.julesdcdev.com/</a>.
+
+<ENTRY>how_compile_win How do I compile NetBSD/dreamcast under Windows?
+To build NetBSD/dreamcast under Windows will take a functional Cygwin
+installation, a working sh4 cross-compiler, the NetBSD code and a great deal of
+patience.  More detail will hopefully be made available in the not too distant
+future.
+
+<ENTRY>how_send_files How do I send files to the Dreamcast?
+The simplest solution for those running NetBSD or similar is to use the portal
+filesystem as follows:
+
+<p>
+<tt># mkdir /p</tt><br>
+<tt># mount_portal /usr/share/examples/mount_portal/tcp.1.conf /p</tt>
+</p>
+
+Now that the portal filesystem is mounted <tt>cat</tt> can be employed to send a
+file to the console:
+
+<p>
+<tt># cat <i>filename</i> &gt; /p/tcp/<i>dreamcast</i>/<i>port</i></tt><br>
+</p>
+
+Where `<i>filename</i>' is the file to send, `<i>dreamcast</i>' is the IP
+address of the console and `<i>port</i>' is the port number to send the file to.
+An example of sending a kernel called `<tt>bsd</tt>' to a Dreamcast with an IP
+address of <tt>192.168.0.128</tt> which is running the IP upload slave (which
+listens on port <tt>4711</tt>) would be:
+
+<p>
+<tt># cat bsd &gt; /p/tcp/192.168.0.128/4711</tt>
+</p>
+
+<ENTRY>what_ip_slave What is the IP upload slave?
+The IP upload slave is a Dreamcast program written by Marcus Comstedt that
+allows the transport of files through the Dreamcast console's Broadband Adapter,
+which will then be executed by the console.  It can be found at
+<a href="http://mc.pp.se/dc/ipslave.html">http://mc.pp.se/dc/ipslave.html</a>.
+
+<ENTRY>how_set_ip How do I set the IP address of the Dreamcast?
+Certain Dreamcast games can set the IP address, which is then stored by the
+console until altered.  Similarly the Broadband Passport browser software has
+this capability.  However, the Dreamcast can be told its IP address once NetBSD
+has been booted and doesn't need the information prior to this, as such, the
+simplest solution is to edit the arp table from your NetBSD system like so:
+
+<p>
+<tt># arp -s <i>dreamcast</i> <i>ethernet</i></tt>
+</p>
+
+Where `<i>dreamcast</i>' is the desired IP address, say <tt>192.168.0.128</tt>,
+and `<i>ethernet</i>' is the hardware address of the Broadband Adapter, say
+<tt>00:00:de:ad:be:ef</tt> the command would be:
+
+<p>
+<tt># arp -s 192.168.0.128 00:00:de:ad:be:ef</tt>
+</p>
+
+The hardware address of the Broadband Adapter can be found written on the device
+itself or transcribed from the IP upload slave program.
+
+<ENTRY>where_browser Can I get a GD-ROM of the Dreamcast Browser to set the IP address?
+Sega no longer appear to supply this GD-ROM so it could prove challenging.
+
+<ENTRY>endian Is the Hitachi SuperH SH-4 little or big endian?
+Little-endian.
 
-<ENTRY>file-through-bba How do I send a file through my Broadband Adapter
-Sending a file from a computer running NetBSD to your SEGA Dreamcast
-through your SEGA Broadband Adapter isn't complicated.  First, you
-should type: 
-<p>
-<tt># mkdir /p<br>
-# mount_portal /usr/share/examples/mount_portal/tcp.1.conf /p</tt>
-<p>
-After that, to send a file you would type:
-<p>
-<tt># cat <i>filename</i> &gt; /p/tcp/<i>dreamcast</i>/4711</tt>
-<p>
-where '<i>filename</i>' is the name of the file you wish to send, and 
-'<i>dreamcast</i>' is the hostname or IP address of your SEGA Dreamcast.
-The "4711" means TCP port 4711 on the Dreamcast.
-<p>
-
-<ENTRY>juggler How do I make a working boot CD with DiskJuggler?
-<ul>
-<li>Get a DiskJuggler bootable image (e.g. the one from 
-<a href="http://www.roadsign.com/dc/netbsd.zip">http://www.roadsign.com/dc/netbsd.zip</a> which contains a .cdi file). 
-<li>Install a known-to-work version of DiskJuggler (such as V3.50.800-DTU).
-<li>Click 'File' and then 'New' to start a new task. Select 'CD Image to CD 
-Recorder'.
-<li>Click the icon under the word Source in the upper left of the window. 
-Use the browser to find the .cdi file.
-<li>Insert a blank CD into the recorder and click Start.
-</ul>
-
-<ENTRY>snapshots Where do I find snapshots
-You find NetBSD/dreamcast snapshots at
-<URL>ftp://ftp.netbsd.org/pub/NetBSD/arch/dreamcast/snapshot/ . 
-As the Dreamcast port is binary compatible to other SH-based
-ports, you can also use snapshots from e.g. the hpcsh port, located
-at <URL>ftp://ftp.netbsd.org/pub/NetBSD/arch/hpcsh/snapshot/ .
-<p>
-
-<ENTRY>links Some links
-<ul>
-<li> <a href="http://mc.pp.se/dc/">Marcus Comsted's DC page</a>
-<li> <a href="http://www.roadsign.com/dc/">Some old kernels and ISOs</a>
-<li> <a href="ftp://ftp.netbsd.org/pub/NetBSD/arch/dreamcast/">Official NetBSD snapshots</a>
-<li> <a href="http://www.padus.com/free.htm">DiskJuggler</a>
-<li> <a href="http://nero.julesdcdev.com/">Guide To Make Dreamcast Selfbootable CD With Nero Burning Rom</a>
-<li> <a href="http://mc.pp.se/dc/cdr.html">How to
-     make a bootable CD with cdrecord & mkisofs</a>
-</ul>
+<ENTRY>where_snapshots Where do I find NetBSD/dreamcast snapshots?
+You can find NetBSD/dreamcast snapshots at
+<a href="ftp://ftp.netbsd.org/pub/NetBSD/arch/dreamcast/snapshot/">ftp://ftp.netbsd.org/pub/NetBSD/arch/dreamcast/snapshot/</a>.<br>
+As the Dreamcast port is binary compatible to other sh-based ports, you can also
+use snapshots from these projects, such as the NetBSD/hpcsh port, located at
+<a href="ftp://ftp.netbsd.org/pub/NetBSD/arch/hpcsh/snapshot/">ftp://ftp.netbsd.org/pub/NetBSD/arch/hpcsh/snapshot/</a>.
 
 </LIST>
 

--6c2NcOVqGQ03X4Wi--