1 Star 0 Fork 0

kontais/cortex-debug

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
package.json 190.88 KB
一键复制 编辑 原始数据 按行查看 历史
Haneef Mohammed 提交于 2023-09-29 03:05 . 1.12.2-pre
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038
{
"version": "1.12.2-pre",
"preview": false,
"activationEvents": [
"onDebugResolve:cortex-debug",
"onStartupFinished"
],
"categories": [
"Debuggers"
],
"contributes": {
"configuration": [
{
"type": "object",
"title": "Debugger",
"properties": {
"cortex-debug.variableUseNaturalFormat": {
"type": "boolean",
"default": true,
"description": "If true, display variables in their natural format as specified by ARM. Hex otherwise."
},
"cortex-debug.liveWatchRefreshRate": {
"default": "300",
"description": "GUI refresh frequency in milliseconds. Your sample rate can be much faster than refresh rate. VSCode UI cannot handle high refresh rates and your Live Watch window will look frozen. Do not recommend below 250ms as it will not be legible anyways. Anything below 200ms did not work at all for us",
"type": "number",
"multipleOf": 1,
"minimum": 100,
"maximum": 5000
}
}
},
{
"type": "object",
"title": "External: GNU Tools",
"properties": {
"cortex-debug.armToolchainPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the GCC Arm Toolchain (standard prefix is \"arm-none-eabi\" - can be set through the armToolchainPrefix setting) to use. If not set the tools must be on the system path. Do not include the executable file name in this path."
},
"cortex-debug.armToolchainPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the GCC Arm Toolchain (standard prefix is \"arm-none-eabi\" - can be set through the armToolchainPrefix setting) to use. If not set the tools must be on the system path. Do not include the executable file name in this path."
},
"cortex-debug.armToolchainPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the GCC Arm Toolchain (standard prefix is \"arm-none-eabi\" - can be set through the armToolchainPrefix setting) to use. If not set the tools must be on the system path. Do not include the executable file name in this path."
},
"cortex-debug.armToolchainPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the GCC Arm Toolchain (standard prefix is \"arm-none-eabi\" - can be set through the armToolchainPrefix setting) to use. If not set the tools must be on the system path. Do not include the executable file name in this path."
},
"cortex-debug.armToolchainPrefix": {
"type": [
"string",
"null"
],
"default": "arm-none-eabi",
"description": "The prefix to use for the arm toolchain - the standard release from arm uses \"arm-none-eabi\" but alternative toolchains may use a different prefix. Currently the gdb, objdump and nm tools are needed."
},
"cortex-debug.gdbPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the GDB executable. This is useful for cases where your gdb executable doesn't follow the standard <tuple>-gdb format - for example `gdb-multiarch`. This can be just the executable name (if on the system path) or the full path."
},
"cortex-debug.gdbPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the GDB executable. This is useful for cases where your gdb executable doesn't follow the standard <tuple>-gdb format - for example `gdb-multiarch`. This can be just the executable name (if on the system path) or the full path."
},
"cortex-debug.gdbPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the GDB executable. This is useful for cases where your gdb executable doesn't follow the standard <tuple>-gdb format - for example `gdb-multiarch`. This can be just the executable name (if on the system path) or the full path."
},
"cortex-debug.gdbPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the GDB executable. This is useful for cases where your gdb executable doesn't follow the standard <tuple>-gdb format - for example `gdb-multiarch`. This can be just the executable name (if on the system path) or the full path."
},
"cortex-debug.objdumpPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the objdump executable. This is useful for cases where your objdump executable doesn't follow the standard <tuple>-objdump format - for example `objdump-multiarch`. This can be just the executable name (if on the system path) or the full path. The program 'nm' is also expected alongside"
},
"cortex-debug.objdumpPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the objdump executable. This is useful for cases where your objdump executable doesn't follow the standard <tuple>-objdump format - for example `objdump-multiarch`. This can be just the executable name (if on the system path) or the full path. The program 'nm' is also expected alongside"
},
"cortex-debug.objdumpPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the objdump executable. This is useful for cases where your objdump executable doesn't follow the standard <tuple>-objdump format - for example `objdump-multiarch`. This can be just the executable name (if on the system path) or the full path. The program 'nm' is also expected alongside"
},
"cortex-debug.objdumpPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "This setting allows you to completely override the path/executable for the objdump executable. This is useful for cases where your objdump executable doesn't follow the standard <tuple>-objdump format - for example `objdump-multiarch`. This can be just the executable name (if on the system path) or the full path. The program 'nm' is also expected alongside"
}
}
},
{
"type": "object",
"title": "External: GDB Servers",
"properties": {
"cortex-debug.JLinkGDBServerPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the JLink GDB Server. If not set then JLinkGDBServer (JLinkGDBServerCL.exe on Windows) must be on the system path."
},
"cortex-debug.JLinkGDBServerPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the JLink GDB Server. If not set then JLinkGDBServer (JLinkGDBServerCLExe) must be on the system path."
},
"cortex-debug.JLinkGDBServerPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the JLink GDB Server. If not set then JLinkGDBServer (JLinkGDBServerCLExe) must be on the system path."
},
"cortex-debug.JLinkGDBServerPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the JLink GDB Server. If not set then JLinkGDBServer (JLinkGDBServerCL.exe) must be on the system path."
},
"cortex-debug.openocdPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the OpenOCD GDB Server executable. If not set then openocd (openocd.exe on Windows) must be on the system path."
},
"cortex-debug.openocdPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the OpenOCD GDB Server executable. If not set then openocd (openocd.exe on Windows) must be on the system path."
},
"cortex-debug.openocdPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the OpenOCD GDB Server executable. If not set then openocd (openocd.exe on Windows) must be on the system path."
},
"cortex-debug.openocdPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the OpenOCD GDB Server executable. If not set then openocd (openocd.exe on Windows) must be on the system path."
},
"cortex-debug.pyocdPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PyOCD GDB Server executable. If not set then pyocd-gdbserver must be on the system path."
},
"cortex-debug.pyocdPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PyOCD GDB Server executable. If not set then pyocd-gdbserver must be on the system path."
},
"cortex-debug.pyocdPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PyOCD GDB Server executable. If not set then pyocd-gdbserver must be on the system path."
},
"cortex-debug.pyocdPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PyOCD GDB Server executable. If not set then pyocd-gdbserver must be on the system path."
},
"cortex-debug.PEGDBServerPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PEMicro GDB Server. If not set then PEGDBServer (pegdbserver_console.exe on Windows) must be on the system path."
},
"cortex-debug.PEGDBServerPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PEMicro GDB Server. If not set then PEGDBServer (pegdbserver_console.exe on Windows) must be on the system path."
},
"cortex-debug.PEGDBServerPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PEMicro GDB Server. If not set then PEGDBServer (pegdbserver_console.exe on Windows) must be on the system path."
},
"cortex-debug.PEGDBServerPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the PEMicro GDB Server. If not set then PEGDBServer (pegdbserver_console.exe on Windows) must be on the system path."
},
"cortex-debug.stutilPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the Texane's ST-Util GDB Server executable. If not set then st-util (st-util.exe on Windows) must be on the system path."
},
"cortex-debug.stutilPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the Texane's ST-Util GDB Server executable. If not set then st-util (st-util.exe on Windows) must be on the system path."
},
"cortex-debug.stutilPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the Texane's ST-Util GDB Server executable. If not set then st-util (st-util.exe on Windows) must be on the system path."
},
"cortex-debug.stutilPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the Texane's ST-Util GDB Server executable. If not set then st-util (st-util.exe on Windows) must be on the system path."
},
"cortex-debug.stlinkPath": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the ST-LINK_gdbserver executable. If not set then ST-LINK_gdbserver (ST-LINK_gdbserver.exe on Windows) must be on the system path."
},
"cortex-debug.stlinkPath.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the ST-LINK_gdbserver executable. If not set then ST-LINK_gdbserver (ST-LINK_gdbserver.exe on Windows) must be on the system path."
},
"cortex-debug.stlinkPath.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the ST-LINK_gdbserver executable. If not set then ST-LINK_gdbserver (ST-LINK_gdbserver.exe on Windows) must be on the system path."
},
"cortex-debug.stlinkPath.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "Path to the ST-LINK_gdbserver executable. If not set then ST-LINK_gdbserver (ST-LINK_gdbserver.exe on Windows) must be on the system path."
},
"cortex-debug.stm32cubeprogrammer": {
"type": [
"string",
"null"
],
"default": null,
"description": "This path is normally resolved to the installed STM32CubeIDE or STM32CubeProgrammer but can be overridden here."
},
"cortex-debug.stm32cubeprogrammer.linux": {
"type": [
"string",
"null"
],
"default": null,
"description": "This path is normally resolved to the installed STM32CubeIDE or STM32CubeProgrammer but can be overridden here."
},
"cortex-debug.stm32cubeprogrammer.osx": {
"type": [
"string",
"null"
],
"default": null,
"description": "This path is normally resolved to the installed STM32CubeIDE or STM32CubeProgrammer but can be overridden here."
},
"cortex-debug.stm32cubeprogrammer.windows": {
"type": [
"string",
"null"
],
"default": null,
"description": "This path is normally resolved to the installed STM32CubeIDE or STM32CubeProgrammer but can be overridden here."
}
}
},
{
"type": "object",
"title": "Miscellaneous",
"properties": {
"cortex-debug.enableTelemetry": {
"type": "boolean",
"default": true,
"description": "Enable Telemetry for the Cortex-Debug Extension. Reporting will also respect the global telemetry.enableTelemetry setting."
},
"cortex-debug.dbgServerLogfile": {
"type": [
"string",
"null"
],
"default": null,
"description": "Logs the contents of the gdb-server terminal. Use ${PID} in the file name to make it unique per VSCode session"
}
}
}
],
"commands": [
{
"command": "cortex-debug.resetDevice",
"title": "Reset device",
"icon": {
"dark": "images/reset-dark.svg",
"light": "images/reset-light.svg"
}
},
{
"command": "cortex-debug.varHexModeTurnOff",
"title": "Disable Hex mode",
"icon": {
"light": "images/hex-on-light.svg",
"dark": "images/hex-on-dark.svg"
}
},
{
"command": "cortex-debug.varHexModeTurnOn",
"title": "Enable Hex mode",
"icon": {
"light": "images/hex-off-light.svg",
"dark": "images/hex-off-dark.svg"
}
},
{
"command": "cortex-debug.liveWatch.removeExpr",
"title": "Remove expression",
"icon": "$(close)"
},
{
"command": "cortex-debug.liveWatch.editExpr",
"title": "Edit expression",
"icon": "$(edit)"
},
{
"command": "cortex-debug.liveWatch.moveUp",
"title": "Move expression up",
"icon": "$(arrow-up)"
},
{
"command": "cortex-debug.liveWatch.moveDown",
"title": "Move expression down",
"icon": "$(arrow-down)"
},
{
"command": "cortex-debug.liveWatch.addToLiveWatch",
"title": "Add to Live Watch",
"icon": "$(plus)"
},
{
"category": "Cortex-Debug",
"command": "cortex-debug.examineMemory",
"title": "View Memory"
},
{
"category": "Cortex-Debug",
"command": "cortex-debug.examineMemoryLegacy",
"title": "View Memory (Legacy)"
},
{
"category": "Cortex-Debug",
"command": "cortex-debug.toggleVariableHexFormat",
"title": "Toggle hex display in Variables window"
},
{
"category": "Cortex-Debug",
"command": "cortex-debug.liveWatch.addExpr",
"title": "Add expression to Live Watch window",
"icon": "$(plus)"
}
],
"keybindings": [
{
"command": "cortex-debug.toggleVariableHexFormat",
"key": "ctrl+shift+x",
"when": "debugType == cortex-debug"
}
],
"languages": [
{
"id": "cortex-debug.memoryview",
"aliases": [
"Cortex-Debug Memory View"
],
"extensions": [
".cdmem"
]
}
],
"grammars": [
{
"language": "cortex-debug.memoryview",
"scopeName": "source.cortex-debug-memoryview",
"path": "./syntaxes/cortex-debug-memoryview.json"
}
],
"breakpoints": [
{
"language": "c"
},
{
"language": "cpp"
},
{
"language": "rust"
},
{
"language": "arm"
},
{
"language": "asm"
},
{
"language": "S"
},
{
"language": "s"
},
{
"language": "cortex-debug.disassembly"
}
],
"debuggers": [
{
"configurationAttributes": {
"attach": {
"properties": {
"servertype": {
"type": "string",
"description": "GDB Server type - supported types are jlink, openocd, pyocd, pe, stlink, stutil, qemu, bmp and external. For \"external\", [please read our Wiki](https://github.com/Marus/cortex-debug/wiki/External-gdb-server-configuration)",
"enum": [
"jlink",
"openocd",
"pyocd",
"stutil",
"stlink",
"bmp",
"pe",
"qemu",
"external"
]
},
"cwd": {
"description": "Directory to run commands from",
"type": "string"
},
"debuggerArgs": {
"default": [],
"description": "Additional arguments to pass to GDB command line",
"type": "array",
"items": "string"
},
"preAttachCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the start of the main attach sequence (immediately after attaching to target)."
},
"postAttachCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed after the main attach sequence has finished."
},
"preRestartCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the beginning of the restart sequence (after interrupting execution)."
},
"postRestartCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the restart sequence."
},
"preResetCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the beginning of the reset sequence (after interrupting execution). When not defined this will have the same value of preRestartCommands."
},
"postResetCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the reset sequence. When not defined this will have the same value of postRestartCommands."
},
"overrideAttachCommands": {
"default": null,
"type": "array",
"items": "string",
"description": "You can use this to property to override the commands that are normally executed as part of attaching to a running target. In most cases it is preferable to use preAttachCommands and postAttachCommands to customize the GDB attach sequence."
},
"overrideRestartCommands": {
"default": null,
"type": "array",
"items": "string",
"description": "You can use this to property to override the commands that are normally executed as part of restarting the target. In most cases it is preferable to use preRestartCommands and postRestartCommands to customize the GDB restart sequence."
},
"overrideResetCommands": {
"default": null,
"type": "array",
"items": "string",
"description": "You can use this to property to override the commands that are normally executed as part of reset the target. When not defined this will have the same value of overrideRestartCommands. In most cases it is preferable to use preResetCommands and postResetCommands to customize the GDB reset sequence."
},
"postStartSessionCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the start sequence, after a debug session has already started and runToEntryPoint is not specified."
},
"postRestartSessionCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the re-start sequence, after a debug session has already started."
},
"overrideGDBServerStartedRegex": {
"description": "You can supply a regular expression (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) in the configuration property to override the output from the GDB Server that is looked for to determine if the GDB Server has started. Under most circumstances this will not be necessary - but could be needed as a result of a change in the output of a GDB Server making it incompatible with cortex-debug. This property has no effect for bmp or external GDB Server types.",
"type": "string",
"default": null
},
"cpu": {
"default": "cortex-m3",
"type": "string",
"description": "CPU Type Selection - used for QEMU server type",
"enum": [
"cortex-m3",
"cortex-m4"
]
},
"machine": {
"default": "lm3s811evb",
"type": "string",
"description": "Machine Type Selection - used for QEMU server type",
"enum": [
"lm3s811evb",
"lm3s6965evb",
"mps2-an385"
]
},
"device": {
"default": "",
"description": "Target Device Identifier",
"type": "string"
},
"rtos": {
"default": null,
"description": "RTOS being used. For JLink this can be Azure, ChibiOS, embOS, FreeRTOS, NuttX, Zephyr or the path to a custom JLink RTOS Plugin library. For OpenOCD this can be auto (recommended), FreeRTOS, ThreadX, chibios, Chromium-EC, eCos, embKernel, linux, mqx, nuttx, RIOT, uCOS-III, or Zephyr.",
"type": "string"
},
"armToolchainPath": {
"default": null,
"description": "This setting can be used to override the armToolchainPath user setting for a particular launch configuration. This should be the path where arm-none-eabi-gdb, arm-none-eabi-objdump and arm-none-eabi-nm are located.",
"type": "string"
},
"toolchainPrefix": {
"default": null,
"description": "This setting can be used to override the toolchainPrefix user setting for a particular launch configuration. Default = \"arm-none-eabi\"",
"type": "string"
},
"serverpath": {
"default": null,
"description": "This setting can be used to override the GDB Server path user/workspace setting for a particular launch configuration. It is the full pathname to the executable or name of executable if it is in your PATH",
"type": "string"
},
"gdbPath": {
"default": null,
"description": "This setting can be used to override the GDB path user/workspace setting for a particular launch configuration. This should be the full pathname to the executable (or name of the executable if it is in your PATH). Note that other toolchain executables with the configured prefix must still be available.",
"type": "string"
},
"objdumpPath": {
"default": null,
"description": "This setting can be used to override the objdump (used to find globals/statics) path user/workspace setting for a particular launch configuration. This should be the full pathname to the executable (or name of the executable if it is in your PATH). Note that other toolchain executables with the configured prefix must still be available. The program 'nm' is also expected alongside",
"type": "string"
},
"serverArgs": {
"default": [],
"description": "Additional arguments to pass to GDB Server command line",
"type": "array",
"items": "string"
},
"executable": {
"description": "Path of executable for symbols and program information. See also `loadFiles`, `symbolFiles`",
"type": "string"
},
"symbolFiles": {
"description": "Array of ELF files to load symbols from instead of the executable file. Each item in the array cab be a string or an object. Program information is ignored (see `loadFiles`). Can be an empty list to specify none. If this property does not exist, then the executable is used for symbols",
"type": "array",
"items": {
"type": ["object", "string"],
"properties": {
"file": {
"type": "string",
"description": "Pathname of an ELF file for symbols"
},
"offset": {
"type": [
"number",
"string"
],
"description": "Optional offset to apply to all sections of the ELF file. Use a string strarting with '0x' for a hexadecimal number"
},
"textaddress": {
"type": [
"number",
"string"
],
"description": "Optional: Load the TEXT section at the specified 'textaddress'. Use a string strarting with '0x' for a hexadecimal number"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Section name"
},
"address": {
"type": [
"number",
"string"
],
"description": "Base address for section. Use a string strarting with '0x' for a hexadecimal number"
}
},
"required": [
"name",
"address"
]
}
}
},
"required": [
"file"
]
},
"default": null
},
"gdbTarget": {
"default": null,
"description": "For externally (servertype = \"external\") controlled GDB Servers you must specify the GDB target to connect to. This can either be a \"hostname:port\" combination or path to a serial port",
"type": "string"
},
"breakAfterReset": {
"default": false,
"type": "boolean",
"description": "Applies to Restart/Reset/Launch, halt debugger after a reset. Ignored if `runToEntryPoint` is used."
},
"runToEntryPoint": {
"description": "Applies to Launch/Restart/Reset, ignored for Attach. If enabled the debugger will run until the start of the given function.",
"type": "string",
"default": "main"
},
"numberOfProcessors": {
"description": "Number of processors/cores in the target device.",
"type": "number",
"multipleOf": 1,
"minimum": 1,
"maximum": 10,
"default": 1
},
"targetProcessor": {
"description": "The processor you want to debug. Zero based integer index. Must be less than 'numberOfProcessors'",
"type": "number",
"multipleOf": 1,
"minimum": 0,
"maximum": 9,
"default": 0
},
"liveWatch": {
"description": "An object with parameters for Live Watch",
"properties": {
"enabled": {
"default": false,
"description": "Enable/Disable Live Watch. Only applies to OpenOCD",
"type": "boolean"
},
"samplesPerSecond": {
"default": 2,
"description": "Maximum number of samples per second. Different from GUI refresh-rate, which is a user/workspace setting",
"type": "number",
"multipleOf": 1,
"minimum": 0,
"maximum": 20
}
},
"default": {
"enabled": true,
"samplesPerSecond": 4
}
},
"chainedConfigurations": {
"description": "An object describing how additional configurations should be launched",
"properties": {
"enabled": {
"default": true,
"description": "Enable/Disable entire set of chained configurations",
"type": "boolean"
},
"detached": {
"default": false,
"description": "Related or independent server sessions. Set to true for servers like 'JLink'. Inherited by children",
"type": "boolean"
},
"lifecycleManagedByParent": {
"default": true,
"description": "Are Restart/Reset/Stop/Disconnect shared? All life-cycle management done as a group by parent/root. Inherited by children",
"type": "boolean"
},
"waitOnEvent": {
"enum": [
"postStart",
"postInit"
],
"default": "postInit",
"description": "Event to wait for. 'postStart' means wait for gdb-server connecting, 'postInit' is after init commands are completed by gdb. Inherited by children",
"type": "string"
},
"delayMs": {
"type": "number",
"description": "Default delay in milliseconds for a certain amount of milliseconds to begin launch. Inherited by children",
"multipleOf": 1,
"minimum": 0,
"default": 5
},
"overrides": {
"default": {},
"description": "Values to override/set in this child configuration. A set of name/value pairs. Set value to 'null' (no quotes) to delete. Sorry, no IntelliSense",
"type": "object"
},
"inherits": {
"default": [],
"description": "List of properties to inherit from parent. This is processed before any overrides. Sorry, no IntelliSense",
"type": "array",
"items": {
"type": "string"
}
},
"launches": {
"type": "array",
"items": {
"properties": {
"name": {
"default": "",
"description": "Name of launch configuration. Sorry, no IntelliSense",
"type": "string"
},
"folder": {
"default": "",
"description": "Folder to use for this configuration. Where .vscode/launch.json exists. Default is same folder as parent. Use either the full path name or the base-name of the folder",
"type": "string"
},
"enabled": {
"default": true,
"description": "Enable/Disable this configuration",
"type": "boolean"
},
"detached": {
"default": false,
"description": "Related or independent server sessions. Set to true for servers like 'JLink'",
"type": "boolean"
},
"waitOnEvent": {
"enum": [
"postStart",
"postInit"
],
"default": "postInit",
"description": "Wait for an event. 'postStart' means wait for gdb-server connecting, 'postInit' is after init commands are completed by gdb",
"type": "string"
},
"delayMs": {
"type": "number",
"description": "Delay in milliseconds for a certain amount of milliseconds to begin launch",
"multipleOf": 1,
"minimum": 0,
"default": 5
},
"lifecycleManagedByParent": {
"default": true,
"description": "Are Restart/Reset/Stop/Disconnect shared? All life-cycle management done as a group by parent/root",
"type": "boolean"
},
"overrides": {
"default": {},
"description": "Values to override/set in this child configuration. A set of name/value pairs. Set value to 'null' (no quotes) to delete. Sorry, no IntelliSense",
"type": "object"
},
"inherits": {
"default": [],
"description": "List of properties to inherit from parent. This is processed before any overrides. Sorry, no IntelliSense",
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
},
"default": {
"enabled": true,
"waitOnEvent": "postInit",
"lifeCycleShared": true,
"launches": [
{
"name": "use EXACT name of chained configuration to launch",
"folder": "use full path or folder basename or leave empty"
}
]
}
},
"graphConfig": {
"description": "Description of how graphing can be done. See our Wiki for details",
"items": {
"oneOf": [
{
"properties": {
"annotate": {
"default": true,
"description": "Create annotations on the graph for when the target processor starts and stops execution. (green line for starting execution, red line for stopping execution).",
"type": "boolean"
},
"label": {
"description": "Label for Graph",
"type": "string"
},
"maximum": {
"default": 65535,
"description": "Maximum value for the X-Axis",
"type": "number"
},
"minimum": {
"default": 0,
"description": "Minimum value for the Y-Axis",
"type": "number"
},
"plots": {
"description": "Plot configurations. Data sources must be configured for \"graph\" (or \"advanced\" with a decoder that sends graph data) in the \"swoConfig\" section",
"items": {
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{3}([0-9a-fA-F]{3})?$",
"type": "string"
},
"graphId": {
"description": "Graph Data Source Id for the plot.",
"type": "string"
},
"label": {
"description": "A label for this data set",
"type": "string"
}
},
"required": [
"graphId"
],
"type": "object"
},
"type": "array"
},
"timespan": {
"default": 30,
"description": "Length of time (seconds) to be plotted on screen.",
"type": "number"
},
"type": {
"enum": [
"realtime"
],
"type": "string"
}
},
"required": [
"label",
"plots",
"minimum",
"maximum"
],
"type": "object"
},
{
"properties": {
"label": {
"description": "Label for graph",
"type": "string"
},
"timespan": {
"default": 10,
"description": "The amount of time (seconds) that the XY Plot will show the trace for.",
"type": "number"
},
"type": {
"enum": [
"x-y-plot"
],
"type": "string"
},
"xGraphId": {
"description": "Graph Data Source Id for the X axis",
"type": "string"
},
"xMaximum": {
"default": 65535,
"description": "Maximum value on the X-Axis",
"type": "number"
},
"xMinimum": {
"default": 0,
"description": "Minimum value on the X-Axis",
"type": "number"
},
"yGraphId": {
"description": "Graph Data Source Id Port for the Y axis",
"type": "string"
},
"yMaximum": {
"default": 65535,
"description": "Maximum value on the Y-Axis",
"type": "number"
},
"yMinimum": {
"default": 0,
"description": "Minimum value on the Y-Axis",
"type": "number"
}
},
"required": [
"xGraphId",
"yGraphId",
"label"
],
"type": "object"
}
]
},
"type": "array"
},
"showDevDebugOutput": {
"enum": [
"none",
"parsed",
"raw",
"both",
"vscode"
],
"default": "none",
"description": "Used to debug this extension. Prints all GDB responses to the console. 'raw' prints gdb responses, 'parsed' prints results after parsing, 'both' prints both. 'vscode' shows raw and VSCode interactions",
"type": "string"
},
"showDevDebugTimestamps": {
"default": false,
"description": "Show timestamps when 'showDevDebugOutput' is enabled",
"type": "boolean"
},
"svdFile": {
"default": null,
"description": "This is for 'XPERIPHERALS' window provided by 'mcu-debug.peripheral-viewer'. It can be a simple file name or more based on a CMSIS pack or deviceName. See 'mcu-debug.peripheral-viewer' for format",
"type": "string"
},
"svdPath": {
"default": null,
"description": "This is for 'XPERIPHERALS' window provided by 'mcu-debug.peripheral-viewer' and 'Embedded Tools' Extension from Microsoft. It can be a simple file name. For 'mcu-debug.peripheral-viewer' or more based on a CMSIS pack or deviceName. See 'mcu-debug.peripheral-viewer' for format",
"type": "string"
},
"rttConfig": {
"type": "object",
"description": "SEGGER's Real Time Trace (RTT) and supported by JLink, OpenOCD and perhaps others in the future",
"default": {
"enabled": true,
"address": "auto",
"decoders": [
{
"label": "",
"port": 0,
"type": "console"
}
]
},
"properties": {
"enabled": {
"type": "boolean",
"description": "Enable/Disable RTT",
"default": false
},
"address": {
"type": "string",
"description": "Address to start searching for the RTT control block. Use \"auto\" for Cortex-Debug to use the address from elf file",
"default": "auto"
},
"searchSize": {
"type": "number",
"description": "Number of bytes to search for the RTT control block. If 'address' is 'auto', use ONLY if you have a custom RTT implementation",
"multipleOf": 1,
"minimum": 16,
"default": 16
},
"searchId": {
"type": "string",
"description": "A string to search for to find the RTT control block. If 'address' is 'auto', use ONLY if you have a custom RTT implementation",
"default": "SEGGER RTT"
},
"polling_interval": {
"type": "number",
"description": "number of milliseconds (> 0) to wait for check for data on out channels. Only for OpenOCD",
"default": 0,
"minimum": 1
},
"rtt_start_retry": {
"type": "number",
"description": "Keep trying to start RTT for OpenOCD until it succeeds with given internal in milliseconds. <= 0 means do not retry. Only for OpenOCD",
"default": 1000,
"minimum": 0
},
"clearSearch": {
"type": "boolean",
"description": "When true, clears the search-string. Only applicable when address is \"auto\"",
"default": true
},
"decoders": {
"description": "SWO Decoder Configuration",
"items": {
"anyOf": [
{
"properties": {
"label": {
"description": "A label for RTT Console",
"type": "string"
},
"port": {
"description": "RTT Channel Number (0 to 15)",
"default": 0,
"maximum": 15,
"minimum": 0,
"multipleOf": 1,
"type": "number"
},
"type": {
"enum": [
"console",
"binary"
],
"default": "console",
"description": "'console' with text input/output, 'binary' is for converting byte stream to other data types",
"type": "string"
},
"prompt": {
"description": "Prompt to use for RTT Console",
"type": "string",
"default": ""
},
"noprompt": {
"description": "Don't use a prompt for RTT Console",
"type": "boolean",
"default": false
},
"noclear": {
"description": "append to screen/logfile when another connection is made",
"type": "boolean",
"default": false
},
"logfile": {
"description": "log all raw data (input and output) to specified file",
"type": "string",
"default": ""
},
"timestamp": {
"description": "Add timestamps while printing for 'console' type. 'binary' type always prints timestamps",
"type": "boolean",
"default": false
},
"encoding": {
"type": "string",
"description": "How binary data bytes are converted into a number. All little-endian",
"default": "unsigned",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
]
},
"iencoding": {
"type": "string",
"description": "How keyboard input is encoded. Cooked mode only",
"default": "utf8",
"enum": [
"ascii",
"utf8",
"ucs2",
"utf16le"
]
},
"scale": {
"default": 1,
"description": "Binary only: This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"inputmode": {
"type": "string",
"description": "Experimental: 'disabled' means no stdin. 'raw' and 'rawecho' sends chars as they are typed.\n'rawecho' will echo chars and process RETURN keys. Even CTRL-C CTRL-D are passed on",
"default": "cooked",
"enum": [
"cooked",
"raw",
"rawecho",
"disabled"
]
}
},
"required": [
"port"
],
"type": "object"
},
{
"properties": {
"encoding": {
"default": "unsigned",
"description": "This property is only used for binary and graph output formats.",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
],
"type": "string"
},
"graphId": {
"description": "The identifier to use for this data in graph configurations.",
"type": "string"
},
"port": {
"description": "RTT Channel Number",
"maximum": 15,
"minimum": 0,
"type": "number"
},
"scale": {
"default": 1,
"description": "This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"type": {
"enum": [
"graph"
],
"type": "string"
}
},
"required": [
"port",
"graphId"
],
"type": "object"
},
{
"properties": {
"config": {
"additionalProperties": true,
"type": "object"
},
"decoder": {
"description": "Path to a javascript module to implement the decoding functionality.",
"type": "string"
},
"ports": {
"description": "RTT Channel Numbers",
"type": "array",
"items": {
"type": "number",
"maximum": 15,
"minimum": 0
}
},
"type": {
"enum": [
"advanced"
],
"type": "string"
}
},
"required": [
"ports",
"decoder"
],
"type": "object"
}
]
},
"type": "array"
}
}
},
"swoConfig": {
"description": "Description of SWO can be configured. Also see our Wiki for details",
"properties": {
"cpuFrequency": {
"default": 0,
"description": "Target CPU frequency in Hz; 0 will attempt to automatically calculate.",
"type": "number"
},
"enabled": {
"default": false,
"description": "Enable SWO decoding.",
"type": "boolean"
},
"source": {
"type": "string",
"enum": [
"probe",
"socket",
"serial",
"file"
],
"default": "probe",
"description": "Source for SWO data. Can either be \"probe\" to get directly from debug probe, or a serial port device to use a serial port external to the debug probe."
},
"swoPath": {
"type": "string",
"default": "",
"description": "Path name when source is \"file\" or \"serial\". Typically a /path-name or a serial-port-name"
},
"swoPort": {
"type": "string",
"default": "",
"description": "When server is \"external\" && source is \"socket\", port to connect to. Format [host:]port"
},
"decoders": {
"description": "SWO Decoder Configuration",
"items": {
"anyOf": [
{
"properties": {
"label": {
"description": "A label for the output window.",
"type": "string"
},
"port": {
"description": "ITM Port Number",
"maximum": 31,
"minimum": 0,
"type": "number"
},
"showOnStartup": {
"description": "If true, switches to this output when starting a debug session.",
"type": "boolean"
},
"timestamp": {
"description": "Add timestamps while printing",
"type": "boolean",
"default": false
},
"type": {
"enum": [
"console"
],
"type": "string"
},
"encoding": {
"type": "string",
"default": "utf8",
"enum": [
"ascii",
"utf8",
"ucs2",
"utf16le"
]
},
"logfile": {
"description": "log all raw data to specified file",
"type": "string",
"default": ""
}
},
"required": [
"port"
],
"type": "object"
},
{
"properties": {
"encoding": {
"default": "unsigned",
"description": "This property is only used for binary and graph output formats.",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
],
"type": "string"
},
"label": {
"description": "A label for the output window.",
"type": "string"
},
"port": {
"description": "ITM Port Number",
"maximum": 31,
"minimum": 0,
"type": "number"
},
"scale": {
"default": 1,
"description": "This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"type": {
"enum": [
"binary"
],
"type": "string"
},
"logfile": {
"description": "log all raw data to specified file",
"type": "string",
"default": ""
}
},
"required": [
"port"
],
"type": "object"
},
{
"properties": {
"encoding": {
"default": "unsigned",
"description": "This property is only used for binary and graph output formats.",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
],
"type": "string"
},
"graphId": {
"description": "The identifier to use for this data in graph configurations.",
"type": "string"
},
"port": {
"description": "ITM Port Number",
"maximum": 31,
"minimum": 0,
"type": "number"
},
"scale": {
"default": 1,
"description": "This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"type": {
"enum": [
"graph"
],
"type": "string"
},
"logfile": {
"description": "log all raw data to specified file",
"type": "string",
"default": ""
}
},
"required": [
"port",
"graphId"
],
"type": "object"
},
{
"properties": {
"config": {
"additionalProperties": true,
"type": "object"
},
"decoder": {
"description": "Path to a javascript module to implement the decoding functionality.",
"type": "string"
},
"ports": {
"description": "ITM Port Numbers",
"type": "array",
"items": {
"maximum": 31,
"minimum": 0,
"type": "number"
}
},
"type": {
"enum": [
"advanced"
],
"type": "string"
}
},
"required": [
"ports",
"decoder"
],
"type": "object"
}
]
},
"type": "array"
},
"swoFrequency": {
"default": 0,
"description": "SWO frequency in Hz; 0 will attempt to automatically calculate.",
"type": "number"
}
},
"required": [],
"type": "object"
},
"ipAddress": {
"default": null,
"description": "IP Address for networked J-Link Adapter",
"pattern": "^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])$",
"type": "string"
},
"serialNumber": {
"default": null,
"description": "J-Link or ST-LINK Serial Number - only needed if multiple J-Links/ST-LINKs are connected to the computer",
"type": "string"
},
"interface": {
"default": "swd",
"description": "Debug Interface type to use for connections (defaults to SWD) - Used for J-Link, ST-LINK and BMP probes.",
"type": "string",
"enum": [
"swd",
"jtag",
"cjtag"
]
},
"jlinkscript": {
"default": null,
"description": "J-Link script file - optional input file for customizing J-Link actions.",
"type": "string"
},
"openOCDLaunchCommands": {
"default": [],
"description": "OpenOCD command(s) after configuration files are loaded (-c options)",
"items": {
"type": "string"
},
"type": "array"
},
"openOCDPreConfigLaunchCommands": {
"default": [],
"description": "OpenOCD command(s) before configuration files are loaded (-c options)",
"items": {
"type": "string"
},
"type": "array"
},
"configFiles": {
"description": "OpenOCD/PE GDB Server configuration file(s) to use when debugging (OpenOCD -f option)",
"items": {
"type": "string"
},
"type": "array"
},
"searchDir": {
"default": [],
"description": "OpenOCD directories to search for config files and scripts (-s option). If no search directories are specified, it defaults to the configured cwd.",
"items": {
"type": "string"
},
"type": "array"
},
"v1": {
"default": false,
"description": "For st-util only. Set this to true if your debug probe is a ST-Link V1 (for example, the ST-Link on the STM32 VL Discovery is a V1 device). When set to false a ST-Link V2 device is used.",
"type": "boolean"
},
"stlinkPath": {
"default": null,
"description": "Path to the ST-LINK_gdbserver executable. If not set then ST-LINK_gdbserver (ST-LINK_gdbserver.exe on Windows) must be on the system path.",
"type": "string"
},
"stm32cubeprogrammer": {
"default": null,
"description": "This path is normally resolved to the installed STM32CubeIDE or STM32CubeProgrammer but can be overridden here.",
"type": "string"
},
"targetId": {
"description": "On BMP this is the ID number that should be passed to the attach command (defaults to 1); for PyOCD this is the target identifier (only needed for custom hardware)",
"type": ["string", "number"],
"anyOf": [
{
"type": "string"
},
{
"type": "number",
"minimum": 1
}
]
},
"boardId": {
"description": "PyOCD Board Identifier. Needed if multiple compatible boards are connected.",
"type": "string"
},
"cmsisPack": {
"description": "Path to a CMSIS-Pack file. Use to add extra device support.",
"type": "string"
},
"BMPGDBSerialPort": {
"type": "string",
"description": "The serial port for the Black Magic Probe GDB Server. On Windows this will be \"COM<num>\", on Linux this will be something similar to /dev/ttyACM0, on OS X something like /dev/cu.usbmodemE2C0C4C6 (do not use tty versions on OS X)"
},
"powerOverBMP": {
"type": "string",
"description": "Power up the board over Black Magic Probe. \"powerOverBMP\" : \"enable\" or \"powerOverBMP\" : \"disable\". If not set it will use the last power state."
}
},
"required": [
"executable"
]
},
"launch": {
"properties": {
"servertype": {
"type": "string",
"description": "GDB Server type - supported types are jlink, openocd, pyocd, pe, stlink, stutil, qemu, bmp and external. For \"external\", [please read our Wiki](https://github.com/Marus/cortex-debug/wiki/External-gdb-server-configuration)",
"enum": [
"jlink",
"openocd",
"pyocd",
"stutil",
"stlink",
"bmp",
"pe",
"qemu",
"external"
]
},
"cwd": {
"description": "Directory to run commands from",
"type": "string"
},
"debuggerArgs": {
"default": [],
"description": "Additional arguments to pass to GDB command line",
"type": "array"
},
"preLaunchCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the start of the main launch sequence (immediately after attaching to target)."
},
"postLaunchCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed after the main launch sequence has finished."
},
"preRestartCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the beginning of the restart sequence (after interrupting execution)."
},
"postRestartCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the restart sequence."
},
"preResetCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the beginning of the reset sequence (after interrupting execution). When not defined this will have the same value of preRestartCommands."
},
"postResetCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the reset sequence. When not defined this will have the same value of postRestartCommands."
},
"overrideLaunchCommands": {
"default": null,
"type": "array",
"items": "string",
"description": "You can use this to property to override the commands that are normally executed as part of flashing and launching the target. In most cases it is preferable to use preLaunchCommands and postLaunchCommands to customize the GDB launch sequence."
},
"overrideRestartCommands": {
"default": null,
"type": "array",
"items": "string",
"description": "You can use this to property to override the commands that are normally executed as part of restarting the target. In most cases it is preferable to use preRestartCommands and postRestartCommands to customize the GDB restart sequence."
},
"overrideResetCommands": {
"default": null,
"type": "array",
"items": "string",
"description": "You can use this to property to override the commands that are normally executed as part of reset the target. When not defined this will have the same value of overrideRestartCommands. In most cases it is preferable to use preResetCommands and postResetCommands to customize the GDB reset sequence."
},
"postStartSessionCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the start sequence, after a debug session has already started and runToEntryPoint is not specified."
},
"postRestartSessionCommands": {
"default": [],
"type": "array",
"items": "string",
"description": "Additional GDB Commands to be executed at the end of the re-start sequence, after a debug session has already started."
},
"overrideGDBServerStartedRegex": {
"description": "You can supply a regular expression (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) in the configuration property to override the output from the GDB Server that is looked for to determine if the GDB Server has started. Under most circumstances this will not be necessary - but could be needed as a result of a change in the output of a GDB Server making it incompatible with cortex-debug. This property has no effect for bmp or external GDB Server types.",
"type": "string",
"default": null
},
"cpu": {
"default": "cortex-m3",
"type": "string",
"description": "CPU Type Selection - used for QEMU server type",
"enum": [
"cortex-m3",
"cortex-m4"
]
},
"machine": {
"default": "lm3s811evb",
"type": "string",
"description": "Machine Type Selection - used for QEMU server type",
"enum": [
"lm3s811evb",
"lm3s6965evb"
]
},
"device": {
"default": "",
"description": "Target Device Identifier",
"type": "string"
},
"rtos": {
"default": null,
"description": "RTOS being used. For JLink this can be Azure, ChibiOS, embOS, FreeRTOS, NuttX, Zephyr or the path to a custom JLink RTOS Plugin library. For OpenOCD this can be auto (recommended), FreeRTOS, ThreadX, chibios, Chromium-EC, eCos, embKernel, linux, mqx, nuttx, RIOT, uCOS-III, or Zephyr.",
"type": "string"
},
"armToolchainPath": {
"default": null,
"description": "This setting can be used to override the armToolchainPath user setting for a particular launch configuration. This should be the path where arm-none-eabi-gdb, arm-none-eabi-objdump and arm-none-eabi-nm are located.",
"type": "string"
},
"toolchainPrefix": {
"default": null,
"description": "This setting can be used to override the toolchainPrefix user setting for a particular launch configuration. Default = \"arm-none-eabi\"",
"type": "string"
},
"serverpath": {
"default": null,
"description": "This setting can be used to override the GDB Server path user/workspace setting for a particular launch configuration. It is the full pathname to the executable or name of executable if it is in your PATH",
"type": "string"
},
"gdbPath": {
"default": null,
"description": "This setting can be used to override the GDB path user/workspace setting for a particular launch configuration. This should be the full pathname to the executable (or name of the executable if it is in your PATH). Note that other toolchain executables with the configured prefix must still be available.",
"type": "string"
},
"objdumpPath": {
"default": null,
"description": "This setting can be used to override the objdump (used to find globals/statics) path user/workspace setting for a particular launch configuration. This should be the full pathname to the executable (or name of the executable if it is in your PATH). Note that other toolchain executables with the configured prefix must still be available. The program 'nm' is also expected alongside",
"type": "string"
},
"serverArgs": {
"default": [],
"description": "Additional arguments to pass to GDB Server command line",
"type": "array",
"items": "string"
},
"executable": {
"description": "Path of executable for symbols and program information. See also `loadFiles`, `symbolFiles`",
"type": "string"
},
"loadFiles": {
"description": "List of files (hex/bin/elf files) to load/program instead of the executable file. Symbols are not loaded (see `symbolFiles`). Can be an empty list to specify none. If this property does not exist, then the executable is used to program the device",
"type": "array",
"items": "string",
"default": null
},
"symbolFiles": {
"description": "Array of ELF files to load symbols from instead of the executable file. Each item in the array cab be a string or an object. Program information is ignored (see `loadFiles`). Can be an empty list to specify none. If this property does not exist, then the executable is used for symbols",
"type": "array",
"items": {
"type": ["object", "string"],
"properties": {
"file": {
"type": "string",
"description": "Pathname of an ELF file for symbols"
},
"offset": {
"type": [
"number",
"string"
],
"description": "Optional offset to apply to all sections of the ELF file. Use a string strarting with '0x' for a hexadecimal number"
},
"textaddress": {
"type": [
"number",
"string"
],
"description": "Optional: Load the TEXT section at the specified 'textaddress'. Use a string strarting with '0x' for a hexadecimal number"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Section name"
},
"address": {
"type": [
"number",
"string"
],
"description": "Base address for section. Use a string strarting with '0x' for a hexadecimal number"
}
},
"required": [
"name",
"address"
]
}
}
},
"required": [
"file"
]
},
"default": null
},
"gdbTarget": {
"default": null,
"description": "For externally (servertype = \"external\") controlled GDB Servers you must specify the GDB target to connect to. This can either be a \"hostname:port\" combination or path to a serial port",
"type": "string"
},
"runToMain": {
"description": "Deprecated: please use 'runToEntryPoint' instead.",
"type": "boolean",
"default": false,
"deprecated": true
},
"breakAfterReset": {
"default": false,
"type": "boolean",
"description": "Applies to Restart/Reset/Launch, halt debugger after a reset. Ignored if `runToEntryPoint` is used."
},
"runToEntryPoint": {
"description": "Applies to Launch/Restart/Reset, ignored for Attach. If enabled the debugger will run until the start of the given function.",
"type": "string",
"default": "main"
},
"numberOfProcessors": {
"description": "Number of processors/cores in the target device.",
"type": "number",
"multipleOf": 1,
"minimum": 1,
"maximum": 10,
"default": 1
},
"targetProcessor": {
"description": "The processor you want to debug. Zero based integer index. Must be less than 'numberOfProcessors'",
"type": "number",
"multipleOf": 1,
"minimum": 0,
"maximum": 9,
"default": 0
},
"liveWatch": {
"description": "An object with parameters for Live Watch",
"properties": {
"enabled": {
"default": false,
"description": "Enable/Disable Live Watch. Only applies to OpenOCD",
"type": "boolean"
},
"samplesPerSecond": {
"default": 2,
"description": "Maximum number of samples per second. Different from GUI refresh-rate, which is a user/workspace setting",
"type": "number",
"multipleOf": 1,
"minimum": 0,
"maximum": 20
}
},
"default": {
"enabled": true,
"samplesPerSecond": 4
}
},
"ctiOpenOCDConfig": {
"description": "Experimental. Does not work yet",
"properties": {
"enabled": {
"default": true,
"description": "Enable/Disable Cross Trigger Interface/Matrix for synchronized pause/resume",
"type": "boolean"
},
"initCommands": {
"default": [],
"description": "List of OpenOCD TCL commands to initialize the CTI/CTM infrastructure (if any)",
"type": "array",
"items": {
"type": "string"
}
},
"pauseCommands": {
"default": [],
"description": "List of OpenOCD TCL commands to pause all processors",
"type": "array",
"items": {
"type": "string"
}
},
"resumeCommands": {
"default": [],
"description": "List of OpenOCD TCL commands to resume all processors",
"type": "array",
"items": {
"type": "string"
}
}
},
"default": {
"enabled": true,
"pauseCommands": [],
"resumeCommands": []
}
},
"chainedConfigurations": {
"description": "An object describing how additional configurations should be launched",
"properties": {
"enabled": {
"default": true,
"description": "Enable/Disable entire set of chained configurations",
"type": "boolean"
},
"detached": {
"default": false,
"description": "Related or independent server sessions. Set to true for servers like 'JLink'. Inherited by children",
"type": "boolean"
},
"lifecycleManagedByParent": {
"default": true,
"description": "Are Restart/Reset/Stop/Disconnect shared? All life-cycle management done as a group by parent/root. Inherited by children",
"type": "boolean"
},
"waitOnEvent": {
"enum": [
"postStart",
"postInit"
],
"default": "postInit",
"description": "Event to wait for. 'postStart' means wait for gdb-server connecting, 'postInit' is after init commands are completed by gdb. Inherited by children",
"type": "string"
},
"delayMs": {
"type": "number",
"description": "Default delay in milliseconds for a certain amount of milliseconds to begin launch. Inherited by children",
"multipleOf": 1,
"minimum": 0,
"default": 5
},
"overrides": {
"default": {},
"description": "Values to override/set in this child configuration. A set of name/value pairs. Set value to 'null' (no quotes) to delete. Sorry, no IntelliSense",
"type": "object"
},
"inherits": {
"default": [],
"description": "List of properties to inherit from parent. Sorry, no IntelliSense",
"type": "array",
"items": {
"type": "string"
}
},
"launches": {
"type": "array",
"items": {
"properties": {
"name": {
"default": "",
"description": "Name of launch configuration. Sorry, no IntelliSense",
"type": "string"
},
"folder": {
"default": "",
"description": "Folder to use for this configuration. Where .vscode/launch.json exists. Default is same folder as parent. Use either the full path name or the base-name of the folder",
"type": "string"
},
"enabled": {
"default": true,
"description": "Enable/Disable this configuration",
"type": "boolean"
},
"detached": {
"default": false,
"description": "Related or independent server sessions. Set to true for servers like 'JLink'",
"type": "boolean"
},
"waitOnEvent": {
"enum": [
"postStart",
"postInit"
],
"default": "postInit",
"description": "Wait for an event. 'postStart' means wait for gdb-server connecting, 'postInit' is after init commands are completed by gdb",
"type": "string"
},
"delayMs": {
"type": "number",
"description": "Delay in milliseconds for a certain amount of milliseconds to begin launch",
"multipleOf": 1,
"minimum": 0,
"default": 5
},
"lifecycleManagedByParent": {
"default": true,
"description": "Are Restart/Reset/Stop/Disconnect shared? All life-cycle management done as a group by parent/root",
"type": "boolean"
},
"overrides": {
"default": {},
"description": "Values to override/set in this child configuration. A set of name/value pairs. Set value to 'null' (no quotes) to delete. Sorry, no IntelliSense",
"type": "object"
},
"inherits": {
"default": [],
"description": "List of properties to inherit from parent. Sorry, no IntelliSense",
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
},
"default": {
"enabled": true,
"waitOnEvent": "postInit",
"lifeCycleShared": true,
"launches": [
{
"name": "use EXACT name of chained configuration to launch",
"folder": "use full path or folder basename or leave empty"
}
]
}
},
"graphConfig": {
"description": "Description of how graphing can be done. See our Wiki for details",
"items": {
"oneOf": [
{
"properties": {
"annotate": {
"default": true,
"description": "Create annotations on the graph for when the target processor starts and stops execution. (green line for starting execution, red line for stopping execution).",
"type": "boolean"
},
"label": {
"description": "Label for Graph",
"type": "string"
},
"maximum": {
"default": 65535,
"description": "Maximum value for the X-Axis",
"type": "number"
},
"minimum": {
"default": 0,
"description": "Minimum value for the Y-Axis",
"type": "number"
},
"plots": {
"description": "Plot configurations. Data sources must be configured for \"graph\" (or \"advanced\" with a decoder that sends graph data) in the \"swoConfig\" section",
"items": {
"properties": {
"color": {
"pattern": "^#[0-9a-fA-F]{3}([0-9a-fA-F]{3})?$",
"type": "string"
},
"graphId": {
"description": "Graph Data Source Id for the plot.",
"type": "string"
},
"label": {
"description": "A label for this data set",
"type": "string"
}
},
"required": [
"graphId"
],
"type": "object"
},
"type": "array"
},
"timespan": {
"default": 30,
"description": "Length of time (seconds) to be plotted on screen.",
"type": "number"
},
"type": {
"enum": [
"realtime"
],
"type": "string"
}
},
"required": [
"label",
"plots",
"minimum",
"maximum"
],
"type": "object"
},
{
"properties": {
"label": {
"description": "Label for graph",
"type": "string"
},
"timespan": {
"default": 10,
"description": "The amount of time (seconds) that the XY Plot will show the trace for.",
"type": "number"
},
"type": {
"enum": [
"x-y-plot"
],
"type": "string"
},
"xGraphId": {
"description": "Graph Data Source Id for the X axis",
"type": "string"
},
"xMaximum": {
"default": 65535,
"description": "Maximum value on the X-Axis",
"type": "number"
},
"xMinimum": {
"default": 0,
"description": "Minimum value on the X-Axis",
"type": "number"
},
"yGraphId": {
"description": "Graph Data Source Id Port for the Y axis",
"type": "string"
},
"yMaximum": {
"default": 65535,
"description": "Maximum value on the Y-Axis",
"type": "number"
},
"yMinimum": {
"default": 0,
"description": "Minimum value on the Y-Axis",
"type": "number"
}
},
"required": [
"xGraphId",
"yGraphId",
"label"
],
"type": "object"
}
]
},
"type": "array"
},
"showDevDebugOutput": {
"enum": [
"none",
"parsed",
"raw",
"both",
"vscode"
],
"default": "none",
"description": "Used to debug this extension. Prints all GDB responses to the console. 'raw' prints gdb responses, 'parsed' prints results after parsing, 'both' prints both. 'vscode' shows raw and VSCode interactions",
"type": "string"
},
"showDevDebugTimestamps": {
"default": false,
"description": "Show timestamps when 'showDevDebugOutput' is enabled",
"type": "boolean"
},
"svdFile": {
"default": null,
"description": "This is for 'XPERIPHERALS' window provided by 'mcu-debug.peripheral-viewer'. It can be a simple file name or more based on a CMSIS pack or deviceName. See 'mcu-debug.peripheral-viewer' for format",
"type": "string"
},
"svdPath": {
"default": null,
"description": "This is for 'XPERIPHERALS' window provided by 'mcu-debug.peripheral-viewer' and 'Embedded Tools' Extension from Microsoft. It can be a simple file name. For 'mcu-debug.peripheral-viewer' or more based on a CMSIS pack or deviceName. See 'mcu-debug.peripheral-viewer' for format",
"type": "string"
},
"rttConfig": {
"type": "object",
"description": "SEGGER's Real Time Trace (RTT) and supported by JLink, OpenOCD and perhaps others in the future",
"default": {
"enabled": true,
"address": "auto",
"decoders": [
{
"label": "",
"port": 0,
"type": "console"
}
]
},
"properties": {
"enabled": {
"type": "boolean",
"description": "Enable/Disable RTT",
"default": false
},
"address": {
"type": "string",
"description": "Address to start searching for the RTT control block. Use \"auto\" for Cortex-Debug to use the address from elf file",
"default": "auto"
},
"searchSize": {
"type": "number",
"description": "Number of bytes to search for the RTT control block. If 'address' is 'auto', use ONLY if you have a custom RTT implementation",
"multipleOf": 1,
"minimum": 16,
"default": 16
},
"searchId": {
"type": "string",
"description": "A string to search for to find the RTT control block. If 'address' is 'auto', use ONLY if you have a custom RTT implementation",
"default": "SEGGER RTT"
},
"polling_interval": {
"type": "number",
"description": "number of milliseconds (> 0) to wait for check for data on out channels. Only for OpenOCD",
"default": 0,
"minimum": 1
},
"rtt_start_retry": {
"type": "number",
"description": "Keep trying to start RTT for OpenOCD until it succeeds with given internal in milliseconds. <= 0 means do not retry. Only for OpenOCD",
"default": 1000,
"minimum": 0
},
"clearSearch": {
"type": "boolean",
"description": "When true, clears the search-string. Only applicable when address is \"auto\"",
"default": true
},
"decoders": {
"description": "SWO Decoder Configuration",
"items": {
"anyOf": [
{
"properties": {
"label": {
"description": "A label for RTT Console",
"type": "string"
},
"port": {
"description": "RTT Channel Number (0 to 15)",
"default": 0,
"maximum": 15,
"minimum": 0,
"multipleOf": 1,
"type": "number"
},
"type": {
"enum": [
"console",
"binary"
],
"default": "console",
"description": "'console' with text input/output, 'binary' is for converting byte stream to other data types",
"type": "string"
},
"prompt": {
"description": "Prompt to use for RTT Console",
"type": "string",
"default": ""
},
"noprompt": {
"description": "Don't use a prompt for RTT Console",
"type": "boolean",
"default": false
},
"noclear": {
"description": "append to screen/logfile when another connection is made",
"type": "boolean",
"default": false
},
"logfile": {
"description": "log all raw data (input and output) to specified file",
"type": "string",
"default": ""
},
"timestamp": {
"description": "Add timestamps while printing for 'console' type. 'binary' type always prints timestamps",
"type": "boolean",
"default": false
},
"encoding": {
"type": "string",
"description": "How binary data bytes are converted into a number. All little-endian",
"default": "unsigned",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
]
},
"iencoding": {
"type": "string",
"description": "How keyboard input is encoded Cooked mode only",
"default": "utf8",
"enum": [
"ascii",
"utf8",
"ucs2",
"utf16le"
]
},
"scale": {
"default": 1,
"description": "Binary only: This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"inputmode": {
"type": "string",
"description": "Experimental: 'disabled' means no stdin. 'raw' and 'rawecho' sends chars as they are typed.\n'rawecho' will echo chars and process RETURN keys. Even CTRL-C CTRL-D are passed on",
"default": "cooked",
"enum": [
"cooked",
"raw",
"rawecho",
"disabled"
]
}
},
"required": [
"port"
],
"type": "object"
},
{
"properties": {
"encoding": {
"default": "unsigned",
"description": "This property is only used for binary and graph output formats.",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
],
"type": "string"
},
"graphId": {
"description": "The identifier to use for this data in graph configurations.",
"type": "string"
},
"port": {
"description": "RTT Channel Number",
"maximum": 15,
"minimum": 0,
"type": "number"
},
"scale": {
"default": 1,
"description": "This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"type": {
"enum": [
"graph"
],
"type": "string"
}
},
"required": [
"port",
"graphId"
],
"type": "object"
},
{
"properties": {
"config": {
"additionalProperties": true,
"type": "object"
},
"decoder": {
"description": "Path to a javascript module to implement the decoding functionality.",
"type": "string"
},
"ports": {
"description": "RTT Channel Numbers",
"type": "array",
"items": {
"type": "number",
"maximum": 15,
"minimum": 0
}
},
"type": {
"enum": [
"advanced"
],
"type": "string"
}
},
"required": [
"ports",
"decoder"
],
"type": "object"
}
]
},
"type": "array"
}
}
},
"swoConfig": {
"description": "Description of SWO can be configured. Also see our Wiki for details",
"properties": {
"cpuFrequency": {
"default": 0,
"description": "Target CPU frequency in Hz.",
"type": "number"
},
"enabled": {
"default": false,
"description": "Enable SWO decoding.",
"type": "boolean"
},
"source": {
"type": "string",
"enum": [
"probe",
"socket",
"serial",
"file"
],
"default": "probe",
"description": "Source for SWO data. Can either be \"probe\" to get directly from debug probe, or a serial port device to use a serial port external to the debug probe."
},
"swoPath": {
"type": "string",
"default": "",
"description": "Path name when source is \"file\" or \"serial\". Typically a /path-name or a serial-port-name"
},
"swoPort": {
"type": "string",
"default": "",
"description": "When server is \"external\" && source is \"socket\", port to connect to. Format [host:]port"
},
"decoders": {
"description": "SWO Decoder Configuration",
"items": {
"anyOf": [
{
"properties": {
"label": {
"description": "A label for the output window.",
"type": "string"
},
"port": {
"description": "ITM Port Number",
"maximum": 31,
"minimum": 0,
"type": "number"
},
"showOnStartup": {
"description": "If true, switches to this output when starting a debug session.",
"type": "boolean"
},
"timestamp": {
"description": "Add timestamps while printing",
"type": "boolean",
"default": false
},
"type": {
"enum": [
"console"
],
"type": "string"
},
"encoding": {
"type": "string",
"default": "utf8",
"enum": [
"ascii",
"utf8",
"ucs2",
"utf16le"
]
},
"logfile": {
"description": "log all raw data to specified file",
"type": "string",
"default": ""
}
},
"required": [
"port"
],
"type": "object"
},
{
"properties": {
"encoding": {
"default": "unsigned",
"description": "This property is only used for binary and graph output formats.",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
],
"type": "string"
},
"label": {
"description": "A label for the output window.",
"type": "string"
},
"port": {
"description": "ITM Port Number",
"maximum": 31,
"minimum": 0,
"type": "number"
},
"scale": {
"default": 1,
"description": "This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"type": {
"enum": [
"binary"
],
"type": "string"
},
"logfile": {
"description": "log all raw data to specified file",
"type": "string",
"default": ""
}
},
"required": [
"port"
],
"type": "object"
},
{
"properties": {
"encoding": {
"default": "unsigned",
"description": "This property is only used for binary and graph output formats.",
"enum": [
"unsigned",
"signed",
"Q16.16",
"float"
],
"type": "string"
},
"graphId": {
"description": "The identifier to use for this data in graph configurations.",
"type": "string"
},
"port": {
"description": "ITM Port Number",
"maximum": 31,
"minimum": 0,
"type": "number"
},
"scale": {
"default": 1,
"description": "This setting will scale the raw value from the ITM port by the specified value. Can be used, for example, to scale a raw n-bit ADC reading to a voltage value. (e.g to scale a 12-bit ADC reading to a 3.3v scale you would need a scale value of 3.3/4096 = 0.0008056640625",
"type": "number"
},
"type": {
"enum": [
"graph"
],
"type": "string"
},
"logfile": {
"description": "log all raw data to specified file",
"type": "string",
"default": ""
}
},
"required": [
"port",
"graphId"
],
"type": "object"
},
{
"properties": {
"config": {
"additionalProperties": true,
"type": "object"
},
"decoder": {
"description": "Path to a javascript module to implement the decoding functionality.",
"type": "string"
},
"ports": {
"description": "ITM Port Numbers",
"type": "array",
"items": {
"type": "number",
"maximum": 31,
"minimum": 0
}
},
"type": {
"enum": [
"advanced"
],
"type": "string"
}
},
"required": [
"ports",
"decoder"
],
"type": "object"
}
]
},
"type": "array"
},
"swoFrequency": {
"default": 0,
"description": "SWO frequency in Hz.",
"type": "number"
}
},
"required": [],
"type": "object"
},
"ipAddress": {
"default": null,
"description": "IP Address for networked J-Link Adapter",
"pattern": "^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\\.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])$",
"type": "string"
},
"serialNumber": {
"default": null,
"description": "J-Link or ST-LINK Serial Number - only needed if multiple J-Links/ST-LINKs are connected to the computer",
"type": "string"
},
"interface": {
"default": "swd",
"description": "Debug Interface type to use for connections (defaults to SWD) - Used for J-Link, ST-LINK and BMP probes.",
"type": "string",
"enum": [
"swd",
"jtag",
"cjtag"
]
},
"jlinkscript": {
"default": null,
"description": "J-Link script file - optional input file for customizing J-Link actions.",
"type": "string"
},
"openOCDLaunchCommands": {
"default": [],
"description": "OpenOCD command(s) after configuration files are loaded (-c options)",
"items": {
"type": "string"
},
"type": "array"
},
"openOCDPreConfigLaunchCommands": {
"default": [],
"description": "OpenOCD command(s) before configuration files are loaded (-c options)",
"items": {
"type": "string"
},
"type": "array"
},
"configFiles": {
"description": "OpenOCD/PE GDB Server configuration file(s) to use when debugging (OpenOCD -f option)",
"items": {
"type": "string"
},
"type": "array"
},
"searchDir": {
"default": [],
"description": "OpenOCD directories to search for config files and scripts (-s option). If no search directories are specified, it defaults to the configured cwd.",
"items": {
"type": "string"
},
"type": "array"
},
"v1": {
"default": false,
"description": "For st-util only. Set this to true if your debug probe is a ST-Link V1 (for example, the ST-Link on the STM32 VL Discovery is a V1 device). When set to false a ST-Link V2 device is used.",
"type": "boolean"
},
"stlinkPath": {
"default": null,
"description": "Path to the ST-LINK_gdbserver executable. If not set then ST-LINK_gdbserver (ST-LINK_gdbserver.exe on Windows) must be on the system path.",
"type": "string"
},
"stm32cubeprogrammer": {
"default": null,
"description": "This path is normally resolved to the installed STM32CubeIDE or STM32CubeProgrammer but can be overridden here.",
"type": "string"
},
"targetId": {
"description": "On BMP this is the ID number that should be passed to the attach command (defaults to 1); for PyOCD this is the target identifier (only needed for custom hardware)",
"type": ["string", "number"],
"anyOf": [
{
"type": "string"
},
{
"type": "number",
"minimum": 1
}
]
},
"boardId": {
"description": "PyOCD Board Identifier. Needed if multiple compatible boards are connected.",
"type": "string"
},
"cmsisPack": {
"description": "Path to a CMSIS-Pack file. Use to add extra device support.",
"type": "string"
},
"BMPGDBSerialPort": {
"type": "string",
"description": "The serial port for the Black Magic Probe GDB Server. On Windows this will be \"COM<num>\", on Linux this will be something similar to /dev/ttyACM0, on OS X something like /dev/cu.usbmodemE2C0C4C6 (do not use tty versions on OS X)"
},
"powerOverBMP": {
"type": "string",
"description": "Power up the board over Black Magic Probe. \"powerOverBMP\" : \"enable\" or \"powerOverBMP\" : \"disable\". If not set it will use the last power state."
}
},
"required": [
"executable"
]
}
},
"configurationSnippets": [
{
"body": {
"cwd": "^\"\\${workspaceFolder}\"",
"executable": "${1:./bin/executable.elf}",
"name": "${6:Debug with JLink}",
"request": "launch",
"type": "cortex-debug",
"device": "",
"runToEntryPoint": "main",
"showDevDebugOutput": "none",
"servertype": "jlink"
},
"description": "Debugs an embedded ARM Cortex-M microcontroller using GDB + JLink",
"label": "Cortex Debug: JLink"
},
{
"body": {
"cwd": "^\"\\${workspaceRoot}\"",
"executable": "${1:./bin/executable.elf}",
"name": "${6:Debug with OpenOCD}",
"request": "launch",
"type": "cortex-debug",
"servertype": "openocd",
"configFiles": [],
"searchDir": [],
"runToEntryPoint": "main",
"showDevDebugOutput": "none"
},
"description": "Debugs an embedded ARM Cortex-M microcontroller using GDB + OpenOCD",
"label": "Cortex Debug: OpenOCD"
},
{
"body": {
"cwd": "^\"\\${workspaceFolder}\"",
"executable": "${1:./bin/executable.elf}",
"name": "${6:Debug with ST-Link}",
"request": "launch",
"type": "cortex-debug",
"runToEntryPoint": "main",
"showDevDebugOutput": "none",
"servertype": "stlink"
},
"description": "Debugs an embedded ARM Cortex-M microcontroller using GDB + STMicroelectronic's ST-LINK_gdbserver part of STM32CubeIDE",
"label": "Cortex Debug: ST-LINK"
},
{
"body": {
"cwd": "^\"\\${workspaceFolder}\"",
"executable": "${1:./bin/executable.elf}",
"name": "${6:Debug with PyOCD}",
"request": "launch",
"type": "cortex-debug",
"runToEntryPoint": "main",
"showDevDebugOutput": "none",
"servertype": "pyocd"
},
"description": "Debugs an embedded ARM Cortex-M microcontroller using GDB + PyOCD",
"label": "Cortex Debug: PyOCD"
},
{
"body": {
"cwd": "^\"\\${workspaceFolder}\"",
"executable": "${1:./bin/executable.elf}",
"name": "${6:Debug with ST-Util}",
"request": "launch",
"type": "cortex-debug",
"runToEntryPoint": "main",
"showDevDebugOutput": "none",
"servertype": "stutil"
},
"description": "Debugs an embedded ARM Cortex-M microcontroller using GDB + Texane's st-util GDB Server (https://github.com/texane/stlink)",
"label": "Cortex Debug: ST-Util"
}
],
"label": "Cortex Debug",
"program": "./dist/debugadapter.js",
"runtime": "node",
"type": "cortex-debug",
"variables": {},
"languages": [
"c",
"cpp",
"rust"
]
}
],
"menus": {
"commandPalette": [
{
"command": "cortex-debug.examineMemory",
"when": "debugType == cortex-debug"
},
{
"command": "cortex-debug.examineMemoryLegacy",
"when": "debugType == cortex-debug"
},
{
"command": "cortex-debug.resetDevice",
"when": "debugType == cortex-debug"
},
{
"command": "cortex-debug.toggleVariableHexFormat",
"when": "debugType == cortex-debug"
},
{
"command": "cortex-debug.liveWatch.addExpr",
"when": "debugType === cortex-debug"
}
],
"debug/toolBar": [
{
"command": "cortex-debug.resetDevice",
"group": "navigation",
"when": "debugType == cortex-debug"
}
],
"view/item/context": [
{
"command": "cortex-debug.liveWatch.editExpr",
"when": "view == cortex-debug.liveWatch && viewItem == expression",
"group": "inline"
},
{
"command": "cortex-debug.liveWatch.moveUp",
"when": "view == cortex-debug.liveWatch && viewItem == expression",
"group": "inline"
},
{
"command": "cortex-debug.liveWatch.moveDown",
"when": "view == cortex-debug.liveWatch && viewItem == expression",
"group": "inline"
},
{
"command": "cortex-debug.liveWatch.removeExpr",
"when": "view == cortex-debug.liveWatch && viewItem == expression",
"group": "inline"
}
],
"view/title": [
{
"command": "cortex-debug.liveWatch.addExpr",
"when": "view == cortex-debug.liveWatch",
"group": "navigation"
},
{
"command": "cortex-debug.varHexModeTurnOn",
"when": "view == workbench.debug.variablesView && inDebugMode && debugType == 'cortex-debug' && debugState == stopped && cortex-debug:variableUseNaturalFormat",
"group": "navigation"
},
{
"command": "cortex-debug.varHexModeTurnOff",
"when": "view == workbench.debug.variablesView && inDebugMode && debugType == 'cortex-debug' && debugState == stopped && !cortex-debug:variableUseNaturalFormat",
"group": "navigation"
},
{
"command": "cortex-debug.varHexModeTurnOn",
"when": "view == workbench.debug.watchExpressionsView && inDebugMode && debugType == 'cortex-debug' && debugState == stopped && cortex-debug:variableUseNaturalFormat",
"group": "navigation"
},
{
"command": "cortex-debug.varHexModeTurnOff",
"when": "view == workbench.debug.watchExpressionsView && inDebugMode && debugType == 'cortex-debug' && debugState == stopped && !cortex-debug:variableUseNaturalFormat",
"group": "navigation"
},
{
"command": "cortex-debug.varHexModeTurnOn",
"when": "view == cortex-debug.liveWatch && inDebugMode && debugType == 'cortex-debug' && debugState == stopped && cortex-debug:variableUseNaturalFormat",
"group": "navigation"
},
{
"command": "cortex-debug.varHexModeTurnOff",
"when": "view == cortex-debug.liveWatch && inDebugMode && debugType == 'cortex-debug' && debugState == stopped && !cortex-debug:variableUseNaturalFormat",
"group": "navigation"
}
],
"debug/variables/context": [
{
"command": "cortex-debug.liveWatch.addToLiveWatch",
"when": "inDebugMode && debugType == 'cortex-debug' && debugState == stopped",
"group": "navigation"
}
]
},
"views": {
"debug": [
{
"id": "cortex-debug.liveWatch",
"name": "Cortex Live Watch",
"when": "debugType == cortex-debug"
}
]
}
},
"dependencies": {
"@vscode/extension-telemetry": "^0.4.7",
"@vscode/webview-ui-toolkit": "^1.1.0",
"binary-parser": "^2.2.1",
"bindings": "^1.5.0",
"command-exists": "^1.2.9",
"commander": "^2.20.3",
"d3": "^7.6.1",
"debug": "^4.3.1",
"hasbin": "^1.2.3",
"json-stream-stringify": "^2.0.4",
"nan": "^2.14.2",
"node-interval-tree": "^1.3.3",
"prebuild-install": "^7.0.1",
"ringbufferjs": "^1.1.0",
"safe-buffer": "^5.2.1",
"stream-json": "^1.7.3",
"tmp": "^0.2.1",
"universal-analytics": "^0.5.3",
"uuid": "^8.3.2",
"vscode-jsonrpc": "^6.0.0"
},
"description": "ARM Cortex-M GDB Debugger support for VSCode",
"devDependencies": {
"@types/binary-parser": "^1.5.1",
"@types/mocha": "^5.2.7",
"@types/node": "16.x",
"@types/vscode": "^1.69.0",
"@vscode/debugadapter": "^1.59.0",
"@vscode/debugprotocol": "^1.59.0",
"@vscode/test-electron": "^2.1.3",
"mocha": "^9.1.3",
"ts-loader": "^9.2.6",
"tslint": "^5.12.1",
"typescript": "^4.7.4",
"typescript-tslint-plugin": "^1.0.2",
"webpack": "^5.76.0",
"webpack-cli": "^4.9.1"
},
"displayName": "Cortex-Debug",
"engines": {
"vscode": "^1.69.0"
},
"icon": "images/icon.png",
"keywords": [
"cortex-m",
"gdb",
"debug",
"embedded"
],
"extensionDependencies": [
"mcu-debug.debug-tracker-vscode",
"mcu-debug.memory-view",
"mcu-debug.rtos-views",
"mcu-debug.peripheral-viewer"
],
"main": "./dist/extension.js",
"name": "cortex-debug",
"publisher": "marus25",
"license": "MIT",
"repository": {
"type": "git",
"url": "https://github.com/Marus/cortex-debug.git"
},
"bugs": {
"url": "https://github.com/Marus/cortex-debug/issues"
},
"scripts": {
"vscode:prepublish": "npm run lint && webpack --mode production && node dist/docgen.js",
"watch": "webpack --mode development --watch",
"compile": "webpack --mode development && node dist/docgen.js",
"test-compile": "tsc -p ./",
"package": "node ./release.js --package",
"publish": "node ./release.js --publish --vsx-also",
"lint": "./node_modules/tslint/bin/tslint --project ."
}
}
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/kontais/cortex-debug.git
git@gitee.com:kontais/cortex-debug.git
kontais
cortex-debug
cortex-debug
master

搜索帮助