UMC32+ DIY USB-MIDI Controller USER MANUAL. Firmware v3.1.0 / Hardware v Hale Microsystems LLC, All Rights Reserved.

Transcription

1 UMC32+ DIY USB-MIDI Cntrller USER MANUAL Firmware v3.1.0 / Hardware v Hale Micrsystems LLC, All Rights Reserved.

2 Prduct Descriptin The UMC32+ is an OEM/DIY prduct that allws Electrnic Musicians, Multimedia Artists and Experimenters the ability t create custm user interfaces t cntrl any sftware applicatin that supprts the MIDI prtcl. The UMC32+ prvides the essential cre (micrcntrller, pwer supply, USB functinality) t allw the user t easily implement their chice f cntrl elements (example: switches, pts and r faders). The UMC32+ will als translate data frm yur MIDI hst applicatin int lgic levels fr driving LEDs, Relays and mre. Easy t implement with little r n electrnics experience. 32 individually cnfigurable inputs r utputs that send r receive user defined MIDI data with any MIDI hst applicatin. 64 I/O s can be achieved by linking tw UMC32+ s tgether using the UMC-Linker bard (sld separately). Multiple units can c-exist n the USB bus. Small printed circuit bard (1.7 x 3.3 ) allws creating prtable end devices True plug-and-play (USB-MIDI class cmpliant drivers are prvided by the perating system) Cmpatible with all versins f Mac OS X, Windws 7 / Vista / XP / 2000 USB bus pwered. A single USB cable handles pwer and data. N prgramming is necessary (N cde t write). Upgradeable firmware via USB using Windws XP btlader utility (32 bit nly). Using extended MIDI cmmands, cmplex MIDI mappings can be realized including: Individual selectin f each I/O s crrespnding MIDI channel (1 t 16) Individual selectin f each I/O s crrespnding MIDI message value Individual selectin f each I/O s crrespnding MIDI message type(s): Nte On Ply Pressure Cntrller Individual selectin f each I/O s crrespnding hardware type including: Digital Input with pull-up (active lw) - Fr use with SPST tactile switches Digital Input (active lw) - Fr receiving messages frm sensrs with active lw TTL utputs Digital Input (active hi) - Fr receiving messages frm sensrs with active high TTL utputs Analg Input - Fr cnnectin t ptentimeters, jysticks, faders etc. Analg Input (Inverted) - Same as abve, except that MIDI data is inverted. Digital Output (Active High) Fr driving LED s, Relays, r high pwer FETs etc. LED Output with Blink Fr blinking f status LED's (see manual fr details). The new plus versin incrprates the fllwing enhancements ver riginal UMC32. A redesigned PCB with dedicated GND and VCC planes fr enhanced signal integrity. I/O Cnfiguratin is nw handled entirely by the cnfiguratin utility. Cnnectr fr external status LED, n bard status LED is nw blue. USB cnnectr is nw the standard TYPE B and is much mre secure. Munting hles (#4 screw) clse t USB cnnectr make fr a near bulletprf installatin. AUX I/O blck fr future expansin (TBD) Imprved Firmware Bt lader Linkable with the riginal UMC32 RHS Cmpliant (lead Free), manufactured t IPC-A-610 Rev. B, Class II. * Please nte that that the new UMC32+ firmware is nt cmpatible with the riginal UMC32. Befre prceeding it is strngly recmmended that yu read and understand the precautins sectin f this manual. Please pay attentin t the sectin discussing the safe handling and hw t avid electrstatic discharge (ESD). Failure t bserve the recmmendatins may result in damage t yur UMC32+ and vid yur warranty. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 2

3 Status Indicatr LED (CN11) The indicatr LED (LED1) can be fund next t the USB cnnectr. This LED prvides infrmatin abut the state f the UMC. When cnnected, yur cmputer will recgnize the UMC and lad the class cmpliant USB-MIDI class device driver that is prvided by yur perating system. The LED will stay n until cmmunicatin with yur hst applicatin begins. At this pint the LED will flicker when MIDI traffic between the hst applicatin and the UMC ccurs. The UMC32+ als prvides a 2 pin header + (Ande) and (Cathde) fr cnnecting t an external LED. It is imprtant t remember that in an additin t the LED itself, yu will need t prvide a current limiting resistr in series with yur LED (Less than 20mA is recmmended at 5V dc). Bt Lader / Shift Pin (CN9) When the UMC is plugged int the USB prt it first checks the state f the shift pin, if it is pulled lw (yur switch is being held) then the UMC will enter btlader mde and prepare t accept a firmware update. Infrmatin regarding firmware updates will be made available n ur website at In respnse t custmer requests there have been many revisins t the UMC firmware. It is imprtant that yu ensure that yu are reviewing the crrect manual that crrespnds with the firmware versin f yur device. During nrmal MIDI peratin this pin can duble the number f sftware parameters yu can cntrl. See Hardware I/O Types Fr mre infrmatin Multiple UMC s using a USB Hub Fr cnnecting mre than 1 UMC32+ t the same cmputer it is recmmended that yu install ne f 8 available firmware binaries n yur UMC32+. First dwnlad the latest firmware set frm the Hale website. The zip file will cntain multiple firmware revisins with.dld extensins. Next dwnlad and install the UMC32+ s firmware update utility, fllw the directins prvided by the utility and select the apprpriate firmware. Each firmware binary is slightly different in that they cntain a unique USB prduct ID as well as a unique driver name that allws the perating system t identify it n the USB bus. As a rule f thumb it is recmmended that when yu are cnfiguring yur device using the Cnfiguratin Utility yu dedicate ne MIDI channel t each device (2 MIDI channels if yu are using the shift feature). As MIDI hst applicatins and perating system d nt always lad and assign UMCs in the same rder this methd has prven t be a cnsistent way f identifying each UMC that is cnnected t yur system. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 3

4 Linking f tw UMC s fr 64 IO s (CN6) Yu have the ability t link up t 2 (tw) UMC32+s tgether using the 5 pin aux prt lcated at the far end f the bard between Bank2 (09-16) and Bank3 (17-24). The linking is achieved by cnnecting the crrespnding pins with jumpers r the UMC linker bard. Master / Slave peratin is aut-detected making the link hassle free. Please keep in mind that slaved units are nt accessible t the Cnfiguratin utility. Therefre each UMC must be cnfigured prir t being linked. The ttal current fr bth devices must nt exceed 500mA when utilizing USB bus pwer. When using a UMC as a slave device the slave must have the CN10 Jumper remved r the slave will nt perate. Setup fr USB Pwer(CN10) The factry default has CN10 fitted with a jumper t prvide pwer via the USB bus. This als prvides a cnvenients means fr measuring the current cnsumptin f yur final build. The nly ther cases where this jumper shuld be remved r ff is when a UMC is cnnected t a linker bard and is being used as a slave, r when external pwer is being used as a Master. Aux Cnnectr (An extra 8 inputs!) This cnnectr will prvide a means fr future expansin. It is cnfigured as a digital input with a 10mS debunce. The input Type is NOT cnfigurable and is fixed as Nte On/Off Channel 1, Nte # 1 thru 8 if Master, and Ntes # 9 thru 16 if a linked slave. The shift pin als wrks here. If a jumper is placed acrss Pin1 and Pin3 f the Aux Cnnectr ( A and Grund - see Pin Diagram n Page 11), the UMC will cnfigure it s 32 I/O s as Digital Inputs. This test mde is useful tr truble shting and diagnsis. It is als imprtant t nte that this test mde will nt verwrite any f yur cnfiguratin settings as nly the cnfiguratin utility will d that. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 4

5 I/O setup using the cnfiguratin utility T begin, dwnlad and install the UMC32+ cnfiguratin utility. It is recmmended that yur vide display shuld be set at a minimum screen reslutin f 1024x768 r higher). The utility is available fr dwnlad here. Hw t cnfigure (quick start): 1) Discnnect any wires, ribbn r usb cables frm the UMC. Clse any MIDI hst applicatins that may be running as the cnfiguratin utility needs exclusive access t the UMC s MIDI I/O. 2) Recnnect the UMC32+ t yur PC with yur USB cable. If this is the first time yu have cnnected this device t yur cmputer please wait until Windws displays a message stating that yur hardware/devices are ready t use. 3) After windws has installed and laded the drivers fr the device, launch the UMC32_Plus_CnfigUtil_v1xx applicatin. 4) In the MIDI Prts sectin, select the IN Device, and the crrespnding OUT device. If yu are using Windws XP the UMC32+ will shw up as USB Audi Device, under Vista and Windws 7 it will shw up as UMC32+_D0x, where x is the device number... The device number yu see will depend n the firmware that yu have btladed int the UMC. All devices are shipped frm the factry as D01. 5) Click Open t pen MIDI input and MIDI utput prts. 6) Click Read. This will cause the applicatin t grab all f the current cnfiguratin data fr the selected device int the applicatin. The Status windw shuld display the fllwing: Status: UMC32+ read OK Firmware: v3.x.x Build Date: MM//DD//YY 7) Fr each I/O channel select the Hardware I/O type, MIDI Channel, Message Type and message number. 8) When yu are finished, click n Write t update the UMC with the changes yu have made. 9) Exit/Quit the applicatin. 10) Discnnect the USB cable frm the UMC, then recnnect it t resume nrmal MIDI peratins. Please exercise care in selecting and cnnecting any sensrs r cntrls t yur UMC. It is recmmended that yu triple check yur wiring t and frm the UMC. This is especially the case when using Output Mde(s). It is quite easy t set a channel fr utput mde and mistake it as an input when cnnecting yur pts r switches causing a shrt circuit. If yu are in dubt abut the hardware type f yur cntrl please pst yur cmpatibility questin in the UMC32+ user frums lcated at Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 5

6 Cnfiguratin utility cntrls and settings Hardware I/O Types: I/O Disabled Channel I/O is disabled and will nt be prcessed. All unused channels shuld use this setting. IN Digital w/pullup (2ms) Channel is set fr Digital (TTL) input with the micrcntrller s internal pullup enabled. This type is the same digital input mde when using the nbard DIP pack. This type f input is typically used t cnnect t a single ple single thrw switch. One end f the switch cnnects t grund the ther will cnnect t this I/O channel. This type is als useful fr sensrs that pull the line lw (active lw) when the sensr is actuated and release the line r place it in Hi-Z state when the sensr is nt actuated. The variatins f this input type 2ms, 5ms, 10ms and 20ms dente the debunce delay utilized when the switch is read. Higher values are useful fr switches that generate unwanted nise when actuated. IN Digital (Active Lw) - Channel is set fr Digital (TTL) input. This type is used when accepting a high r lw signal frm the utput f a pwered sensr n/ff type utput. This is fr sensrs that pull the line lw when the sensr is actuated and high when it is nt actuated. IN Digital (Active High) - Channel is set fr Digital (TTL) input. This type is used when accepting a high r lw signal frm the utput f a pwered sensr with a n/ff type utput. This is fr sensrs that pull the line high when the sensr is actuated and lw when it is nt actuated. IN Analg Average - Channel is set fr Analg (0v t 5vlts) inputs. This is mst cmmnly used fr cnnectin t ptentimeters, faders and jysticks. It can als accept the input frm ther sensrs that utput a vltage in the range f 0 t 5 vlts. In this mde, an input f 5 vlts will generate a message value f 127 (0x7F hex), whereas an input f 0 vlts (grund) will generate a message value f 0 (0x00 hex). IN Analg Average w/shift Same as previus Type IN Analg Average (Inverted) Same as abve hwever in this mde, an input f 5 vlts will generate a message value f 0 (0x00 hex), whereas an input f 0 vlts (grund) will generate a message value f 127 (0x7F hex). This mde is especially useful if yu happen t slder the +5V and Grund terminals n a ptentimeter backwards. Instead f repening yur device t crrect the prblem by reslder again, simply select this mde instead. IN Analg Average (Inverted) Same as previus Type IN Analg Direct This input type reprts the raw value f the ADC and des nt perfrm any averaging n the sampled data. This mde is mst useful fr raw perfrmance and is best used with s frce sensing resistrs r sft pts. Yu shuld expect t see errneus data frm this type f input since filtering is disabled. IN Analg Direct (Inverted) Same as abve hwever a value f 0 becmes 127, and 127 becmes 0. See abve fr mre infrmatin. OUT Digital (Active High) If a crrespnding MIDI message is received by the UMC with a value f 0 then the utput fr this channel will be lw r 0 vlts (grund). If the crrespnding MIDI message is 127 (0x7F in hexadecimal) then the utput will be high r +5vlts. OUT LED Blink This mde functins like the OUT Digital abve hwever, values between 64 and 127 shall turn the LED n values between 1 and 63 shall blink the LED. Zer value turns the LED ff. IN Analg Average (MIDI OFF) This input type is used fr internal testing and shuld nt be used. The selected channel is sampled hwever n data is transmitted. MIDI channel shifting using the BtLdr/Shift pin The cnfiguratin utility als prvides variants f the abve inputs types. These are pst fixed as with Shift. When a buttn cnnected t the shift pin is pressed data is transmitted n the base f the MIDI Channel plus 8. This effectively multiplies the number f sftware parameters that yu can manipulate with yur cntrller. Fr example a buttn that rdinarily sends a Nte n, Nte #24, n MIDI Channel 1, when Shifted instead sends Nte n, Nte #24, MIDI Channel 9. Fr types that are assigned with a base channel f 9 thru 16, thse are shifted dwn. Fr example a buttn that rdinarily sends a Nte n, Nte #30, n MIDI Channel 10, when Shifted instead sends Nte n, Nte #30, MIDI Channel 2. MIDI CH Here yu can select the desired MIDI Input r utput channel that crrespnds t the UMC32+ s physical hardware I/O channel. Here Yu can select 1 f 16 channels. When using multiple UMC32s n different prts f a USB hub it is recmmended that yu assign a MIDI channel t a UMC and stick with it. As it is impssible t guarantee the rder which multiple UMC32 will enumerate with Windws a full prf way t cnsistently identify an assigned I/O is by its MIDI channel. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 6

7 Message Type Nte On (0x90) This is the recmmended message type fr input r utput cntrls that are Blean r ON/OFF. Such cntrls are switches, r ther sensrs that utput a lgic level high r lw. When this mde is selected fr a channel there are certain cnditins that will cause a nte ff (0x80) message t be generated. Instead f generating a Nte On with a velcity f zer the UMC will generate a true nte ff message. This applies t IN Digital w/pullup (active lw), IN Digital (Active Lw), IN Digital (Active High) hardware Input types. Fr the hardware Output type(s), bth nte n velcity f 0 as well as Nte ff velcity zer are interpreted crrectly by the UMC. Ply Pressure (0xA0) & Cntrller (0xB0): These message types are recmmended fr I/O s that are cnfigured as Analg inputs. Msg Num (Message Number) Depending n the Message type the message number may be interpreted differently. The allwable range fr this parameter is 0 t 127 (0x00 t 0x7F in hexadecimal). With regards t nte n and ply pressure message types these values are indicative f nte numbers r keys n a pian keybard. Fr instance C-1 is 0, C#4 is 61 and G9 is 127. Default: This will initialize all cntrls t the fllwing: IN Digital w/pull-up (active lw), MIDI Channel X (where X = the device #), Nte On, message number 36 thru 67. All Off: This will initialize all cntrls t the fllwing: I/O Disabled, MIDI Channel X (Where X = the device #), Nte On, message number 36 thru 67. General Precautins The UMC is designed t prtect against shrt circuits, ver current cnditins, transient vltages and electrstatic discharge. Hwever, we ask that yu bserve sme simple guidelines when wrking with the UMC. Failure t d s may cause damage t yur equipment and/r vid yur prduct warranty. Treat the UMC32 as yu wuld any mdern cmputer RAM and bserve best practices fr Electrstatic Discharge see: r D nt place a jumper r therwise shrt circuit the ExtLED pins r the Ext 5V Pwer pins. D nt slder any wires r attempt t make any mdificatins t the UMC directly. D nt cnnect the +V (+5 Vlts DC) terminal t G (Grund). When this ccurs, it is cmmnly referred t as a shrt circuit. Always unplug the USB cable frm the device befre mdifying cnnectins n the UMC. As with all electrnic devices, bserve prper ESD handling practices. Always handle the printed circuit bard (PCB) by the edges, never tuch the tp r bttm. Failure t make sure yu are grund Never allw the UMC t tuch a wet r cnductive surface. D nt use any external vltage surce t pwer devices that are cnnected t the UMC. The maximum recmmended current per channel is 8mA.. Yu may use the +5V and Grund pins ff each bank t pwer ther devices such as LED s hwever the maximum recmmended is 80mA. As an additinal precautin, we strngly recmmend using a pwered USB hub when experimenting with the device. Once yu have finalized yur prject, and are sure yu d nt have any shrt circuits then yu may cnnect the UMC directly t yur cmputer s USB input. This is especially imprtant when interfacing with a laptp, as damage t yur laptp culd be substantial. This prduct is ffered t the end user in a nn-enclsed OEM frm, it is the respnsibility f the end user f this prduct t ensure that they cmply with lcal regulatins pertaining t unintentinal radi frequency emissins. In the United States, this pertains t FCC rules and regulatins, Part 15, Sectin B. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 7

8 Example Cnnectins Althugh there are a seemingly infinite number f types f cntrl elements (ptentimeters, switches etc.) that yu can cnnect t the UMC, here are a few examples f hw t cnnect the mst cmmn types. * Please nte that cnnectin t +5V is nt necessary fr any SPST switch. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 8

9 UMC32+ DIY USB-MIDI User Manual UMC32+ I/O Pin Diagram UMC32+ in picture abve with attached ribbn cable Ribbn cable kit sld separately (Part # RIB50) Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 9

10 Tw (2) UMC32+ s with 10 EXP8SC screw terminal bards fr 64 channel inputs plus an additinal 16 switches n the Aux inputs (8 frm master, 8 frm slave). This prvides a ttal f 80 cntrls using a single bus pwered USB cnnectr. Linker bard (in center) cnnects the UMC s tgether. Using multiple prcessrs (a dedicated prcessr fr every 32 I/O s and 8 aux inputs) the UMC can achieve a scan rate that is 2X faster than a single prcessr. It shuld be nted that the UMC that is cnnected t the USB bus is the Master, while the linked UMC is the slave. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 10

11 Mechanical Specificatins UMC32+ dimensins (inches): USB Cnnectr measurments (millimeters): The three 0.22 munting hles fr the UMC32+ are fr #4 screws Electrical Specificatins Exceeding the abslute maximum ratings belw may cause permanent damage t the device. Strage temperature: -20ºC t + 70ºC Operating temperature: 0ºC t + 50ºC Operating vltage (pwer supplied via USB bus): 5.1 Vlts DC max Max recmmended current per I/O channel 8mA Maximum device current: *500mA USB Bus Pwered, 2A external. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 11

12 Limited Warranty Disclaimer Hale Micrsystems LLC warrants this prduct t be free f manufacturing defects fr a perid f 90 days (USA nly). If yu feel that there is a defect with yur device, please technical supprt with a detailed descriptin f the prblem: supprt@halemicr.cm. In mst cases we will simply issue a replacement. It is the respnsibility f the custmer t cver the cst f shipping t and frm Hale Micr. Devices shall nly be accepted in riginal factry packaging. We will nt accept the return f any prduct that has been mdified beynd factry cnditin. Any attempt t mdify yur unit shall vid this warranty. Neither the whle nr any part f the infrmatin cntained herein r the prduct described in this datasheet may be adapted r reprduced in any material r electrnic frm withut the prir written cnsent f Hale Micrsystems. This prduct and its dcumentatin are supplied n an as-is basis, and n warranty as t their suitability fr any particular purpse is either made r implied. Hale Micrsystems LLC will nt accept any claim fr damages whatsever arising as a result f use r failure f this prduct. Yur statutry rights are nt affected. This prduct is nt intended fr use in any medical appliance, device r system in which the failure f the prduct might reasnably be expected t result in persnal injury. This dcument prvides preliminary infrmatin that may be subject t change withut ntice. Windws is a registered trademark f Micrsft Crpratin in the United States and ther cuntries. Firmware v3.1.0, Hardware v1.1, Datasheet: 03/20/2011 1:37 PM / Hale Micrsystems LLC, 12