Rockbox - Rockbox mail archive

From: Sean Mealin <seanpm_at_triad.rr.com>
Date: Sun, 14 Oct 2007 14:28:13 -0400

Hi everyone!

Here for your reading pleasure, is the Cygwin tutorial version 1.1. I want
to put it on the wiki, but I need an accessible IRC client.. Does anyone
have any ideas?

Thanks, and enjoy the tutorial.

Sean

Using a Screan Reader to Set up Cygwin, Building Rockbox From Source, and
Making Voice Files

Version 1.1

Sunday October 14th, 2007

Introduction:

This tutorial explains how to install Cygwin, setting up Cygwin to build
rockbox, building Rockbox from source and building a voice file. I used Jaws
for Windows version 8.0, but this tutorial is screen reader independent.

This tutorial is broken up in to segments; sometimes sections will reference
steps completed in previous sections. In order to do this tutorial, your
computer skills must be medium or better; you will need to use your Jaws
curser (or your screen reader's equivalent) a lot. You will also need an
internet connection. This tutorial will use quotation marks (") to indicate
text you should see; less than and greater than symbols (<>) to indicate
buttons you should press, and if they are on their own line, it indicates
text you should enter.

Getting and Installing Cygwin:

1. Get the Cygwin setup file at

http://www.cygwin.com/setup.exe

and save it to your desktop or other easy to find location.

2. Press <enter> on the setup file, and press <enter> on "Run".

3. Press <Alt+N> to move to the next screen.

4. Make sure the "Install from Internet (downloaded files will be kept for
future re-use)" Radio button is selected.

5. Press <Alt+N> to move to the next screen.

6a. Type in the directory where you want Cygwin to be installed; default is
"C:\cygwin" witch I am going to keep.

Note: if you change the path, make sure that there are no spaces. That means
that you can not use "C:\Program Files\..."

6b. Press <tab> twice and decide if you want to install for all the users on
the computer, or if you want to only install for the current user.

6c. Press <tab> and make sure the "Unix / binary (RECOMMENDED)" radio button
is selected for "Default Text File Type".

6. Press <Alt+N> to move to the next screen.

7. Type in where you want your Local Package Directory to be; I set mine to
"C:\cygwin\packages"; that is not the default.

8. Press <Alt+N> to move to the next screen.

9. Tell Cygwin how you connect to the internet; the default is "Direct
Connection" witch I am not changing.

10. Press <Alt+N> to move to the next screen.

11. Wait a few seconds for the installer to download the list of sites; then
press <home> to select "http://cygwin.mirrors.hoobly.com".

12. Press <Alt+N> to move to the next screen.

13a. Once again give the installer time to download a file, and then press
<Alt+Space> to bring up the "System" menu, and press enter on "Maximize".

13b. Activate your Jaws curser (or equivalent).

13c. Make sure the radio button that reads "Curr" is checked.

13b. Press <Up-Arrow> and <Down-Arrow> to navigate to the line that reads
"Archive Default" and left-click on the "D" in "default" once so it reads
"Archive Install".

13e. Go to the line that says "Devel Default" and once again left-click on
the "D" in default so it changes to "Devel Install".

13f. on the line that reads ""Editors Default", click on the "D" in
"Default" to set the installer to install it.

13g. On the line that reads "Interpreters Default", click on the "D" in
"default".

13h. Go to the line that says "Text Default" and install it by clicking on
the "D" in "default".

13i. Press <Alt+N> to move to the next screen.

14. Wait for everything to install; it took me 48 minutes for everything to
complete. At some points it looks as if the installer is frozen; just let it
sit and it will work through everything.

15. Once it has finished, it will put you on the finish screen; <tab> until
you see "Finish" and hit <enter>.

16. Go to your desktop and press <enter> on the "Cygwin" icon.

17. Wait for the initial setup of your user to finish, and you're dun, you
now have a copy of Cygwin installed.

Setting Up Cygwin for Rockbox:

1. Once again press <enter> on the setup.exe file.

2. Press <enter> on "Run".

3. Press <Alt+N> 5 times.

4. Once you get to the download site selection screan, press <Tab> once and
type in

"<http://download.rockbox.org/cygwin/>" in the "User URL" edit box.

Note: do not type the quotation marks.

5. <Tab> and press <enter> on the "Add..." button.

6. Tab back to the selection box and press <End> to select the
"http://download.rockbox.org" option.

7. Press <Alt-N>.

8. Wait a second for a file to download, and activate your Jaws curser (or
equivalent).

9. Go to the line that reads "All Default" and left-click on the "D" in
"Default" to change it to "Install".

10. Press <Alt+N>.

11. Wait for things to download and install; it took me 20 minutes.

12. Tab to the "finish" button and hit <enter>.

13. Go to your desktop and press <enter> on the Cygwin Icon.

Adding the Cross Compiler Directory to Your Path:

We need to make sure that the cross compiler directory is in your path, so
we must go

Check /etc/profile. From with in Cygwin,

1. Type in

Do not type the less and grater than symbols. The "nano" command tells
Cygwin that we want to use the "Nano" edeter (it is like a note pad for
Linux), and the "/etc/profile" is the file we want to edit. You don't need
to change the working directory or anything; you can just type it as soon as
you start Cygwin.

2a. Go down until you see the line

"PATH=/usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin:$PATH".

2b. change it so it reads

"PATH=/usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin:/opt/sh/bin:/opt/m68k/bin:
/opt/arm/bin:$PATH".

3a. Press <ctrl+X> to exit.

3b. Press <y> when it asks if you want to save, and press <Enter> when it
asks about the file name.

4. Restart Cygwin by typing "exit" and pressing <enter> on the icon again.

Compiling Rockbox:

This is the point we have been working for; here you will compile rockbox
from source. Start up Cygwin and:

1. We must first get the source files from svn; type in

Do not type the less or grater than symbols. The "RockboxBuild" is the name
of the new folder that all the source files go in. Press <enter> and wait
for about 4 minutes for everything to download.

2. to see what files and folders there are in your active directory, type in
"ls". You should see "RockboxBuild" or what ever you named the folder in
step 1.

3. To change to that folder, type

where rockbox is what ever you named that folder.

4. Make a new folder where you will compile rockbox and voice files. Use the
command

where FolderName is the name of the folder you want to make. I am going to
make that folder "myBuild". So I would type in

<mkdir myBuild>.

5. Change to that folder with the

command, where myBuild is the name of the folder you just made.

6. Type in

<../tools/configure>

and press <enter> to start the compile Process.

7. Looking at the list that comes on screan, type in the platform number
that you want to make. For example,

<22>

for the Ipod video. Press <enter>.

8. Next it asks for the size of your ram; it may not do this for all
platforms. If you are using an Ipod 30 gigabyte, type in

<32>

if you are using an Ipod 60 or 80 gigabyte, type in

<64>

and press <enter>.

9. type

<n>

for a normal build when it asks you what build would you like to make and
press <enter>.

10. Type in

<make>

and sit back for a few minutes wile rockbox is being compiled.

11. Once it is finished compiling, type in

and wait for another minute.

12. After that, type

to move the new rockbox zip file to your home directory. Where, myBuild is
the directory name you made in step 4. (In Linux, the home directory is like
the desktop in windows).

13. Using Windows explorer, go to "C:\cygwin\home\User" where User is your
user name. You will see the file "rockbox.zip"; it is just like you
downloaded it from the site. Unzip it on your player, and you are dun.

Making Voice Files:

Here is how to make voice files; you will need Lame, so here is how to get
it:

1. Download the source version of Lame at

"http://downloads.sourceforge.net/lame/lame-3.97.tar.gz?modtime=1159107882&b
ig_mirror=0".

2. Save it to your desktop.

3. Using windows explorer, move the file you just downloaded to your home
directory for Cygwin. Mine is "C:\cygwin\home\Sean.M" because Sean.M is my
user name.

4. Start Cygwin.

5. Type

to unzip it.

6. Type

<cd lame-3.97>.

7. Type

<./configure>.

8. Wait until it configures.

9. Ignore the warnings and errors.

10. Type

<make>.

11. Wait a few moments until it finishes.

12. Type

<make install>.

13. Go back to your home directory by typing

<cd>.

14. Go in to your rockbox directory by typing

(see the section " Compiling Rockbox").

15. Go in to the directory where you build rockbox from source;

where, myBuild is your folder name.

16. Type in

<../tools/configure>

and press <enter> to start the compile Process.

17. Using the list that comes up, type in the platform number that you want
to make. For example, "22" for the Ipod video. Press <enter>.

18. Next it asks for the size of your ram; it may not do this for all
platforms. If you are using an Ipod 30 gigabyte, type in

<32>,

if you are using an Ipod 60 or 80 gigabyte, type in

<64>

and press <enter>.

19. type

<a>

for advanced, and press <enter>.

20. Type

<v>

for voice, and press <enter>.

21. Press <enter> when it says "voice build selected".

22. When it asks what language, press <enter> for English, or find the
number of your language and enter it, then press <enter>.

23. When it says "flite: Command not found. espeak: Command not found.
festival: Command not found. TTS engine to use: (S)API5 (S)?" press <enter>.

24. when it says "Enter sapi5 options (enter for defaults ""):" just press
<enter>.

25. When it says "Enter lame options (enter for defaults "--resample 12 -t
-m m -h -V 9 -S -B 64 -

-vbr-new"):" just hit <enter> again.

26. wait for it to create the make file.

27. Type

<make voice>.

28. Wait for it to make the voice.

29. Type

to move it to your home directory. If you did not make an English voice
file, change "English" to what ever language you made.

30. With windows explorer, go to your home directory and grab the file.

31. You're dun! Put it on your player, and enjoy.

End Notes:

Feel free to email me at Sean p m <at> triad <dot> rr <dot> com with any
suggestions, error corrections, and feedback in general.

Thanks to the people on the Rockbox mailing list that helped me out.

Also thanks to the people that worked on
http://www.rockbox.org/twiki/bin/view/Main/VoiceBuildingg

and

http://www.rockbox.org/twiki/bin/view/Main/CygwinDevelopment

Also, thanks to Angie Matney for the maximizing the window trick in step 13a
under the section "Getting and Installing Cygwin".
Received on 2007-10-14

Rockbox mail archive

Cygwin tutorial V 1.1