MIDIbox

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Developing MIOS Applications with Code::Blocks ======

**Note** 
Updated 18/01/07 Please check to be sure you are doing this right, c::b chamged a lot since the first version of this doc - //stryd_one//
\\
\\

The technical jargon:
This is a walkthrough on the process of developing [[MIOS]] Applications primarily in C [[how_to_mix_c_and_asm|but also in ASM]] utilising the [[http://www.ucapps.de/mios_c.html|MIOS C Wrapper]]. The platform used will be [[http://www.codeblocks.org|Code::Blocks IDE]] on[[http://microsoft.com/windowsxp|Microsoft Windows XP]], and the applications will be built for both [[mios_c_simulator_-_debugger|AC-Sim (AudioCommander's C Simulator)]] compiled with [[http://gcc.gnu.org|GCC]] for [[http://www.mingw.org|MinGW]], and for the [[home#mbhpmidibox_hardware_platform|MIDIBox Hardware Platform (MBHP)]] compiled for [[http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=2042&param=en020453&pageId=74|PIC18F]] with [[http://sourceforge.net/projects/sdcc|SDCC]], assembled with [[http://sourceforge.net/projects/gputils|GPUtils]], using [[http://www.activestate.com|ActiveState]] [[http://www.activestate.com/Products/ActivePerl/?mp=1|ActivePerl]] to generate, and parse files for, the DOS-Console-based make batch file scripts, and [[http://miosstudio.midibox.org|MIOS Studio]] will be used for debugging on MBHP.

Please don't be put off by all that mumbo jumbo. If you're totally newbie then this document is also for you :) I've included everything you need to do, step-by-step, for everything except for actually coding the app. I hope this will not only make it easier for newbies to get started, but for ASM coders like myself to transfer their skills into C development (which seems to be the future of MIOS) or as a reference point for the experienced. In order to do this, I've included as much information as possible, but I have created links to jump through the document for those who don't need all that detail.

I hope you find this document helpful and that you will feel free to make suggestions or criticism or corrections or any kind of modifications as you see fit :)

\\
\\

====== Install and Configure Applications ======

===== Sun Java J2SE =====

Chances are you already have this... I don't recommend upgrading the existing version if you do.
  * [[http://www.java.com/getjava/|Download J2SE]]
  * Install with defaults or whatever meets your requirements. I recommend disabling automatic updates.

===== 7zip =====

This tool is needed to extract compressed files. If you already have winzip or winrar then you won't need this. I recommend the latest version MSI installer for ease of use.
  * [[http://www.7-zip.org/|Download 7zip]]
  * Install the complete application using the defaults

===== GNU PIC Utilities (GPUtils) =====

  * [[https://sourceforge.net/project/showfiles.php?group_id=41924|Download gputils-win32]]
  * Install the complete application using the 'Complete' option.
  * When the installer asks you, click 'Yes' to add the installation directory to the PATH environment variable.

===== ActiveState ActivePerl =====

  * [[http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl|Download ActivePerl]]
  * Install using defaults
  * If you are prompted to restart your computer, then do so (yes, now... I know it's annoying!).

===== Small Device C Compiler (SDCC) =====

  * [[http://sourceforge.net/project/showfiles.php?group_id=599|Download SDCC.]] 2.50 is officially supported or you can [[http://sdcc.sourceforge.net/snap.php#Windows|get the latest snapshot]] if you're more experienced. Some PIC compiler routines have been improved in 2.6.0+ so this may be beneficial.
  * Install using defaults (Note that this installs the PDF doc as well which can be very useful)

==== Environment Variables ====

Normally, the necessary directories are added to you PATH environment variable during the above installations. Sometimes, they aren't. Here's how to check it:

  * Minimise any open windows so that you can see the desktop. 
  * Right-click on 'My Computer', select 'Properties'.
  * Click on the 'Advanced' tab, then click 'Environment Variables'
  * Under either User or System variables, select the variable 'PATH' and click 'Edit'
  * Add these entries if they don't exist (Entries should be separated by semicolons):
    * ;C:\Program Files\ActiveState\PERL\bin\
    * ;C:\Program Files\SDCC\bin
    * ;C:\Program Files\gputils\bin

====== Code::Blocks IDE ======

===== Install =====

Full Installer package is //no longer recommended // unless you're an expert. We now need to manually install and configure [[http://www.gnu.org/software/gdb/|GDB (GNU DeBugger)]] and [[http://www.mingw.org|MinGW]], which contains [[http://gcc.gnu.org|GCC]] - the GNU C Compiler. GDB is used to debug your application in the simulator, which is compiled with GCC.

<trivia> GCC actually stands for GNU Compiler Collection. It supports heaps of other stuff so the name changed.</trivia>


===== MinGW =====
MinGW contains GCC which is used to compile the simulator 

  * [[http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=82721&release_id=158801|Download the installer]]. Version 5.1.3 has tested OK.
  * Install, taking the 'Download and Install' option, and select the 'Candidate' package (use 'Current' if you have problems) and the 'Minimal' install type. It may be best to accept the default install path as MinGW doesn't like paths with spaces.
  * If the installer crashes while downloading just keep repeating the above until it completes.

===== GDB (GNU DeBugger) =====
GDB is used to debug apps and is a must-have for MIOS development.

  * [[http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=82724&release_id=190586|Download the installer]] 
  * Install, taking the same default install path as MinGW (above).


===== Code::Blocks =====
For our purposes, CodeBlocks latest nightly build version should be installed. 

  * Download a [[http://download.berlios.de/codeblocks/wxmsw26u_gcc_cb_wx2.6.3p2.7z|newer wxwidgets dll]] and extract to the CodeBlocks Program Directory, for example C:\Program Files\CodeBlocks\
  * Get link for Nightly Build from the [[http://forums.codeblocks.org/index.php?board=20.0|CB Forum]]
  * Delete share\ dir, for example C:\Program Files\CodeBlocks\share\*.*
  * Unzip downloaded file to Program Directory, for example C:\Program Files\CodeBlocks\, and overwrite where prompted.
  * Start Code:Blocks, it will detect and configure installed compilers. Accept defaults.

===== Configure =====
In order to use the [[http://www.gnu.org/software/gdb/|GDB (GNU DeBugger)]] debugging features of Code::Blocks with [[mios_c_simulator_-_debugger|AC-Sim (AudioCommander's C Simulator)]] you need to configure [[http://gcc.gnu.org|GCC]] to produce debugging symbols when compiling as follows:

  * Select the menu 'Settings... Compiler and Debugger...'
  * Select 'Global Compiler Settings' in the pane on the left
  * In the box labelled 'Selected compiler', select 'GNU GCC Compiler'
  * Select the tab labelled 'Compiler' and then the tab labelled 'Compiler Flags'
  * From the dropdown box labelled 'Categories:', select <All categories>
  * Tick the box labelled 'Produce debugging symbols  [-g]'

This should be all that is needed to have all the applications ready to go.





===== Project Setup =====

Full instructions are below, but you may jump to the required section based on your requirements:

==== Project Setup - New Application ====

If you are creating a new application, you can simply [[http://haskey.com/johnh/midibox/SDCC+AC-Sim+CBP_Skeleton_v1.9.zip|download the MIOS SDCC Skeleton Application Template]], extract it to your template directory, and start with that, and none of the below steps are necessary. This zip file does not change any of the functionality of the normal SDCC Skeleton App, so you can use it as normal, as well as with C::B. Here is a walkthrough:

  * [[http://haskey.com/johnh/midibox/SDCC+AC-Sim+CBP_Skeleton_v1.9.zip|Download the MIOS SDCC Skeleton Application Template]]
  * Extract the contents of the zip to your user template directory. It will be C:\Documents and Settings\<your username>\Application Data\codeblocks\UserTemplates
  * In Code::Blocks, Select 'File... New Project'
  * Select the tab labelled 'User Templates', and double-click the project named 'MB-ACSim'
  * Writing your code is up to you but once you're done, jump to the section on Compiling and Debugging for either [[#ac-sim_simulator|AC-SIM]] or [[#MBHP|MBHP]]

==== Project Setup - Existing Application ====

I plan to write a small application which will automatically convert a MIOS application (as downloaded from [[http://www.ucapps.de|UcApps]]) into a Code::Blocks Project complete with AC-Sim sources for pre-MBHP debugging. In the meantime, the C::B Project can be setup from either an existing MIOS C Application or the SDCC_Skeleton App as follows. You should have your application/skeleton in a dedicated folder.

==== Create Empty Project ====
  * Start Code::Blocks
  * Open a new project ('File... New Project')
  * Tick the checkbox 'Show File-based Templates'
  * Click 'SDCC Application' from the list. You may need to scroll down to see it. If it is not there, ensure you have performed the previous step
  * In the box labelled 'Project Path and Name', browse to the directory containing your MIOS Application or Skeleton, and add the name of your Project
  * In the box labelled 'Options', tick the box labelled 'Do not create any files'
  * Click 'OK'
  * Click 'Yes' on dialog(s) stating that the directory already exists

==== Add Application files to project ====

  * Select 'Project... Add Files', Select All of the files in your Project directory, Click 'Add'


==== Configure Build Targets ====

=== AC-SIM Build Target ===
//Skip this section if you do not need to use the simulator//

  * Select 'Project... Properties', Select the 'Targets' tab, Click 'Add'
  * Name the target 'MB-ACSim', and Click OK
  * In the box labelled 'Selected build target options', select 'Console Application' from the drop-down list labelled 'Type'
  * In the box labelled 'Selected build target files', Tick ONLY 'debug.c'

=== MBHP Build Target ===
//Perform the following sections to build the application for MBHP//

  * Returning to 'Project... Properties', 'Targets' tab, Click 'Add'
  * Name the target 'MBHP', and Click OK
  * In the box labelled 'Selected build target options', select 'Commands Only' from the drop-down list labelled 'Type'
  * In the box labelled 'Selected build target files', Tick ONLY 'main.c'
  * Click 'OK' to close project properties

  * Select 'Project... Properties', Select the 'Targets' tab (Yes, again. It is necessary to apply the previous settings first)
  * select target 'Default', click 'Delete', Click 'Yes' to confirm deletion
  * select target 'MBHP', click 'Build Options'
  * In the box labelled 'Selected Compiler' Select 'SDCC Compiler' from the dropdown list, Click 'OK' (until this point both targets will be using C::B's default of GCC)
  * In the box labelled 'Selected build target files', select file 'main.c' and then click 'Selected File Properties'
  * Select the 'Advanced' tab, in the box labelled 'Custom Build', Select 'SDCC Compiler' from the dropdown list labelled 'For this compiler'
  * Tick 'Use Custom Command to build this file'
  * Type into the textbox "make.bat"
  * Click OK
  * Click OK


==== MIOS-Specific SDCC Libraries ====

TK says:
If multiplications, divisions, pointer operations, etc. are used in the .c code, the linker may fail due to missing functions, which are part of the "libsdcc.lib" library. The error message will be:

  Linking project
  lib/libsdcc.lib: No such file or directory
  ERROR!

The common library for pic16 derivatives is not compatible to MIOS, therefore I've created a special one. [[http://www.ucapps.de/mios_c.html|Click here for more information]]

  * Download the [[http://www.ucapps.de/mios/mios_libsdcc_v2_5_0.zip|MIOS-Specific SDCC Libraries]]
  * Create a 'lib' directory within the root directory of your project
  * Copy the 'libsdcc.lib' file from the above zip file into this directory
  * Open the "project.lkr" file of your project and add following line below the "LIBPATH" entry:

''
FILES lib/libsdcc.lib
''
\\
\\
\\
\\
\\

===== AC-Sim Simulator =====

==== Setup ====

Follow the instructions at [[mios_c_simulator_-_debugger|the AC-Sim WIKI page]]


==== Compile ====

==== Debug ====

===== MBHP =====

==== Compile ====

==== Debug ====

\\ 
\\
\\
//The following is yet to be documented by me....

upload
http://www.midibox.org/mios_studio/



done! Make music!
MIDIbox

User Tools

Site Tools

Page Tools
