Skip to content

Commit 484affe

Browse files
Update software_overview-arduino.md
Update instructions in response to: #5
1 parent 9cf3a83 commit 484affe

File tree

1 file changed

+34
-12
lines changed

1 file changed

+34
-12
lines changed

docs/software_overview-arduino.md

+34-12
Original file line numberDiff line numberDiff line change
@@ -53,10 +53,15 @@ Most users should already be familiar with the Arduino IDE and its use. However,
5353

5454
### Installation
5555
!!! success "Installing the *Ported* Renesas-Arduino Core"
56-
In order to program the RA6M5 Thing Plus in the Arduino IDE, users will need to install the **Renesas-Arduino core**. However, until the [RA6M5 Thing Plus is officially adopted into the Renesas-Arduino core](https://github.com/arduino/ArduinoCore-renesas/pull/290), users need to utilize [our port of the **Renesas-Arduino core**](./assets/SFE-Renesas-Arduino_core.zip).
56+
In order to program the RA6M5 Thing Plus in the Arduino IDE, users will need to install the **Arduino Renesas Portenta board** definitions from the Renesas-Arduino core. However, until the [RA6M5 Thing Plus is officially adopted into the Renesas-Arduino core](https://github.com/arduino/ArduinoCore-renesas/pull/290), users need to utilize [our port of the **Renesas-Arduino core**](./assets/SFE-Renesas-Arduino_core.zip).
5757

58-
1. Before users can install our ported version of the Renesas-Arduino core, they should first install the [*official* Renesas-Arduino core](https://github.com/arduino/ArduinoCore-renesas) in the Arduino IDE.
58+
1. Before users can install our ported version of the Renesas-Arduino core, they should first install the **Arduino Renesas Portenta board** definitions of the [*official* Renesas-Arduino core](https://github.com/arduino/ArduinoCore-renesas) in the Arduino IDE.
5959
- This will ensure that any required compilation and upload tools are installed for the Arduino core.
60+
- In the Board Manager of the Arduino IDE, select and install the **Arduino Renesas Portenta board** definitions from the [Renesas-Arduino core](https://github.com/arduino/ArduinoCore-renesas).
61+
<figure markdown>
62+
[![Install the Renesas-Arduino Core](./assets/img/hookup_guide/arduino-renesas_core.png){ width="400" }](./assets/img/hookup_guide/arduino-renesas_core.png "Click to enlarge")
63+
<figcaption markdown>Installing the [Renesas-Arduino core](https://github.com/arduino/ArduinoCore-renesas) in the Arduino IDE.</figcaption>
64+
</figure>
6065
2. Once installed, users will need to locate the `packages` directory for the Arduino cores in the Arduino IDE:
6166

6267
<div class="grid cards" markdown>
@@ -67,13 +72,13 @@ Most users should already be familiar with the Arduino IDE and its use. However,
6772

6873
On Windows, the directory location may vary based on whether the Arduino IDE was installed for an individual user or all users:
6974

70-
- The user's `AppData` directory *(hidden folder)*:
75+
- The user's `AppData` directory *(hidden folder - primary)*:
7176

7277
C:\Users\{==<insert username>==}\AppData\Local\Arduino15\packages
7378

74-
- The user's `ArduinoData` directory:
79+
- The user's `ArduinoData` directory (*local*):
7580

76-
C:\Users\{==<insert username>==}\Documents\ArduinoData
81+
C:\Users\{==<insert username>==}\Documents\Arduino\hardware
7782

7883
- The `Program Files` or `Program Files(x86)` directories:
7984

@@ -86,13 +91,13 @@ Most users should already be familiar with the Arduino IDE and its use. However,
8691

8792
With Mac OS, users should check the `Applications` and `Library` directories:
8893

89-
- `Applications` directory:
94+
- `Library` directory (primary):
9095

91-
/Applications/Arduino.app/
96+
~/Library/Arduino15/packages/
9297

93-
- `Library` directory:
98+
- `Applications` directory (*local*):
9499

95-
~/Library/Arduino15/packages/
100+
/Applications/Arduino.app/hardware
96101

97102

98103
- **Linux**
@@ -101,14 +106,31 @@ Most users should already be familiar with the Arduino IDE and its use. However,
101106

102107
For Linux, this may be located in the following directories:
103108

109+
- Primary:
110+
111+
/home/$USER/.arduino15/packages
112+
104113
- Local:
105114

106-
/home/$USER/Arduino
115+
/home/$USER/Arduino/hardware
107116

108-
- Downloaded:
117+
??? tip
118+
As mentioned in [Arduino's guide for installing the Arduino IDE on Linux](https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing/#linux), users may need to run the following commands in the terminal:
109119

110-
/home/$USER/.arduino15/packages
120+
```bash
121+
sudo add-apt-repository universe
122+
sudo apt install libfuse2
123+
```
124+
125+
In order to utilize the serial terminal or recognize the board in DFU mode, users may also need to run the following commands in the terminal:
126+
127+
```bash
128+
usermod -a -G dialout $USERNAME
129+
usermod -a -G plugdev $USERNAME
130+
```
111131

132+
- `$USERNAME` is the login username
133+
- After, a restart or logout is required
112134

113135
</div>
114136

0 commit comments

Comments
 (0)