getting started with brainstem/mtm (2 of 2) - acroname...getting started with brainstem/mtm software...

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: others

Post on 04-May-2021

2 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

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.

Page 2: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

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:

Page 3: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page3of22Acroname,

Figure2:PluginUSBfromhostmachine

WiththehostpluggedintotheMTMmoduleedgeconnector,youshouldnowseetheyellow“USBStatus”LEDlittoindicateanactivehostconnection:

Figure3:HostLEDenabledwhenUSBhostdetected

Page 4: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page4of22Acroname,

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

Figure4:LocationofBrainStemDevelopmentKitDownload

Page 5: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page5of22Acroname,

ExpandtheBDKpackagetoadirectoryofyourchoosing.Inthisexample,wehaveinstalledtheBrainStemDevelopmentKitforMSWindowstothelocalDesktopfolder:

Figure5:BrainStemDevelopmentKit(BDK)foldercontents

Page 6: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page6of22Acroname,

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

Figure6:Windows7DriverInstallationInstructions

Page 7: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page7of22Acroname,

Inthenextstepsofthisguide,wewillbeusingtwoapplications,locatedinthe/binfolder:• Updater

CLI/commandlineinterfacetoolforupdatingandmanagingBrainStemfirmware• StemTool

GUItoolusedforexercisingsimpleMTMmodulefunctionsandtroubleshooting

Figure7:StemToolandUpdaterUtilities

Page 8: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page8of22Acroname,

FirmwareUpdateNowthattheBrainStemdriverisloaded,updatefirmwareontheBrainStem/MTMmodulestothelatestversion.OpenacommandlineinWindows:

Figure8:WindowsCommandLine

NavigatetotheBDKdirectoryandfindthe\binfolderwhereyouwillfindtheupdaterutility:

Figure9:LocationofUpdaterinWindowscommandterminal

Page 9: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page9of22Acroname,

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

Figure10:Updaterutility-Discover

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

Figure11:Updaterutility–Getlatestfirmware,Updatetolatestfirmware

Page 10: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page10of22

Figure12:Successfulfirmwareupdate

Oncetheupdaterutilitysuccessfullyupdatesthemoduleyouareconnectedto,movetheUSBconnectiontothenextmoduleyouwouldliketoupdateandrepeattheupdatercommandsequenceforeachmodule.Inthefuture,withBrainStemnetworkingenabled,youcanupdateallmoduleswithouthavingtomovetheUSBconnection.

Page 11: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page11of22

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

Figure13:LocationofStemToolUtility

Figure14:StemToolUtilitywithMTM-USBStem

Page 12: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page12of22

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

Figure15:ExampleconnectiontotoggleaDigitalIO

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

Figure16:UsingStemTooltochangeMTMDigitalresourceconfiguration

Page 13: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page13of22

TogglingthecheckboxnexttotheD0outputwillchangethelogiclevelonD0.SinceD0isconnectedtoD7,theD7inputlogiclevelwillchangeasindicatedbytheD7checkbox:

Figure17:UsingMTMtochangeandreadanMTMDigitalresourcevalue

Page 14: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page14of22

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

Figure18:Exampleconnectiontomeasurevoltageofadigitaloutput

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

Figure19:UseStemTooltochangeD1configurationtodigitaloutput

Page 15: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page15of22

TheA2D0isnowmeasuringthehighlogiclevelvoltageontheD1digitalpin.ToggletheD1outputvalueboxandyoucanseetheA2D0voltagemeasurementchange:

Figure20:UsingStemTooltoshowanalogvoltagemeasurmentofadigitaloutput

SincetheA2D1andA2D2inputsarenotconnectedtoanysignal,theyarefloatingandtheirmeasurementsindicatethatcase.

Page 16: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

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

Page 17: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page17of22

Figure23:IncreasingA2D3outputvalueandmeasuringatA2D1

Page 18: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

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.

Page 19: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page19of22

WiththeBrainStemnowenabledandroutedthroughtheparentMTM-USBStem,notetheotherwhicharenowMTMmodulesaccessible:

Figure25:MTMmodulesdiscoveredundertheparentmoduleontheBrainStemnetwork

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

Figure26:SelectaroutedMTMmodule,notingtheavailableresourcesofthenewmodule

Page 20: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

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:

Page 21: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

GettingStartedwithBrainStem/MTM SoftwareSetupGuide

Acroname,Inc. Confidential Page21of22

Figure29:EnabletheRail0adjustableoutputanditsKelvinSenseoutput

ReturntotheMTM-USBStemmoduleandnotethatA2D2isnowmeasuringthepreviouslysetvoltageenabledonMTM-PM-1Rail0:

Figure30:MeasuringMTM-PM-1Rail0voltageonMTM-USBStemA2D2

Page 22: Getting Started with BrainStem/MTM (2 of 2) - Acroname...Getting Started with BrainStem/MTM Software Setup Guide Acroname, Inc. Confidential Page 9 of 22 Acroname, From the command

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])