[s1mp3-dev] new software tool: s1mulator 0.1
Bluechip
csbluechip at gmail.com
Mon Jun 26 08:25:05 CDT 2006
Perhaps some fool-proof step-by-step instructions might be relevant?
To give you an idea of what I mean, at the bottom of this post I have
included a copy of the instructions I wrote to accompany the Rockbox DevKit.
BC
> > Read the instructions!!
> >
> > "To compile, first unpack and build z80em in the z80em/ subdirectory."
> >
> > I sincerely have no idea what is to "build" the z80em.
>
>using make you will build it.
>
> > "Then execute 'make' in the top level."
> >
> > I have no 'make' to execute, and the makefile is not
> > executable/compilable ...
>
>you have make.exe in your gcc distribution
<html><body bgcolor="#000000" text="#FFFFFF"><center><table><tr><td><pre>
.-----------------------------------------------------------------------------.
| ____ _ _ _ __ |
| | ||_||_>| ||_|| _ |
| ,-----------------. | * | |_>|_||| |_/ |
| B L U E C H I P | __ _ ___ __ _ _ |
| `-----------------' | |_ |_||_ | |_ ||||_ |
| presents |_:__| | _| | |__| | _| |
| |
| __________ __ ___. |
| Open \______ \ ____ ____ | | _\_ |__ _______ ___ |
| Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / |
| Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < DevKit |
| Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ |
| \/ \/ \/ \/ \/ v3.13 |
| real firmware written by serious hackers |
| |
`-----------------------------------------------------------------------------'
***************************************************************
INFORMATION UPDATE
***************************************************************
As of today (see version history) there is currently a problem
with the Rockbox build process which will cause this error:
"/home/guest/_____/tools/convbdf: not found"
If you see this error message. It can be fixed very simply by
typing the following from your 'MyBuild' directory:
~/_____/MyBuild> cd ../tools
~/_____/tools> make
You may then tell the build process to continue from where it
left off by typing:
~/_____/tools> cd ../MyBuild
~/_____/MyBuild> make
***************************************************************
1. Run the installer: RockBox-DevKit.exe
o It will create a sub-dir called "Rockbox-Devkit"
under whatever directory you specify
o This directory can be moved/renamed
only AFTER install and BEFORE setup
2. Run /DEVKIT/setup/setup.bat
* Notes to people who have a.n.other cygwin install...
o Old cygwin registry entries WILL be backed up.
o To uninstall the Rockbox DevKit and reset the registry
simply run /DEVKIT/setup/remove.bat
o If you wish to move the DevKit AFTER "setup"
You should (a) 'remove' the DevKit, (b) move/rename
the directory, (c) run 'setup' again.
2a. (Optional) Create Desktop icon
o During setup, a shortcut file to the DevKit is
created as /DEVKIT/RockBox.pif
o This file may be copied or moved to the Desktop,
Start Menu or Launchbar as desired.
---------------------------------------------------------------
If you plan to use CVS for source maintenance,
that's probably all you need to know.
--------------------------------------------------
The rest of this document is designed to assist
the new-comer through their first compile.
---------------------------------------------------------------
3. Download a daily tarball
o You can find these under "Source tarballs" at
http://rockbox.haxx.se/daily.shtml
4. Save the tarball to /DEVKIT/home/guest/
o The tarball will typically be named:
"rockbox-daily-yyyyddmm.tar.gz"
Where yyyymmdd is the year/month/day of the release
o For the purpose of this document, we will simply
call this file "tarball"
5. Run /DEVKIT/_RockBox.bat
o The "_" on the start of the name ensures that this important
file is always at the top of the directory listing :)
6. Unzip the tarball by typing:
~> daily tarball.tar.gz
7a. === Making a Simulator Build ===
~> cd tarball
~/tarball> mkdir MySimBuild
~/tarball> cd MySimBuild
~/tarball/MySimBuild> rbconf
~/tarball/MySimBuild> make
7b. === Making an AJZ Build ===
~> cd tarball
~/tarball> mkdir MyAJZBuild
~/tarball> cd MyAJZBuild
~/tarball/MyAJZBuild> rbconf
~/tarball/MyAJZBuild> make
Notes
-----
o You may call your 'tarball' & 'build' directories anything
that pleases you.
o "rbconf" is an alias for "../tools/configure"
o "daily" is an alias for "tar -xzf"
Additional
----------
# There is a full How-To regarding CVS in the /DEVKIT/ directory.
# If you need to add to the PATH, please edit /DEVKIT/UserPath.bat
# Feedback is useful and appreciated.
cs_bluechip @at@ webtribe .dot. net
Greetz
------
Special thanks goes to (in alphabetical order):
amiconn, Bagder, c0utta, DevZer0, GH, Joerch, LinusN, linuxstb, M.Bright,
midk, Naftali, scott666, Zagor
Version History
---------------
3.20 BC 2006-06-19 SDL update
-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-
SDL Support:
Added: /usr/local/bin/sdl-config
/usr/local/bin/SDL.dll
/usr/local/include/SDL/begin_code.h
/usr/local/include/SDL/close_code.h
/usr/local/include/SDL/SDL.h
/usr/local/include/SDL/SDL_active.h
/usr/local/include/SDL/SDL_audio.h
/usr/local/include/SDL/SDL_byteorder.h
/usr/local/include/SDL/SDL_cdrom.h
/usr/local/include/SDL/SDL_copying.h
/usr/local/include/SDL/SDL_cpuinfo.h
/usr/local/include/SDL/SDL_endian.h
/usr/local/include/SDL/SDL_error.h
/usr/local/include/SDL/SDL_events.h
/usr/local/include/SDL/SDL_getenv.h
/usr/local/include/SDL/SDL_joystick.h
/usr/local/include/SDL/SDL_keyboard.h
/usr/local/include/SDL/SDL_keysym.h
/usr/local/include/SDL/SDL_loadso.h
/usr/local/include/SDL/SDL_main.h
/usr/local/include/SDL/SDL_mouse.h
/usr/local/include/SDL/SDL_mutex.h
/usr/local/include/SDL/SDL_name.h
/usr/local/include/SDL/SDL_opengl.h
/usr/local/include/SDL/SDL_quit.h
/usr/local/include/SDL/SDL_rwops.h
/usr/local/include/SDL/SDL_syswm.h
/usr/local/include/SDL/SDL_thread.h
/usr/local/include/SDL/SDL_timer.h
/usr/local/include/SDL/SDL_types.h
/usr/local/include/SDL/SDL_version.h
/usr/local/include/SDL/SDL_video.h
/usr/local/lib/libSDL.a
/usr/local/lib/libSDL.dll.a
/usr/local/lib/libSDL.la
/usr/local/lib/libSDLmain.a
/usr/local/share/aclocal/sdl.m4
Updated: /etc/profile - added /usr/local/bin to PATH
Other Updates in this version:
Added: /usr/include/ctype.h
/usr/include/limits.h
/usr/include/assert.h
-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-
3.14 BC 2005-11-14 iPod update.
Added: /usr/include/getopt.h
/usr/include/errno.h
/usr/include/unistd.h
/usr/include/sys/errno.h
/usr/include/sys/unistd.h
/opt/arm/*
Updated: /etc/profile
(added /opt/arm to the path)
(added m68k & arm version checks)
/bin/cygwin1.dll -> v1.5.18-1
3.13 BC 2005-08-23 Added: /usr/bin/env.exe
3.12 BC 2005-07-23 Removed: font update request in /usr/bin/cvsget
(no longer required)
Updated: /home/guest/.inputrc
Just tidying
Updated: /bin/sed.exe
updated to version 4.1.2 ...more info at:
www.rockbox.org/twiki/bin/view/Main/BrokenSed
Updated: <this file>
Instructions on building the tools
Added: /lib/w32api/libwinmm.a
Now required by the windows sim
3.11 BC 2005-07-18 Updated toolchain to reflect the requirements of
the latest Rockbox CVS (& daily) source.
Added: /bin/basename.exe
Added: /bin/wc.exe
Added: /bin/head.exe
Updated HowTo_CVS.html
3.10 BC 2005-03-08 Big fat overhaul:
-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-v-
Bug Fixes:
Fixed mingw sybolic links in setup.bat
Updated:
/bin/cygwin1.dll (to version 1.5.12)
/usr/bin/uclpack.exe (support --none)
/home/guest/.inputrc (win32sim exe name changed)
/etc/profile - updated path for new opt/* structure
Added:
/bin/echo.exe (win32sim makefiles)
/bin/cygintl-3.dll (for echo)
/bin/grep.exe (updated build scripts)
/bin/cygpcre.dll (for grep)
/bin/ranlib.exe (updated lib support)
/usr/sh1/bin/sh-elf-ranlib.exe (updated lib support)
/lib/gcc-lib/i686-pc-cygwin/3.3.1/include/limits.h (new string functions)
/lib/gcc-lib/i686-pc-cygwin/3.3.1/include/syslimits.h (new string
functions)
/usr/include/mingw/limits.h (new string functions)
/opt/m68k/* (require for iRiver builds) ^1^
Moved:
/usr/sh1/* -> /opt/sh1/*
^1^ Thanks to LinusN for his invaluable assistance with these files.
I have a copy of the _full_ m68k tool chain if anyone needs it.
Test results with CVS/2005-Mar-08/04:00GMT:
2 - Recorder20, Normal, OK
2 - Recorder20, Win32sim, OK
2 - Recorder20, Debug, fail "region FLASH is full"
2 - Recorder20, Bootloader, LOL
9 - iRiver_h100, Win32sim, OK
9 - iRiver_h100, Normal, OK
9 - iRiver_h100, Debug, fails in 'mpeg.c' ("`TSTR' undeclared")
9 - iRiver_h100, Bootloader, OK
TODO:
'calmrisc' support for GMINI series.
If anybody is able to supply the required GMINI tool-chain (typically
everything you would find in the /opt/calmric16/ directory) please contact me.
-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-^-
3.03 BC 2004-07-17 Updated etc/profile
Updated .inputrc - added .inputrc.help
Added SCROLLIT
Added remmed SCROLLIT command in UserPath.bat
Added licomdlg.a for new Windows UIsims
3.02 BC 2004-06-18 Improved cvs scripts
added inputrc to add better PC keyboard support
Minor updates to documentation
3.01 BC 2004-06-18 Moved SHORTCUT.EXE to /usr/bin/
Extended version number to 5 digits ("v3.01")
Updates to this file
Updates to CVS HowTo
removed oldroot/ - whoops
Added cvsget, cvsup & cvsdif(f) scripts
to /usr/bin
Renamed RockBox.bat to _RockBox.bat
Updated SETUP.BAT for Shortcut
3.0 BC 2004-06-18 First Release
Note to whoever...
When updating please:
# Update the version history table above.
# Update the version number in "version.bat"
# Rename this file to reflect the new version number.
# Make sure you erase any .bak files you create before recompressing.
</b></pre></td></tr></table></center></body></html>
More information about the s1mp3-dev
mailing list