MIDIbox

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Quick Start Guide Toolchain Setup ======
    for MIOS application development on Windows

Most users just want to download the source, configure the code for their hardware, and compile it. If that’s you, and you’re familiar with Windows, the Quick Start Guide will get you up and running, quick and easy. If you have any problems, or want to know all the gory step-by-step details, you may prefer the [[application_development#setup_install|Detailed Setup Guides]]\\
\\
Go! :)\\
\\

===== Install Tools =====
\\
==== Small Device C Compiler (SDCC) ====
You only need SDCC if you are compiling a C application. For ASM-only applications you can skip this.
  * [[http://downloads.sourceforge.net/sdcc/sdcc-2.8.0-setup.exe?modtime=1206870651&big_mirror=0|Download SDCC 2.80 Installer]]
  * Install using defaults
==== MSYS ====
  * [[http://downloads.sourceforge.net/mingw/MSYS-1.0.11.exe|Download MSYS 1.0.11 Installer]]
  * Install using the defaults.
    * When the install is almost complete, you will see a DOS console window open, and you will be prompted: "Do you wish to continue with the post install? [yn ]". Type 'n' (without the quotes) and hit Enter.


==== GNU PIC Utilities (GPUtils) ====
  * [[http://sourceforge.net/projects/gputils/files/gputils-win32/0.14.3/gputils-0.14.3.exe/download|Download gputils-win32 Installer]]
  * Install the complete application using the 'Full' option.
\\
**You have now finished installing the required tools for building a MIOS application. Now let's go ahead and do that!**
\\
\\

===== Build Application =====
\\
==== One-time Build ====
If you made it this far, you've actually done enough. You can code C or ASM apps in wordpad.exe (or another text editor, //Please note that notepad.exe is not suitable for editing MIOS apps//), and run 'make' to create your app.\\
The following instructions will allow you to quickly build an application one time without making permanent changes to your system. If you just want to build the app once, this is the easiest way.\\
\\
To build your application:
  * Click 'Start... Run'.
  * Type in "cmd" (without the quotes)
  * Click 'OK'.
  * Type the following:\\
\\
 //On the next line, replace //<your application directory>// with the location where you have unzipped the files you downloaded from ucapps.de. For example C:\MIOS\midibox_sid_v2_0_rc18>. Otherwise, it should be //exactly// the same as you see here.// \\
\\
''cd c:\<your application directory>''\\
''SET PATH=C:\MSYS\1.0\bin;%programfiles%\gputils\bin;%programfiles%\SDCC\bin;%PATH% ''\\
''make''\\
\\
Your .hex file(s) will be ready.\\
==== PATH Environment Variables ====
If you build lots of apps, you may not want to have to type that long "SET PATH=BLAH BLAH BLAH", every time you build your app. Fortunately, you can make that setting permanent, so that now you only have to do the following:\\
\\
''cd c:\<your application directory>''\\
''make''\\
\\
If you would like to do this, you can find instructions in the [[http://www.midibox.org/dokuwiki/windows_toolchain_core#path_environment_variables|Detailed Setup Guide]]. Those instructions are far more detailed than these, but don't be scared by all that, if you follow the instructions you should be fine.\\
\\
==== MIOS Studio ====
You should visit [[mios_studio|The MIOS Studio Page]] for instructions on how to install MIOS Studio to upload the app to your midibox.\\
\\
\\

====== Quick Start Guide Complete ======

If you'd like to have a more advanced tool set in your hands, please read on to install and configure an IDE. Currently, there is documentation for:\\
[[windows_toolchain_codeblocks|Code::Blocks]] - An open-source tool for developing C apps (Recommended for AC-Sim users)\\
[[windows_toolchain_notepadplus|NotePad++]] - An open-source tool suitable for either ASM or C apps, or those that mix both.\\
You can find more info at [[application_development#setup_install|Setup & Install]] Section of the Application Development page.\\
You may also like to see the documents for the additional tools:\\
[[windows_toolchain_svn|TortoiseSVN]]\\
[[mios_studio|MIOS Studio]]\\
\\
\\