You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A distribution point for the latest release of Mbed Studio
1
+
# Mbed Studio
2
+
Mbed Studio is a free IDE for Mbed OS application and library development, including all the dependencies and tools you need in a single package so that you can create, compile and debug your Mbed programs on the desktop.
3
+
4
+
Mbed Studio remains available as a free desktop IDE for Mbed OS development. It includes Arm Compiler 6 and can be used to build and debug Mbed projects locally.
5
+
6
+
This repository is a distribution point for the last release of Mbed Studio
7
+
8
+
## Downloads
9
+
10
+
-[Download for Windows](https://github.com/armmbed/mbed-studio/releases/download/v1.5.0/MbedStudio-1.5.0.exe)
11
+
-[Download for Mac](https://github.com/armmbed/mbed-studio/releases/download/v1.5.0/MbedStudio-1.5.0.pkg)
12
+
-[Download for Linux](https://github.com/armmbed/mbed-studio/releases/download/v1.5.0/MbedStudio-1.5.0.sh)
<ahref="index.html">Building and running a program</a>
200
+
201
+
202
+
</div>
203
+
<h1>Building and running a program</h1><h2id="selecting-a-build-target">Selecting a build target</h2><p>Mbed OS is designed to work on multiple development boards, but each individual build of Mbed OS must match the exact board the binary will be flashed to. This match is known as the <strong>target</strong> or <strong>build target</strong>.</p><p>To select a target, you can:</p><ul>
204
+
<li>Connect your board to your computer. Mbed Studio detects the board and suggests a matching target.</li>
205
+
<li>Use the <strong>Target</strong> drop-down list. Your target name most likely matches the board name.</li>
206
+
</ul><p><spanclass="images"><imgheight="265" src="images/selected_target.png" width="480"><span>Set the target for the active program from the <strong>Explorer</strong> view.</span></img></span></p><p>If you have an unsupported board, <ahref="../targets/custom-targets.html">please see the Custom targets page</a>.</p><h2id="building-a-program">Building a program</h2><p>To build, debug or run an Mbed program:</p><ol>
207
+
<li>
208
+
<p>Ensure the program you want to build or run is set to active.</p>
209
+
<p>To make the program active, right-click the program name in the <strong>Explorer</strong> view and select <strong>Set Active Program</strong>.</p>
210
+
</li>
211
+
<li>
212
+
<p>By default, Mbed Studio uses the <em>Debug</em> build profile.</p>
213
+
<ul>
214
+
<li>
215
+
<p>To use the <em>Develop</em> or <em>Release</em> profiles, select them from the <strong>Build profile</strong> drop-down list or right-click the program and select <strong>Set Build Profile</strong>.</p>
216
+
</li>
217
+
<li>
218
+
<p>To select a custom profile, from the <strong>Build profile</strong> drop-down list, select <strong>Import custom profiles</strong>. A window opens. Select a custom profile from any location on your computer.</p>
<p>To remove a custom profile from the <strong>Build profile</strong> drop-down list for the active program, you must delete or rename the custom profile file.</p>
223
+
<p><spanclass="tips">For more information about Mbed OS build profiles, see <ahref="https://os.mbed.com/docs/latest/tools/build-profiles.html">Build profiles</a> on the Mbed OS documentation site. Note, in particular, the effect build profiles have on the device entering sleep.</span></p>
224
+
<!--BROWSER <span class="notes">**Note:** In the browser version of Mbed Studio, there is only one default build profile.</span>-->
225
+
</li>
226
+
<li>
227
+
<p>Select a build option:</p>
228
+
<ul>
229
+
<li>
230
+
<p><strong>Build program:</strong> Build the program, without flashing it to the device.</p>
231
+
<ul>
232
+
<li>
233
+
<p><strong>Build:</strong> Checks the <code>BUILD</code> sub-directory (where the previous build is stored) and optimises build time by using as much as it can from the last build. For example, if two consecutive builds are for the same target and using the same build profile, the build will rebuild only the files that actively changed between the two builds, or from the point at which you stopped the previous build attempt.</p>
234
+
</li>
235
+
<li>
236
+
<p><strong>Clean build:</strong> Ignore all previous builds. A clean build is slower than reusing a previous build, but guarantees your build will have no old artefacts.</p>
237
+
</li>
238
+
</ul>
239
+
</li>
240
+
<li>
241
+
<p><strong>Debug program:</strong> Build the program and flash it to the device, then start a debug session.</p>
242
+
</li>
243
+
</ul>
244
+
<p>For more information about debug, see <ahref="../monitor-debug/debugging-with-mbed-studio.html">Debugging with Mbed Studio</a>.</p>
245
+
<ul>
246
+
<li><strong>Run program:</strong> Build the program and flash it to the device, without starting a debug session.</li>
247
+
</ul>
248
+
</li>
249
+
</ol><p><spanclass="notes"><strong>Note:</strong> Mbed Studio uses pyOCD to communicate with the connected platform. If you attempt to run a program on a platform with a DAPLink version that is not supported by pyOCD, it will fail with exit code 1. We are still adding support for pyOCD and more platforms will be available over time.</span></p><h2id="output-view">Output view</h2><p>The output of the build is displayed in the <strong>Output</strong> view. To open the view, go the <strong>View</strong> menu and select <strong>Output</strong>.</p><p>You can turn the auto scrolling on or off by clicking the <strong>Turn Auto Scrolling On</strong><imgheight="30" src="images/auto-scrolling-on-button.png" style="display: inline; margin: 0;" width="30"> or <strong>Turn Auto Scrolling Off</strong><imgheight="30" src="images/auto-scrolling-off-button.png" style="display: inline; margin: 0;" width="30"> icons.</img></img></p><p><spanclass="images"><imgheight="701" src="images/completed_build.png" width="1334"><span>A completed build.</span></img></span></p><p>To copy the output, do a right-click in the <strong>Output</strong> view and select <strong>Copy</strong> or <strong>Copy All</strong>:</p><ul>
250
+
<li><strong>Copy</strong>: Copies the line where your cursor is.</li>
251
+
<li><strong>Copy All</strong>: Copies the whole output.</li>
252
+
</ul><p>Do a right-click in the <strong>Output</strong> view and select <strong>Find</strong> to search the content of the output. When the <strong>Output</strong> view is in focus, you can also go to the <strong>Edit</strong> menu and select <strong>Find</strong>.</p><p>Click the <strong>Clear Output</strong> icon <imgheight="30" src="images/clear_button.png" style="display: inline; margin: 0;" width="30"> to clear the build output or do a right-click and select <strong>Clear Output</strong>.</img></p>
0 commit comments