getting started with brainstem/mtm (2 of 2) - acroname started with brainstem/mtm ... next to the d0...

22
Getting Started with BrainStem/MTM (2 of 2) Software Setup Guide Thank you for choosing MTM from Acroname! In this guide, we will walk an initial bring-up and basic evaluation of the BrainStem/MTM platform. By the end of this guide, you will be able to: 1. Use USB to access MTM modules over the BrainStem network 2. Use the Updater tool to update your MTM modules to the latest firmware and 3. Use StemTool to exercise simple functions using resources of the MTM modules: a. Configuring, setting and reading digital signals b. Analog measurement of a digital signal c. Analog measurement of an analog signal d. Enable BrainStem network routing to access multiple MTM modules e. Using multiple MTM modules - analog measurement of a power rail Before you start, you will need an MTM Development Board and the relevant MTM modules that you will be exercising in your project. See the “Getting Started with BrainStem/MTM: Hardware Setup Guide” document.

Upload: haminh

Post on 22-Mar-2018

216 views

Category:

Documents


3 download

TRANSCRIPT

GettingStartedwithBrainStem/MTM(2of2)SoftwareSetupGuideThankyouforchoosingMTMfromAcroname!Inthisguide,wewillwalkaninitialbring-upandbasicevaluationoftheBrainStem/MTMplatform.Bytheendofthisguide,youwillbeableto:

1. UseUSBtoaccessMTMmodulesovertheBrainStemnetwork2. UsetheUpdatertooltoupdateyourMTMmodulestothelatestfirmwareand3. UseStemTooltoexercisesimplefunctionsusingresourcesoftheMTMmodules:

a. Configuring,settingandreadingdigitalsignalsb. Analogmeasurementofadigitalsignalc. Analogmeasurementofananalogsignald. EnableBrainStemnetworkroutingtoaccessmultipleMTMmodulese. UsingmultipleMTMmodules-analogmeasurementofapowerrail

Beforeyoustart,youwillneedanMTMDevelopmentBoardandtherelevantMTMmodulesthatyouwillbeexercisinginyourproject.Seethe“GettingStartedwithBrainStem/MTM:HardwareSetupGuide”document.

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page2of22Acroname,

SetupMTMHardwareYouwillneedaninternet-connectedhostcomputerwithatleastoneUSBportandrunningeitherWindows(7orhigher),LinuxorMacOSX.Inthisexample,wewillberunningWindows10.FromtheHardwareSetupGuide,weassumethatMTMEvaluationKithardwareisavailableandrunning:

(1)MTMDevelopmentBoard(1)MTMUSBStemModule(1)MTMPM-1Single-ChannelProgrammablePowerModule(1)MTMIO-SerialModule(1)12V/5Apowersupply(1)USBTypeAtomini-USBcable

Figure1:MTMEvaluationKit

OnceyourMTMhardwareissetupandpoweredon,youwillneedtoconnectonemoduletoyourhostmachine.TheconnectioncanbetoanyofthemodulesintheMTMEvaluationKit,butforthefirstexample,wewillconnectourhosttotheMTM-USBStemmoduleusingmini-BUSBedgeconnector:

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page3of22Acroname,

Figure2:PluginUSBfromhostmachine

WiththehostpluggedintotheMTMmoduleedgeconnector,youshouldnowseetheyellow“USBStatus”LEDlittoindicateanactivehostconnection:

Figure3:HostLEDenabledwhenUSBhostdetected

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page4of22Acroname,

DownloadBrainStemDeveloper’sKitInordertocommunicatewithanyoftheMTMmodules,theBrainStemlibrarieswillneedtobeinstalledonthehostmachine.DownloadthelatestBDK(BrainStemDeveloper’sKit)packagefromAcroname(www.acroname.com/software)

Figure4:LocationofBrainStemDevelopmentKitDownload

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page5of22Acroname,

ExpandtheBDKpackagetoadirectoryofyourchoosing.Inthisexample,wehaveinstalledtheBrainStemDevelopmentKitforMSWindowstothelocalDesktopfolder:

Figure5:BrainStemDevelopmentKit(BDK)foldercontents

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page6of22Acroname,

**Windows7CAVEAT**UnderWindows7,youwillneedtomanuallyloadtheUSBBrainStemdriver.ThisappliesonlytoWindows7anddoesnotapplytoWindows8.1orhigher.InstructionstoupdatetheBrainStemdriverinWindows7arealsoincludedwithintheBDKdirectoryunderthe\driversfolder:

Figure6:Windows7DriverInstallationInstructions

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page7of22Acroname,

Inthenextstepsofthisguide,wewillbeusingtwoapplications,locatedinthe/binfolder:• Updater

CLI/commandlineinterfacetoolforupdatingandmanagingBrainStemfirmware• StemTool

GUItoolusedforexercisingsimpleMTMmodulefunctionsandtroubleshooting

Figure7:StemToolandUpdaterUtilities

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page8of22Acroname,

FirmwareUpdateNowthattheBrainStemdriverisloaded,updatefirmwareontheBrainStem/MTMmodulestothelatestversion.OpenacommandlineinWindows:

Figure8:WindowsCommandLine

NavigatetotheBDKdirectoryandfindthe\binfolderwhereyouwillfindtheupdaterutility:

Figure9:LocationofUpdaterinWindowscommandterminal

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page9of22Acroname,

Fromthecommandline,runtwoseparatecommandstoupdatefirmware: updater-D<<thiswillDiscoveranylocallyattachedBrainStemdevicesandreturnserialnumbersinXXXXXXXXformat>>

Figure10:Updaterutility-Discover

updater-G-U-dXXXXXXXX<<thiscommandwillGetlatestfirmwarefromAcronameserversandUpdatethedevicewithserialnumberXXXXXXXX>>

Figure11:Updaterutility–Getlatestfirmware,Updatetolatestfirmware

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page10of22

Figure12:Successfulfirmwareupdate

Oncetheupdaterutilitysuccessfullyupdatesthemoduleyouareconnectedto,movetheUSBconnectiontothenextmoduleyouwouldliketoupdateandrepeattheupdatercommandsequenceforeachmodule.Inthefuture,withBrainStemnetworkingenabled,youcanupdateallmoduleswithouthavingtomovetheUSBconnection.

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page11of22

ExercisingMTMModulesStemToolisausefulutilityforexercisingsimplefunctionsandgenerallytroubleshootingMTMmodulesinthelaborinthefield.StarttheStemToolGUI:OpentheBDKfolderandnavigatetothe\bindirectory.Double-clickStemTool:

Figure13:LocationofStemToolUtility

Figure14:StemToolUtilitywithMTM-USBStem

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page12of22

Exercise1:TogglingaDigitalIOOntheMTMDevelopmentboard,connectawirefromoneDigitalpintoanotherdigitalpin.Inthisexample,seethewhitejumperwireconnectingD0toD7ontheMTM-USBStem:

Figure15:ExampleconnectiontotoggleaDigitalIO

InStemTool,findtheDigitalI/Oresourcesection.ChangetheconfigurationoftheD0resourcefromit’sdefault(input)toanoutput:

Figure16:UsingStemTooltochangeMTMDigitalresourceconfiguration

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page13of22

TogglingthecheckboxnexttotheD0outputwillchangethelogiclevelonD0.SinceD0isconnectedtoD7,theD7inputlogiclevelwillchangeasindicatedbytheD7checkbox:

Figure17:UsingMTMtochangeandreadanMTMDigitalresourcevalue

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page14of22

Exercise2:MeasuringavoltageOntheMTMDevelopmentboard,connectawirefromoneDigitalpintoanAnaloginputpin.Inthisexample,seetheyellowjumperconnectingD1toAD0ontheMTM-USBStem:

Figure18:Exampleconnectiontomeasurevoltageofadigitaloutput

InStemTool,findtheAnalogresourcesectionandDigitalI/Oresourcesection.ChangetheconfigurationoftheD1resourcefromit’sdefault(input)toanoutput:

Figure19:UseStemTooltochangeD1configurationtodigitaloutput

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page15of22

TheA2D0isnowmeasuringthehighlogiclevelvoltageontheD1digitalpin.ToggletheD1outputvalueboxandyoucanseetheA2D0voltagemeasurementchange:

Figure20:UsingStemTooltoshowanalogvoltagemeasurmentofadigitaloutput

SincetheA2D1andA2D2inputsarenotconnectedtoanysignal,theyarefloatingandtheirmeasurementsindicatethatcase.

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page16of22

Exercise3:Settingananalogoutput,measuringananalogvoltageOntheMTMDevelopmentboard,connectawirefromananalogoutputtoananaloginput.Inthisexample,seetheredjumperwireconnectingA2D3(fixedconfigurationasanoutput)totheA2D1inputontheMTM-USBStem:

Figure21:Exampleconnectiontomeasureanalogvoltageofananalogsignal

InStemTool,findtheAnalogresourcesection.ChangethevalueoftheA2D3analogoutputbyusingthesliderortheentrybox.NotethattheA2D1valueisaffectedandwecanmeasuretheanalogvoltageoftheA2D3outputusingtheA2D1input:

Figure22:UsingStemToolforanalogmeasurements.A2D3outputvaluebeingmeasuredbyA2D1

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page17of22

Figure23:IncreasingA2D3outputvalueandmeasuringatA2D1

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page18of22

Exercise4:EnablingRoutingofaBrainStemNetworkInatestenvironment,multipleMTMmodulesareusuallypresent.TheBrainStemnetworkallowsforasinglehostconnectiontoonemoduletopassBrainStemcommandsanddatatoanyotherBrainStem-connectedmodule.Inthisexercise,wewillenableroutingofaBrainStemnetworkthroughthehost-connectedmodule.Afterdoingso,wewillthenbeabletoaccessresourcesorupdatefirmwareonanynetworkedmodules–allusingthesameUSBhostconnection.TheBrainStemnetworkwillroutecommandsappropriatelybetweenmodules.ToenabletheBrainStemnetwork,useStemTooltoenabletheRouteToMecommand.ThiswillinstructtheselectedmoduletonowbetheparentorroutinghubforallBrainStemnetworktraffic.AllattachedmodulesareconsideredchildmodulesintheBrainStemnetwork:

Figure24:EnableroutingoftheBrainStemnetworkontheselectedmodule

**NOTE**BrainStemroutingsettingsoftheparentandallchildmoduleswillremainuntil:(1)theRouteToMefunctionisdisabledviaStemTool,(2)theMTMDevelopmentBoardisresetviabuttonpushor(3)apowercycleconditionoccurs.

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page19of22

WiththeBrainStemnowenabledandroutedthroughtheparentMTM-USBStem,notetheotherwhicharenowMTMmodulesaccessible:

Figure25:MTMmodulesdiscoveredundertheparentmoduleontheBrainStemnetwork

SelecttheMTM-PM-1module.TheBrainStemheartbeaticonshouldbeenabled,indicatingcommunicationconnectionwiththatmodule.Thefunctionscreenshouldalsochangetoindicatethenewfunctionsoftheselectedmodule:

Figure26:SelectaroutedMTMmodule,notingtheavailableresourcesofthenewmodule

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page20of22

Exercise5:UsingmultipleMTMModules-AnalogMeasurementofaPowerRailOntheMTMDevelopmentboard,connectawirefromapowerrailtoanavailableanaloginput.Inthisexample,seethebrownjumperwireconnectingA2D2(analoginput)oftheMTM-USBStemtotheRail0outputontheMTM-PM-1programmablepowersupply:

Figure27:A2D2analoginputusedtomeasuretoRail0output

Figure28:ConnectingtoRail0SensepinonMTM-PM-1

EnabletheadjustableRail0outputandKelvinSenseoutputandsettheRail0voltagetoalevelyouwishtomeasure.Wehavechosen2.5Vforthisexample:

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page21of22

Figure29:EnabletheRail0adjustableoutputanditsKelvinSenseoutput

ReturntotheMTM-USBStemmoduleandnotethatA2D2isnowmeasuringthepreviouslysetvoltageenabledonMTM-PM-1Rail0:

Figure30:MeasuringMTM-PM-1Rail0voltageonMTM-USBStemA2D2

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page22of22

Congratulations!YouarenowfullyupandrunningwithMTMinstrumentation!Asanextstep,youcanimplementyourtestplanusingtheBrainStemAPIsanddesignalow-costfixturethatintegratesMTMinstrumentation.Pleaseseeourblog(www.acroname.com/blog)forlatestupdatesandvideotoursofourinstrumentationandothermanufacturingtesttools.Ifyouhaveanyquestions,concernsorcomments,pleasecontactusat:AcronameSales([email protected])orAcronameSupport([email protected])