How To Patch and Compile Tutorial (From WINDOWS)

[Looking for Help]

I'm very surprised that nobody has attempted to make a guide on how to do this (besides in the wiki, of course). So I'll try to make this as simple as I can.

To view the wiki VMware, Click Here

The reason I am posting this up is so you may patch up a source code, then compile it. I have not seen a guide on this, so here we go

Go and find yourself some patches that you wish to use. Save them all into a folder that's easy to remember (ie. Desktop).

Download these files, but DONT DO ANYTHING TO THEM YET.
VMware player
7zip
Debian 2.7z (Takes time to download, 184mb)

Part 1: Downloading and Installing
1.1 Go into your C:\ drive and make a new folder named "vmware" (no quotes). This is just for orginization.
1.2 Put all 3 files you just downloaded and place them into the "vmware" folder.
1.3 Double click on the 7zip file. Follow the instructions for installing it, use the default settings.
1.4 Extract the Debian 2.7z files right into the "vmware" folder. This may take some time, it requires more than 2 gigabytes of space!
1.5 Finally, double click on the VMware player. Installation will take 5-10 minutes. Just use default settings again. Make a desktop shortcut, it makes it easier to find.
1.6 Open up the VMware player on the desktop. It should ask you to restart the computer. Please do so, and return to this page after the restart.

PART 2: Patching
2.1 Now that you have restarted your computer, open up the VMware player. The first thing that pops up is a window asking you to find the "virtual machine configuration file". It is located in C:\vmware . It should be the only file that shows up, and click it and hit open.
2.2 It may take a few minutes to load. Once it loads up, a screen should come up with a username and password slot. In the username slot, type in "user" (no quotes). In the password spot, type "rockbox" (no quotes). YOU PROBABLY WILL NOT SEE ANYTHING SHOW UP IN THE PASSWORD BOX, THIS IS GOOD. MAKE SURE YOU TYPE IN THE PASSWORD CORRECTLY.
2.3 Once it loads up, you should see a picture with the rockbox logo on it. Right click on the screen, scroll down to "Xshells", and click on "Eterm".
2.4 A command prompt type box should come up. Type in the following to download the CVS (source code).

Code: [Select]

cvs -z3 -d:pserver:username@www.rockbox.org:/cvsroot/rockbox co rockbox-devel

If that doesn't work above, instead of "username" type in "anonymous" (no quotes). The download will take a few minutes.
2.5 Next, go into your CVS folder by typing in

Code: [Select]

cd rockbox-devel

2.6 Open up a windows explorer (or internet explorer if windows doesn't have an address bar) and type in the following

Code: [Select]

\\debian\user

A username and password window should pop up. For the username, type in "user" (no quotes) and for the password type in "rockbox" (no quotes).
2.7 A folder should show up named "rockbox-devel". Double click it.
2.8 Copy and paste all of your patches into this folder.
2.9a [optional]To test a patch and see if it works, without actually patching it up, type in[/optional]. TELL ME IF THIS WORKS!!

Code: [Select]

patch --dry-run --binary -p0 < patchfilename

Where patchfilename is the name of the file you are patching.
2.9b To patch your file, type in the following.

Code: [Select]

patch --binary -p0 < patchfilename

NOTE!! If you get an error, you probably put in the file name for that patch incorrectly. Make sure you have the patch file name WITH the .patch or .diff on the end. For example:

Code: [Select]

patch --binary -p0 < scroll.patch

ALSO!! If you get an error for every patch, you may need to change the "-p0" to "-p1" or "-p2" and so on. This usually isn't the case, however.
Now that you're done patching, move on to the next section.

PART 3: Compiling
3.1 Make sure you're cd'ed in the "rockbox-devel" folder.
3.2 Type in the following to make a new folder named "build_h120"

Code: [Select]

mkdir build_h120

3.3 Go into that new folder by typing in

Code: [Select]

cd build_h120

3.4 Now type in the following

Code: [Select]

../tools/configure

A bunch of choices should appear. Find the music player that you wish to put this on, and type in the number corresponding to that music player. Example: Type in "15" (no quotes) for the iPod Video. Another bit of text will appear, just type in "n" (no quotes) for normal.
3.5 Now type in

Code: [Select]

make

You will see text flying across the screen. This is exactly what you need to happen.
3.6 Once the text is done, type in

Code: [Select]

make zip

To finish it. The zip file will be named "rockbox" in your debian folder at rockbox-devel/build_h120 .

Unzip the file, and place both of the files into your iPod's root. Congradulations, you just made a custom patched up rockbox!

If you wish to start over from the beginning, either delete the entire rockbox-devel folder and retype the command that downloads the rockbox-devel folder, OR type in

Code: [Select]

cvs -q up -dPC

Thanks to ryran for some of the commands and everyone else who helped me do this for the first time.

I need Feedback to see how this worked for everyone

ALSO I made a patched up rockbox for a 5g with absolute positioning for rockboy. I need people to test it out for me and give me feedback via post or PM. Thank you

[holt.justin173]

i don't know why but i can not get the 7zip to download

[Looking for Help]

Just checked it, it works fine.

Go to http://www.7-zip.org/download.html

Click on the top link with the word ".exe" to the right of it.

[that_asian_guy]

Thanks a lot, I finally got compiling down with your tutorial  . Except I don't think I checked out the source code correctly, because my compile generated a 150 kb build that had no rockbox.ipod, and a .rockbox folder with only a few files in it.

[Looking for Help]

Thanks a lot, I finally got compiling down with your tutorial  . Except I don't think I checked out the source code correctly, because my compile generated a 150 kb build that had no rockbox.ipod, and a .rockbox folder with only a few files in it.

Yeah, the rockbox.ipod file should be 350kb+. Make sure you typed in the correct part for the cvs.

[lx Envy xl]

I FINALLY LEARNED HOW TO PATCH!!! THANKS!!! But a quick question.  I applied the rockboy absolute  wheel positioning and now I cant use the rockboy menu.(?)  Also, I applied the doom scroll wheel and I dont know if its the patch or what but it is still the normal controls.  Also, should the themes be reset or still there.  Cuz mines still there and Im wondering if I unzipped it wrong. 

[that_asian_guy]

for the rockboy question, did you apply all 3 patches on that page, because you need all of them for that one to work.

[Looking for Help]

for the rockboy question, did you apply all 3 patches on that page, because you need all of them for that one to work.

Yes, thats the only way it works. I made one with all of them, and I need people to test them. It is located at the bottom of my original post.

[that_asian_guy]

for the rockboy question, did you apply all 3 patches on that page, because you need all of them for that one to work.

Yes, thats the only way it works. I made one with all of them, and I need people to test them. It is located at the bottom of my original post.

I was replying to envy.

[Looking for Help]

I FINALLY LEARNED HOW TO PATCH!!! THANKS!!! But a quick question.  I applied the rockboy absolute  wheel positioning and now I cant use the rockboy menu.(?)  Also, I applied the doom scroll wheel and I dont know if its the patch or what but it is still the normal controls.  Also, should the themes be reset or still there.  Cuz mines still there and Im wondering if I unzipped it wrong. 

If you copied the .rockbox and rockbox.ipd files into your ipod and pressed overwrite all, the it will overwrite all of the files it needs to replace. This means that if a file is on your ipod and its not in that compiled version of rockbox you made, then it will stay there unmodified. So yes, your themes should still be there.

[XavierGr]

Nice guide there.
More info about the VMware development platform here:
http://www.rockbox.org/twiki/bin/view/Main/VMwareDevelopmentPlatform

It is nice to know that this image is finaly used by newcomers.
As you, in the start I didn't know how to build rockbox, after reading the wiki and setting up a Cygwin enviroment I was disappointed by its speed (cygwin is slow!).

Someone on #rockbox mentioned about setting a VMware enviroment and I liked the idea. As a linux newbie it was a little hard for me to create this image, thanks to all the devs I managed to stick on 184mb, a whole OS with all Rockbox development tools.

I am gratefull to amiconn too, which updated the package with the new archos tool chain and of course Bagder and Mikachu that host the file.

[lx Envy xl]

your rockboy patches work great for the 5G.  Now is there any way to add to an existing patched build or do you have to make a new one every time?

[Looking for Help]

your rockboy patches work great for the 5G.  Now is there any way to add to an existing patched build or do you have to make a new one every time?

Your CVS should be all patched up. You can keep adding to it, and the other patches should still be there. If you want to delete all current patches and start fresh, just delete the entire "rockbox-devel" folder, then redownload it with the "cvs -z3 -d:pserver..." command.

[lx Envy xl]

ok thanx!  NOW I CAN PATCH!!!!

[sunRise]

Hello... thanks for the tutorial...  but i have a litle problem.... i start runing vmware and load the confi file... but when i insert again the comand for download the cvs build i have a error message says...
warnig failed to open /home/user.cvspass for reading no such file or directory.....
whats going on?
Another think is.. when i put anonymous in loging then i take the same error but start to download.. i supose is the cvsbuild.. but i continue read your tutorial... but... in this point:

2.6 Open up an internet explorer and type in the following

Code:
\\debian\user
Windows not found that directory.... i supose when you speak about internet explorer you talk about windows.......
thanks for all...