Differences

This shows you the differences between two versions of the page.

--- mios_studio [2009/01/13 17:42] – stryd_one
+++ mios_studio [2009/11/28 13:54] – wackazong
@@ Line 1: / Line 1: @@
 ====== MIOS Studio ======
-The original documentation can be found under [[http://miosstudio.midibox.org/|MIOS Studio]]
+MIOS Studio was started by [[Wilba]] in November 2003, and later taken over by Adam King.  The original documentation can be found at [[http://miosstudio.midibox.org/]].
-MIOS Studio was started by Wilba in November 2003, and later taken over by Adam King.
+It is a java-based, platform-independent MIDI processing environment, which not only provides upload and debug functions for MIOS, but also other useful features like MIDI port routing, data filtering, and a virtual keyboard. It's written in a modular way, and will be published under GPL later so that other programmers can make their contributions.
-It is a java-based, platform-independent MIDI processing environment, which not only provides upload and debug functions for MIOS, but also advanced features like MIDI Port Routing, Filtering and a virtual Keyboard. It's written in a modular way and will be published under GPL later so that other programmers can make their contributions.
 Adam hasn't finished all of his plans yet, therefore only a precompiled
-binary package is available. It can be downloaded from the [[http://www.midibox.org/forum/index.php/topic,7238.0.html|MIOS Studio beta7]] forum thread.
+binary package is available. It can be downloaded from the [[http://www.midibox.org/forum/index.php/topic,12721.0.html|MIOS Studio beta 8]] forum thread.  Please **read the entire thread**, especially if you encounter problems.  He is interested in your input: how is it working, are there any problems, does the user interface need improvements, which features could be useful?
-He is interested in your inputs - how is it working, are there any problems,
+Finally don't forget to edit this page if you discover compatibility issues, workarounds, or have anything to add.
-does the user interface need improvements, which features could be useful?
 ===== Installation Instructions =====
-So far the program has been tested with Windows 98, 2000 and XP. In theory, it should also run on Vista, Linux and Mac but the old saying proves true, "write once, debug everywhere".
+==== Windows ====
-==== Windows Installation Instructions ====
 To run MIOS Studio you will need the Java Runtime, at least version 1.5 installed. If you do not have it, you will need to go to the Sun site [[http://java.sun.com/j2se/1.5.0/download.jsp]] first, download the JRE 5.0 setup file and install it.
@@ Line 29: / Line 24: @@
 As an added utility, a cutdown version with just a keyboard controller, MIDI routing/filtering and keyboard zone mapping is available. This can be started with the command
   java -cp <path_to_jar_file>/MIOSStudio_beta7_5.jar org.midibox.apps.virtualkeyboard.~VirtualKeyboard
-==== Mac Installation Instructions ====
+==== Mac OS X ====
-MIOS Studio 7.5 Beta functions correctly under Mac OS X 10.4 (and, likely, onward).
+MIOS Studio functions correctly with Mac OS X 10.4 ("Tiger") and 10.5 ("Leopard"), **but currently does not function correctly with 10.6 ("Snow Leopard")**.
+**UPDATE: When Mandolane 2_95 is installed it appears to be working fine on Snow Leopard.**
-As of Mac OS X version 10.4.8 Apple no longer supports the com.apple.audio.midi java package, which on previous OS X versions allowed java applications to easily access the CoreMIDI system.  In order to use MIOS Studio you will need something to bridge this gap between your midi hardware and java.
+For versions of Mac OS X since 10.4.8, Apple no longer supports the com.apple.audio.midi java package, which allowed java applications to access the CoreMIDI system.  Because MIOS Studio is a java application, you will need something to bridge the gap between your midi hardware and java.
 Free (ppc/intel):
@@ Line 49: / Line 45: @@
 [[http://www.mandolane.co.uk/software.html]] (This software requires a manual install, so be sure to follow included instructions)
-The "official" MIOS Studio 7.x thread is here:  [[http://www.midibox.org/forum/index.php/topic,7238.0.html]] - Simply download MIOS Studio, copy the "jar" file to your applications folder, and double-click it to run!  Please read the entire thread, especially if you have problems.
+After you have installed one of the Java/MIDI enablers above, simply download MIOS Studio, copy the "jar" file to your applications folder, and double-click it to run!
-Also don't forget to edit this page if you discover compatibility issues, or have anything to add.
+The layout of the windows will be automatically stored when you exit MIOS Studio properly. Don't use Cmd-Q (like for other Mac applications), but use File->Exit
-==== Linux Installation Instructions ====
+==== Linux ====
 This is now confirmed to work on various distros and MIDI interfaces:
@@ Line 66: / Line 63: @@
 =====Using MIOS Studio=====
-Below are examples of some of the main features of MIOS Studio. For further details, click on the links to go to the relevent section of the [[http://www.midibox.org/mios_studio/index.html|MIOS Studio Help File]].
+Below are examples of some of the main features of MIOS Studio. For further details, click on the links to go to the relevent section of the [[http://www.midibox.org/miosstudio/help/index.html|MIOS Studio Help File]].
 ==== MIDI Routing ====
-[[http://www.midibox.org/mios_studio/midi/gui/help/midi_routing.html|MIDI Device Routing:]] it allows you to forward and filter MIDI streams to any MIDI port. At the top of the list you will always find the MIOS Studio In and Out port. This is the port to which MIDI data has to be routed when you want to upload code, monitor it, send debug commands, etc...
+[[http://www.midibox.org/miosstudio/help/midi_routing.html|MIDI Device Routing:]] it allows you to forward and filter MIDI streams to any MIDI port. At the top of the list you will always find the MIOS Studio In and Out port. This is the port to which MIDI data has to be routed when you want to upload code, monitor it, send debug commands, etc...
-**The readable port (MIDI IN of your interface) has to be routed to the MIOS Studio In Port, and the writable port (MIDI OUT of your interface) has to be routed to the MIOS Studio OUT Port:**
+**You must set up the readable port: "MIDI IN" of your interface __must be routed__ to the "MIOS Studio In" Port, and the writable port (MIDI OUT of your interface) has to be routed to the MIOS Studio OUT Port:**
-{{http://www.midibox.org/mios_studio/mios_studio_routing2_s.gif}}
+[[http://www.midibox.org/miosstudio/help/midi_routing.html|{{http://www.midibox.org/miosstudio/mios_studio_routing2_s.gif}}]]
-==== HEX Upload ====
+==== Uploading Applications to MIDIbox ====
-[[http://www.midibox.org/mios_studio/mios/gui/help/mios_upload.html|Hex Upload:]] The MIOS code upload is very comfortable - you don't need to generate a .syx anymore, HEX files can be uploaded directly:
+[[http://www.midibox.org/miosstudio/help/mios_upload.html|Hex Upload:]] The MIOS code upload is very comfortable - you don't need to generate a .syx anymore, HEX files can be uploaded directly:
-{{http://www.midibox.org/mios_studio/mios_studio_upload_s.gif}}
+{{http://www.midibox.org/miosstudio/mios_studio_upload_s.gif}}
 You should **ALWAYS** use 'Smart Mode', and enable 'Wait for Upload Request', and then power on your core after hitting 'Start'. **ALWAYS**. If this doesn't work, there's something wrong, and you should begin troubleshooting as per [[http://www.ucapps.de/howto_debug_midi.html| the uCApps MIDI Troubleshooting page]]. **ALWAYS**!!! :)
-==== Other Tools ====
+==== Filtering MIDI events ====
-[[http://www.midibox.org/mios_studio/midi/gui/help/midi_filter.html|MIDI Filter:]] It's possible to filter MIDI events:
+[[http://www.midibox.org/miosstudio/help/midi_filter.html|MIDI Filter:]] It's possible to filter MIDI events:
-{{http://www.midibox.org/mios_studio/mios_studio_filter_s.gif}}
+{{http://www.midibox.org/miosstudio/mios_studio_filter_s.gif}}
-[[http://www.midibox.org/mios_studio/mios/gui/help/mios_debug_lcd.html|MIOS Debug LCD:]] LCD messages can be generated:
+==== Displaying Messages on Your MIDIbox LCD ====
+[[http://www.midibox.org/miosstudio/help/mios_debug_lcd.html|MIOS Debug LCD:]] This is useful for debugging your LCD connection, or just amazing your friends.
-{{http://www.midibox.org/mios_studio/mios_studio_lcd_s.gif}}
+{{http://www.midibox.org/miosstudio/mios_studio_lcd_s.gif}}
+==== MIOS / Application debugging ====
+[[http://www.midibox.org/miosstudio/help/mios_debug_functions.html|MIOS Debug Functions:]] The MIOS debug window allows to execute MIOS functions via remote:
-[[http://www.midibox.org/mios_studio/mios/gui/help/mios_debug_functions.html|MIOS Debug Functions:]] The MIOS debug window allows to execute MIOS functions via remote:
+{{http://www.midibox.org/miosstudio/mios_studio_functions_s.gif}}
-{{http://www.midibox.org/mios_studio/mios_studio_functions_s.gif}}
 It's also possible to read and write the memory.
-[[http://www.midibox.org/mios_studio/apps/miosstudio/gui/help/mios_studio_external.html|Run External Commands:]] Buttons on the toolbar can be customised to run external commands:
+[[http://www.midibox.org/miosstudio/help/mios_studio_external.html|Run External Commands:]] Buttons on the toolbar can be customised to run external commands:
-{{http://www.midibox.org/mios_studio/mios_studio_external_s.gif}}
+{{http://www.midibox.org/miosstudio/mios_studio_external_s.gif}}
-[[http://www.midibox.org/mios_studio/midi/gui/help/midi_keyboard_controller.html|MIDI Keyboard Controller:]] A virtual keyboard controller is also available:
+==== On-Screen Keyboard ====
+[[http://www.midibox.org/miosstudio/help/midi_keyboard_controller.html|MIDI Keyboard Controller:]] A virtual keyboard controller is also available:
-{{http://www.midibox.org/mios_studio/mios_studio_keyboard_s.gif}}
+{{http://www.midibox.org/miosstudio/mios_studio_keyboard_s.gif}}
-[[http://www.midibox.org/mios_studio/apps/virtualkeyboard/gui/help/index.html|Virtual Keyboard:]] A smaller standalone program is also available with just the features of the keyboard controller and MIDI Routing/Mapping:
+===== Virtual Keyboard / MIDI Processor =====
+[[http://www.midibox.org/miosstudio/help/index.html|Virtual Keyboard:]] A smaller standalone program is also available with just the features of the keyboard controller and MIDI Routing/Mapping.  This is more suitable for somebody who wants these functions but isn't building a MIDIbox.
-{{http://www.midibox.org/mios_studio/virtual_keyboard_s.gif}}
+{{http://www.midibox.org/miosstudio/virtual_keyboard_s.gif}}