Skip to content

Commit fccd631

Browse files
authored
Added MacOS instructions. (#5)
1 parent 4d61f92 commit fccd631

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

README.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@
1010
Contributors:
1111
Frédéric Desbiens - Initial version.
1212
13+
Andy Riexinger - Documentation for Mac M1.
14+
1315
-->
1416

1517
# Eclipse ThreadX IoT DevKit Starter Application
@@ -38,6 +40,8 @@ Theoretically, any recent laptop running Windows 11, Linux, or MacOS should do.
3840
We tested on the following environments:
3941
- Windows 11 24H2 (Version 10.0.26100.2161)
4042
- Ubuntu 22.04.5 LTS (Windows Subsystem for Linux version 2.3.24.0)
43+
- Mac M1, macOS Sonoma 14.6.1 (23G93), native
44+
- Mac M1, macOS Sonoma 14.6.1 (23G93), Parallels Desktop for Mac Version 17.1.7 (51588), Ubuntu 22.04.5 LTS
4145

4246

4347
### IoT DevKit
@@ -89,6 +93,14 @@ export PATH=$PATH:/opt/arm-gnu-toolchain-13.3.rel1-x86_64-arm-none-eabi/bin
8993
arm-none-eabi-gcc --version
9094
```
9195

96+
**MacOS**
97+
98+
For Mac M1, we tested using version 14.2.rel1. Below are links to download. The install is similar to Linux.
99+
100+
- Mac M1 native: [arm-gnu-toolchain-14.2.rel1-darwin-arm64-arm-none-eabi.pkg](https://developer.arm.com/-/media/Files/downloads/gnu/14.2.rel1/binrel/arm-gnu-toolchain-14.2.rel1-darwin-arm64-arm-none-eabi.pkg)
101+
- Ubuntu 22.04.5 on Mac M1 via Parallels Desktop: [arm-gnu-toolchain-14.2.rel1-aarch64-arm-none-eabi.tar.xz](https://developer.arm.com/-/media/Files/downloads/gnu/14.2.rel1/binrel/arm-gnu-toolchain-14.2.rel1-aarch64-arm-none-eabi.tar.xz)
102+
103+
92104
**Windows**
93105
```
94106
winget install --id=Arm.GnuArmEmbeddedToolchain -e
@@ -103,7 +115,7 @@ To deploy your code on the AZ3166, just plug the board on your computer. When yo
103115

104116
Once compilation is finished, you will find the executable in the `MXChip/AZ3166/build/app` folder. The default filename is `mxchip_threadx.bin`. Just copy that file to the virtual drive and the AZ3166's boot loader will reset the board and execute your code. There is also a deploy script in the `MXChip/AZ3166/scripts` folder.
105117

106-
You can use any terminal application to connect to the serial port and monitor your application's output. Personally, I use Tera Term, which you can install using `winget`. Just make sure you set the baud rate to **115,200**.
118+
You can use any terminal application to connect to the serial port and monitor your application's output. Personally, we use Tera Term, which you can install using `winget`. Just make sure you set the baud rate to **115,200**. On MacOS, we used [SerialTools](https://apps.apple.com/de/app/serialtools/id611021963?mt=12) which you can install via the Mac App Store.
107119

108120
If you deployed this application without any changes, you will get the following output in your terminal:
109121

0 commit comments

Comments
 (0)