User Tools

Site Tools


mios_studio

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
mios_studio [2008/12/30 18:00]
indeep
mios_studio [2009/11/28 13:54]
wackazong
Line 1: Line 1:
 ====== MIOS Studio ====== ====== 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 wayand 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 RoutingFiltering ​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 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 workingare there any problems, +Finally don't forget to edit this page if you discover compatibility issuesworkaroundsor have anything to add.
-does the user interface need improvements,​ which features could be useful?+
  
 ===== Installation Instructions ===== ===== 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. 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 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   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.** 
  
-You will first need to install either //​Plumstone//​ (PPC only) or //Mandolane.// or Mmj   ​Either can be downloaded for free from Mandolane Limited: [[http://​www.mandolane.co.uk/software.html]] (This software requires ​manual installso be sure to follow included instructions)+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 java applicationyou will need something ​to bridge the gap between your midi hardware and java.
  
-Mmj can be donwloaded at mmj "mmj - Mac OS X universal binary java Midi subsystem"​[[http://​www.humatic.de/​htools/​mmj.htm]] (This software requires a manual install, so be sure to follow included instructions).+Free (ppc/​intel):​ 
 +//mmj// "mmj - Mac OS X universal binary java Midi subsystem"​ 
 +[[http://​www.humatic.de/​htools/​mmj.htm]] (This software requires a manual install, so be sure to follow included instructions).
 Also, if you use Mandolane and then change to mmj be sure to clean the older files of mandolane in your system (speacialy the .lic mandolane file). Also, if you use Mandolane and then change to mmj be sure to clean the older files of mandolane in your system (speacialy the .lic mandolane file).
-Support ​mmj by donating ​5 euros +Please support ​mmj by donating
  
-The "official" ​MIOS Studio 7.x thread is here:  ​[[http://​www.midibox.org/​forum/​index.php/topic,​7238.0.html]] ​- Simply download MIOS Studiocopy the "​jar"​ file to your applications folder, and double-click it to run!  Please read the entire thread, especially if you have problems.  ​+Free (ppc): 
 +//​Plumstone// ​"Plumstone MIDI SPI for PPC Macs only" ​ 
 +[[http://​www.mandolane.co.uk/software.html]] ​(This software requires a manual installso be sure to follow included instructions)
  
-If you intend to continue to use Mandolanedon't forget to pay for it!  It's the only way to bring MIOS Studio to your Mac, therefore it just saved your bacon! ​  The cost is only £5, payable via PayPal.+Demo (time-limitedppc/​intel):​ 
 +//​Mandolane.//​ "​Mandolane MIDI SPI for PPC/Intel Macs (£5)" 
 +[[http://​www.mandolane.co.uk/​software.html]] (This software requires a manual install, so be sure to follow included instructions)
  
-Also don't forget to edit this page if you discover compatibility issues, or have anything ​to add.+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! 
  
 +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 MIDI support ​is supposed ​to be working, but I have had many problems - possibly due to an older kernel ​and ALSA drivers. If anyone can test on a newer version of Linux (with Java 1.5 installed) it would be greatly appreciated. ​+ 
 +==== Linux ==== 
 + 
 +This is now confirmed ​to work on various distros ​and MIDI interfaces:
  
 For Debian and distributions based on it, such as Ubuntu; you need to install three packages. For Debian and distributions based on it, such as Ubuntu; you need to install three packages.
-  sudo apt-get install sun-java5-bin sun-java5-jre libgcj7-awt+  sudo apt-get install sun-java6-bin sun-java6-jre libgcj8-awt
 Once this is done, you can start MIOS Studio by typing: Once this is done, you can start MIOS Studio by typing:
   java -jar MIOSStudio(version).jar   java -jar MIOSStudio(version).jar
Line 58: Line 63:
 =====Using MIOS Studio===== =====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 ==== ==== 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**!!! :) 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. 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}}
mios_studio.txt · Last modified: 2011/10/08 22:13 by gslug