DC-TOOL-IP Linux Tutorial

[lerabot]

This is a tutorial to get DC-TOOL-IP running on linux.
My setup has the dreamcast is connected directly to my computer, no router in between.

1 - Get DC-LOAD-IP 1.0.4 from this source - https://drive.google.com/open?id=1tT_zD ... 9y0nM5mnLd
This is selfboot .cdi image. I've burned it with ImgBurn without any problem.

2 - Boot DC-LOAD-IP in your dreamcast, with your BBA connected in order to get your BBA mac adress. The third line is your MAC adress. It should look something like 00:04:5d:2a:0f. Note that down we'll need it later.

3 - We'll use the arp fonction to get your computer to "give" an IP adress to your Dreamcast based on it's mac adress. In a terminal, enter:

Code: Select all

sudo arp -s [local IP adress] [MAC adress]

[local IP adress] = a valid IP adress that you want to assign to your dreamcast
[MAC adress] = you dreamcast's MAC adress, look at step 2.

the local IP adress should be in the same range as your network. in my setup, my ethernet port is set on port 192.168.5.100. the [local IP adress] is 192.168.5.99. if you don't know your network range, you can use ifconfig in a terminal to find out. I wont cover this here.

4 - At this point, you should be able to see if your dreamcast is connected, a simple ping command should do the job. Make sure you dreamcast is powered on.

Code: Select all

ping [local IP adress] <- replace this be the adress you assigned in step 3.

you should get a message like : 64 byte from [local IP adress] .... blabla ... time=xx ms

5 - Let's upload a file using DC-TOOL-IP now! I had trouble compiling 1.0.4, so I'm currently using a pre-compiled DC-TOOL-IP 1.0.3 which seems to work fine. I got it from this source (http://napalm-x.thegypsy.com/adk/dc/dcl ... index.html)

You can now use that tool to send your file to the DC. Make sure you dreamcast is running the DC-LOAD-IP DC we've used earlier. I've renamed the program to dc-tool-ip for simpler access.

Code: Select all

dc-tool-ip -t [local IP adress] -x /path/to/your/.bin/of/.elf/file

You can always run dc-tool-ip without any command to get some info on how to run it.

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

EXTRA STUFF:

*So, you need to know that the arp command used on step 3 will need to be entered everytime you relog/shut down the dreamcast. I've added it to my environ.sh script, but I'm sure there's other way for it to be more "automated"

*You can add a line to your host file in order to replace [local IP adress] to a more friendly name. I've done it using :

Code: Select all

sudo nano /etc/hosts

then adding the line :

Code: Select all

dreamcast [local IP adress]

you can now use the name dreamcast (or whatever you named it in front of the [local IP adress]) instead of the adress.

[lerabot]

Wow, this look pretty messy on the forum but I'm sure there's a way to make this look ok on the wiki.
Feel free to edit the download sources if there's more reliable one. If someone has a precompiled DC-TOOL-IP 1.0.4, I'll gladly take it.

As for the arp command, if you have a better idea on how to make it permanent, I'm also looking for that.

[nymus]

I've never understood why the Dreamcast community decided to use cdi images. They've been consistently unwieldy for me over the years, not to mention the fact that only a handful of Windows-based software seems to burn them correctly.

Since you are writing a Unix/Linux guide, may I suggest you provide an iso image instead?

[Quzar]

As for the arp command, if you have a better idea on how to make it permanent, I'm also looking for that.

I added it in where I source my dc environ script. Using bash, I do this via the .profile file:

Code: Select all

source /root/DCDev/KallistiOS/environ.sh
export IP_ADDR="192.168.1.99"
export DCTOOL_IP="/usr/local/dc/bin/dc-tool"
arp -s 192.168.1.99 00:d0:f1:02:a5:a6

I then use 'IP_ADDR' as an environ variable in my makefiles.

[bogglez]

Thank you for the tutorial. I'll leave this open for feedback for a while and eventually add it to the wiki. Please remind me in the future if I forget.

[lerabot]

Thanks everyone. I'll work on this a bit, namely adding a selfbooting .iso file

[|darc|]

I've never understood why the Dreamcast community decided to use cdi images. They've been consistently unwieldy for me over the years, not to mention the fact that only a handful of Windows-based software seems to burn them correctly.

Since you are writing a Unix/Linux guide, may I suggest you provide an iso image instead?

An ISO image is just an image of a single data track. The Dreamcast's disc format is a multisession disc. I don't know of any standard image type that can handle multisession images, just proprietary image formats like DiscJuggler, Nero, Alcohol120%, CloneCD, etc. Even the standard CUE format is an image of a single session; you can't do multisession with it. Some programs have added proprietary extensions to CUE to add multisession support, but it's not a standard at all.

I really can't think of any reason why someone would want to image a multisession CD outside of the Dreamcast, so that's hurt any chances of a standard being made.

You can burn CDI files on Linux by using cdirip to split the CDI file into individual audio/data tracks and then burn those tracks in two sessions manually with multiple cdrecord commands.

[lerabot]

I'm not a Dreamcast guru, but I usually prefer CDI files, even if it mean booting on windows to burn them. They're usually hassle-free and just work well.

[lerabot]

I just edited the link to the DC-IP-LOAD and hosted in on my google drive.

[Protofall]

Note that there is a newer version of DC-LOAD/TOOL-IP in Sizious' fork (1.0.5) https://github.com/sizious/dcload-ip

Also if you wish to use the "-c" option (Access files on your computer from the Dreamcast to load in/out assets), you need to use "sudo" to give the program permission, also make sure to have the exact path to the executable, sudo won't work if it is in a environment path. If you have it in an environment path run "sudo $(which dc-tool-ip) ETC" and this should work fine.