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
@@ -134,7 +134,7 @@ mbed CLI can create and import programs based on both mbed OS 2 and mbed OS 5.
134
134
135
135
### Creating a new program for mbed OS 5
136
136
137
-
When you create a new program, mbed CLI automatically imports the latest [mbed OS release](https://github.com/ARMmbed/mbed-os/). Each release includes all the components: code, build tools and IDE exporters.
137
+
When you create a new program, mbed CLI automatically imports the latest [mbed OS release](https://github.com/ARMmbed/mbed-os/). Each release includes all the components: code, build tools and IDE exporters.
138
138
139
139
With this in mind, let's create a new program (we'll call it `mbed-os-program`):
140
140
@@ -200,13 +200,13 @@ $ cd mbed-os-example-blinky
200
200
```
201
201
202
202
You can use the "import" command without specifying a full URL; mbed CLI adds a prefix (https://github.com/ARMmbed) to the URL if one is not present. For example, this command:
While working on your code, you may need to add another library to your application or remove existing libraries.
231
+
While working on your code, you may need to add another library to your application or remove existing libraries.
232
232
233
233
Adding a new library to your program is not the same as cloning the repository. Don't clone a library using `hg` or `git`; use `mbed add` to add the library. This ensures that all libraries and sublibraries are populated as well.
234
234
@@ -273,7 +273,7 @@ $ mbed remove text-lcd
273
273
After importing a program or creating a new one, you need to tell mbed CLI where to find the toolchains that you want to use for compiling your source tree.
274
274
275
275
There are multiple ways to configure toolchain locations:
276
-
*`mbed_settings.py` file in the root of your program. The tools will automatically create this file if it doesn't already exist.
276
+
*`mbed_settings.py` file in the root of your program. The tools will automatically create this file if it doesn't already exist.
277
277
* The mbed CLI configuration.
278
278
* Setting an environment variable.
279
279
* Adding directory of the compiler binary to your PATH.
@@ -285,15 +285,10 @@ Methods for configuring toolchains that appear earlier in the above list overrid
285
285
Edit `mbed_settings.py` to set your toolchain:
286
286
287
287
* To use the [ARM Compiler toolchain](https://developer.arm.com/products/software-development-tools/compilers/arm-compiler-5/downloads), set `ARM_PATH` to the *base* directory of your ARM Compiler installation (example: C:\Program Files\ARM\armcc5.06). The recommended version of the ARM Compiler toolchain is 5.06.
288
-
<<<<<<< HEAD
289
288
* To use the [GNU ARM Embedded toolchain (GCC) version 6](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads), set `GCC_ARM_PATH` to the *binary* directory of your GCC ARM installation (example: C:\Program Files\GNU Tools ARM Embedded\6 2017q2\bin). Use version 6 of GCC ARM Embedded; version 5.0 or any older version might be incompatible with the tools.
290
289
* To use the [IAR EWARM toolhain](https://www.iar.com/iar-embedded-workbench/#!?architecture=ARM), set `IAR_PATH` to the *base* directory of your IAR installation. Use versions 7.80 of IAR EWARM; prior versions might be incompatible with the tools.
291
-
=======
292
-
* To use the [GCC ARM Embedded toolchain](https://launchpad.net/gcc-arm-embedded), set `GCC_ARM_PATH` to the *binary* directory of your GCC ARM installation (example: C:\Program Files\GNU Tools ARM Embedded\6 2017q2\bin). Use version 6 of GCC ARM Embedded; version 5.0 or any older version might be incompatible with the tools.
293
-
* To use the [IAR EWARM toolchain](https://www.iar.com/iar-embedded-workbench/#!?architecture=ARM), set `IAR_PATH` to the *base* directory of your IAR installation. Use versions 7.80 of IAR EWARM; prior versions might be incompatible with the tools.
294
-
>>>>>>> Fixed spelling typo
295
290
296
-
Because `mbed_settings.py` contains local settings (possibly relevant only to a single OS on a single machine), you should not check it into version control.
291
+
Because `mbed_settings.py` contains local settings (possibly relevant only to a single OS on a single machine), you should not check it into version control.
As you develop your program, you'll edit parts of it. You can get the status of all the repositories in your program (recursively) by running `mbed status`. If a repository has uncommitted changes, this command displays these changes.
646
+
As you develop your program, you'll edit parts of it. You can get the status of all the repositories in your program (recursively) by running `mbed status`. If a repository has uncommitted changes, this command displays these changes.
652
647
653
648
Here's an example:
654
649
@@ -674,7 +669,7 @@ You can then commit or discard these changes through that repository's version c
674
669
675
670
### Pushing upstream
676
671
677
-
To push the changes in your local tree upstream, run `mbed publish`. `mbed publish` works recursively, pushing the leaf dependencies first, then updating the dependents and pushing them too.
672
+
To push the changes in your local tree upstream, run `mbed publish`. `mbed publish` works recursively, pushing the leaf dependencies first, then updating the dependents and pushing them too.
678
673
679
674
Let's assume that the list of dependencies of your program (obtained by running `mbed ls`) looks like this:
680
675
@@ -693,12 +688,12 @@ Let's assume that you make changes to `iot-client`. `mbed publish` detects the c
693
688
When you create a new (local) version control managed program or library, its revision history exists only locally. The repository is not associated with the remote one. To publish the local repository, please follow these steps:
694
689
695
690
1. Create a new empty repository on the remote site. This can be on a public repository hosting service (GitHub, Bitbucket, mbed.org), your own service or a different location on your system.
696
-
1. Copy the URL/location of the new repository in your clipboard.
691
+
1. Copy the URL/location of the new repository in your clipboard.
697
692
1. Open command-line in the local repository directory (for example, change directory to `mbed-os-example/local-lib`).
698
693
1. To associate the local repository:
699
694
* For Git, run `git remote add origin <url-or-path-to-your-remote-repo>`.
700
695
* For Mercurial, edit .hg/hgrc and add (or replace if exists):
701
-
696
+
702
697
```
703
698
[paths]
704
699
default = <url-or-path-to-your-remote-repo>
@@ -722,7 +717,7 @@ Through the workflow explained above, mbed CLI maintains association to the orig
722
717
723
718
## Updating programs and libraries
724
719
725
-
You can update programs and libraries on your local machine so that they pull in changes from the remote sources (Git or Mercurial).
720
+
You can update programs and libraries on your local machine so that they pull in changes from the remote sources (Git or Mercurial).
726
721
727
722
As with any mbed CLI command, `mbed update` uses the current directory as a working context. Before calling `mbed update`, you should change your working directory to the one you want to update. For example, if you're updating mbed-os, use `cd mbed-os` before you begin updating.
728
723
@@ -805,7 +800,7 @@ Here is a list of configuration settings and their defaults:
805
800
*`protocol` - defines the default protocol used for importing or cloning of programs and libraries. The possible values are `https`, `http` and `ssh`. Use `ssh` if you have generated and registered SSH keys (Public Key Authentication) with a service such as GitHub, GitLab, Bitbucket and so on. Read more about SSH keys [here](https://help.github.com/articles/generating-an-ssh-key/). Default: `https`.
806
801
*`depth` - defines the *clone* depth for importing or cloning and applies only to *Git* repositories. Note that though this option may improve cloning speed, it may also prevent you from correctly checking out a dependency tree when the reference revision hash is older than the clone depth. Read more about shallow clones [here](https://git-scm.com/docs/git-clone). Default: none.
807
802
*`cache` - defines the local path that stores small copies of the imported or cloned repositories, and mbed CLI uses it to minimize traffic and speed up future imports of the same repositories. Use `on` or `enabled` to turn on caching in the system temp path. Use `none` to turn caching off. Default: none (disabled).
808
-
803
+
809
804
## Troubleshooting
810
805
811
806
### Unable to import Mercurial (mbed.org) programs or libraries.
0 commit comments