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
Copy file name to clipboardExpand all lines: README.md
+49-42Lines changed: 49 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,9 +4,9 @@
4
4
5
5
**Use Arduino as a replacement for Energia** to develop on Texas Instruments LaunchPad products.
6
6
7
-
The [Arduino Boards Manager][69] makes it possible to load other processor families besides the original AVR-based Arduino boards. This repo contains instructions and relevant files for loading processor cores for Texas Instruments LaunchPad products in the MSP430, MSP432, and Tiva families. This allows development for TI LaunchPads using the Arduino [IDE][80] or [CLI][81] instead of the [Energia IDE][1].
7
+
[Energia][1] was originally created in 2012 as a fork from Arduino specifically to support Texas Instruments LaunchPads. However, it is [no longer maintained][73]. The last version was released in 2019.
8
8
9
-
Energia was originally developed in 2012 as a fork from Arduino specifically to support Texas Instruments LaunchPads. Unfortunately, it is [no longer maintained][73], with the last version released in 2019. The good news is that the processor cores used by Energia are compatible with Arduino.
9
+
Fortunately, **Texas Instruments processor cores can be loaded into Arduino** using the [Arduino Boards Manager][69]. I created this repo to maintain the Energia MSP430, MSP432, and Tiva cores so that they can continue to be used with Arduino.
10
10
11
11
## Loading a LaunchPad Board into Arduino IDE
12
12
@@ -28,37 +28,36 @@ Energia was originally developed in 2012 as a fork from Arduino specifically to
28
28
29
29
## Energia Application Libraries and Examples
30
30
31
-
The Energia IDE includes several libraries and examples at the application level of the IDE instead of in the platform cores. This means that if you use the Arduino IDE/CLI and install an MSP or Tiva core, you don't end up getting every library and example sketch that you would when using the Energia IDE. Most of the libraries and examples included with the Energia application are either readily available with Arduino or are obsolete. However, some are particular to the platforms supported by Energia and are not directly available with Arduino, so I have published standalone libraries to allow them to be loaded into Arduino.
31
+
Energia includes several libraries and example sketches at the application level of the IDE instead of in the platform cores. This means that if you install an MSP or Tiva core into Arduino, you don't end up getting every library and example sketch that you would when using the Energia IDE.
32
32
33
-
Stand-alone repositories for Energia libraries:
33
+
Most of the libraries and examples included with the Energia application are either readily available with Arduino or are obsolete. However, some are particular to the platforms supported by Energia and are not directly available with Arduino. I have published standalone libraries to allow them to be loaded into Arduino.
34
34
35
-
- [LCD_SharpBoosterPack_SPI][25]
36
-
- [OneMsTaskTimer][26]
35
+
These libraries are included in the Arduino Library Manager registry, so they can easily be installed from the `Sketch->Include Library->Manage Libraries...` menu. Note that some of the library names needed to be shortened to meet the registry name length recommendation.
37
36
38
-
Energia example sketches packaged into libraries so that they can be loaded into the Arduino IDE:
39
-
40
-
- [Energia-EducationalBP_MKII][27]
41
-
- [Energia-MultiTasking][28]
42
-
43
-
The above four libraries are included in the Arduino Library Manager registry, so they can easily be installed from the `Sketch->Include Library->Manage Libraries...` menu.
37
+
| Repository | Name in Arduino Library Manager | Notes |
| [LCD_SharpBoosterPack_SPI][25] | LCD_SharpBP_SPI | Energia application library |
40
+
| [OneMsTaskTimer][26] | OneMsTaskTimer | Energia application library |
41
+
| [Energia-EducationalBP_MKII][27] | Energia-EBP_MKII | Example sketches packaged into library |
42
+
| [Energia-MultiTasking][28] | Energia-MultiTas | Example sketches packaged into library |
44
43
45
44
## Installing LaunchPad Drivers
46
45
47
-
Depending on your host machine and the specific board you are programming, you probably need to install drivers and/or configuration files in order to communicate with the LaunchPad. If you see a message along the lines of "Error connecting to the target", then a missing driver or configuration file is likely the cause.
46
+
Depending on your host machine and the specific board you are programming, you may need to install drivers and/or configuration files in order to communicate with the LaunchPad. If you see a message along the lines of "Error connecting to the target", then a missing driver or configuration file is likely the cause.
48
47
49
48
### MacOS
50
49
51
-
No drivers should be needed for MSP432, Tiva, or the newer MSP430 LaunchPads (including the MSP430G2ET).
50
+
No drivers should be needed for MSP432, Tiva, or the newer MSP430 LaunchPads (including the [MSP430G2ET][210]).
52
51
53
-
The old MSP430G2 (non-ET) LaunchPads work without drivers when using version 0.25 of the `mspdebug` toolincluded with the msp430 v1.1.0 and msp430gcc9 v3.0.0 cores. Versions of `mspdebug` included with older versions of the MSP430 cores required separate drivers to be installed.
52
+
The [old MSP430G2][211] (non-ET) LaunchPads work without drivers when using version 0.25 of the `mspdebug` tool, which is included with the msp430 v1.1.0 and msp430gcc9 v3.0.0 cores. Versions of `mspdebug` included with older MSP430 cores required separate drivers to be installed.
54
53
55
54
### Windows
56
55
57
56
On Windows, the drivers can be installed using either of the methods below:
58
57
59
58
1. Install [Code Composer Studio IDE][89] from Texas Instruments.
60
59
61
-
Code Compuser Studio is a free professional-level IDE for Texas Instruments processors. It is fully supported and regularly updated by Texas Instruments. However, it is a large download (> 1 GB), and installs many more packages than are needed if you are just using the Arduino IDE. You are essentially installing a full IDE that you won't be using, just to get the drivers.
60
+
Code Composer Studio is a free professional-level IDE for Texas Instruments processors. It is fully supported and regularly updated by Texas Instruments. However, it is a large download (> 1 GB), and installs many more packages than are needed if you are just using the Arduino IDE. You are essentially installing a full IDE that you won't be using, just to get the drivers.
62
61
63
62
Even with this in mind, **I use this method to install the drivers**, because this way I know they are up-to-date and supported.
64
63
@@ -99,7 +98,7 @@ GCC 9.3 fully supports C++11 and C++14 by default. GCC9.3 is the last MSP430 GCC
99
98
100
99
Having two distinct platform cores allows you to have both compilers installed so that you can easily switch between them. Code which was originally compiled with GCC 4.6 may run into some compatibility issues when compiled with GCC 9.3, as outlined in this [migration README][203].
101
100
102
-
If you install both platforms, be sure to select the correct platform core and board from the Tools->Board menu.
101
+
If you install both platforms, be sure to select the correct platform core and board from the `Tools->Board` menu.
103
102
104
103
Note that the MSP432 and Tiva platforms install GCC 8.3, which fully support C++11 and C++14 by default.
105
104
@@ -293,8 +292,8 @@ The tools are specific to the board package platform and version.
- Note that many of the devices in this package require [additional options][72] as part of the FQBN, for example: `STMicroelectronics:stm32:GenF1:pnum=BLUEPILL_F103C8`
392
+
- Unofficial list of Arduino 3rd Party [Board Manager URLs][68]
390
393
391
394
## License
392
395
@@ -473,8 +476,6 @@ See the file [`LICENSE.txt`][101] in this repository.
[//]: # (This is a way to hack a comment in Markdown. This will not be displayed when rendered.)
520
527
[//]: # (The board download links from energia.nu are not consistently working. Previous link for board msp432r 5.29.0 was: http://energia.nu/downloads/download_core.php?file=msp432r-5.29.0.tar.bz2 )
0 commit comments