Skip to content

Commit 9a8954b

Browse files
seaxwiseaxwi
committed
Various enhancements based on further testing (WIP)
1 parent 4fb8536 commit 9a8954b

File tree

1 file changed

+99
-48
lines changed

1 file changed

+99
-48
lines changed

‎content/Software Support/PLC IDE/If-youre-having-trouble-connecting-a-device-to-PLC-IDE.md‎

Lines changed: 99 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -3,29 +3,27 @@ title: "If you're having trouble connecting a device to PLC IDE"
33
id: 8824551178780
44
---
55

6-
## Check this first
6+
Learn what do to do if you having an issue using your device with PLC IDE.
77

8-
- If you haven't done so, start by checking the [Arduino PLC IDE Setup and Board's License Activation](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license#instructions) tutorial.
8+
> ![TIP]
9+
> If you're just getting started with PLC IDE, see [Arduino® PLC IDE Setup & Device License Activation](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license/).
910
10-
- Ensure you've installed the latest version of the **Arduino PLC IDE** software.
11+
In this article:
1112

12-
- Ensure that you have full administrative privileges when running PLC IDE.
13+
- [If the PLC IDE installation fails](#if-the-plc-ide-installation-fails)
14+
- [If you can't find the serial port for your device]()
15+
- [If you can't install the runtime](#if-you-cant-install-the-runtime)
16+
- [If you see an error when downloading](#if-you-see-an-error-when-downloading)
17+
- [If there is an issue activating the license](#if-there-is-an-issue-activating-the-license)
1318

14-
- Ensure you use a USB cable that supports data transfer.
15-
16-
- When downloading the runtime, or connecting to the device, ensure you're [targeting the correct port](https://support.arduino.cc/hc/en-us/articles/16724283965596).
17-
18-
- When opening a project created with an earlier version of the PLC IDE, some issues may occur. Try creating a new project (**File > New Project**) to see if this resolves the issue.
19-
20-
- You need **valid license** to download the code to the device:
21-
22-
- Licenses for Portenta Machine Control are [available in the store](https://store.arduino.cc/products/plc-key-portenta-machine-control). Instructions for license activation [are available here](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license#6-license-activation-with-product-key-portenta-machine-control).
19+
---
2320

24-
- Arduino Opta is a pre-licensed product, follow the [activation instructions](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license#7-license-activation-with-pre-licensed-products-opta).
21+
## If the PLC IDE installation fails
2522

26-
---
23+
In this section:
2724

28-
## If PLC IDE installation fails
25+
- ["User cancelled installation"](#user-cancelled-installation)
26+
- ["Fatal error during installation"](#fatal-error-during-installation)
2927

3028
### "User cancelled installation"
3129

@@ -41,45 +39,56 @@ Connect to the internet and try the installation again. The installer requires a
4139

4240
---
4341

44-
## If Manual sketch download fails for setup and re-installation
42+
## If you can't find the serial port for your device{if-you-cant-find-the-serial-port-for-your-device}
4543

46-
### Error: "Cannot download sketch file (error code: 1)"
44+
### If you don't know which port to use
4745

48-
This error may occur when attempting to download the runtime sketch.
46+
[Find the correct port for your device in PLC IDE](https://support.arduino.cc/hc/en-us/articles/16724283965596-Find-the-correct-port-for-your-device-in-PLC-IDE){.link-chevron-right}
4947

50-
Solutions:
48+
### If no COM port is available
5149

52-
1. [Verify that the correct port is selected in the manual sketch download widget.](https://support.arduino.cc/hc/en-us/articles/16724283965596)
53-
54-
1. Double-tap the device’s reset button to put it in bootloader mode. First, try selecting the correct COM port. If that doesn’t work, set the Port to “Automatic (BootLoader)” and attempt to download the sketch again.
50+
Follow these steps:
5551

56-
1. Close any applications blocking the port, such as the Arduino IDE serial monitor.
52+
1. Ensure your device is connected using a working data USB cable.
53+
2. Do a bootloader reset <!-- TODO -->
5754

58-
1. [Reformat the QSPI flash memory](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices)
59-
60-
1. Create a new project and attempt to download the runtime again.
55+
---
6156

62-
### Error: "(DownloadSketch) Can not download sketch: COM port must be used!"
57+
## If you can't install the runtime
6358

64-
This error occurs when no COM port is selected.
59+
In this section:
6560

66-
[Select the correct COM port in the manual sketch download widget](https://support.arduino.cc/hc/en-us/articles/16724283965596) and attempt the download again.
61+
- [If nothing happens when downloading the runtime](#if-nothing-happens-when-downloading-the-runtime)
62+
- [If there is an error when installing the runtime](#if-there-is-an-error-when-installing-the-runtime)
6763

6864
### If nothing happens when downloading the runtime
6965

70-
1. Ensure you've installed the latest version of the Arduino PLC IDE software from the Arduino Software page.
66+
Try selecting the Resources tab in the Output panel.
7167

72-
1. Verify the "T" Folder Exists
68+
1. Under the Output panel, select the **Resources** tab.
7369

74-
`C:\Users\<Profile-Name>\AppData\Local\T`
70+
1. Follow the linked instructions if you see any of these errors:
7571

76-
If you can't find this folder, Copy it from the computer's Admin profile (which requires access authorization, e.g., the admin password) and paste it into the same path on the user profile.
72+
- [Error: "Cannot download sketch file error code: 1"](#error-cannot-download-sketch-file-error-code-1)
73+
- [Cannot generate profile file error message: Error: Path not found](#cannot-generate-profile-file-error-message-error-path-not-found)
74+
75+
1. Ensure you've installed the latest version of the Arduino PLC IDE software from the Arduino Software page.
7776

7877
1. Restart PLC IDE.
7978

79+
### If there is an error when installing the runtime
80+
81+
See the [If you see an error when downloading](#if-you-see-an-error-when-downloading) section.
82+
8083
---
8184

82-
## If there is an issue connecting to a device
85+
## If you can't connect to the device
86+
87+
In this section:
88+
89+
- [If the "On-Line > Set up communications" and "On-line > Connect" options are disabled](#if-the-on-line--set-up-communications-and-on-line--connect-options-are-disabled)
90+
- [Error: “Unable to start the communication”](#error-unable-to-start-the-communication)
91+
8392

8493
### If the "On-Line > Set up communications" and "On-line > Connect" options are disabled
8594

@@ -96,27 +105,69 @@ Choose 'On-line / Set up communication' to configure it
96105

97106
Resolve the issue by selecting **On-line > Set up communication** and checking the settings. See [Connect to the Device](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license#5-connect-to-the-device) for help.
98107

99-
### “Error” in the bottom right corner on first use of the board
108+
---
100109

101-
[Reformat the QSPI flash memory.](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices)
110+
## If you see an error when downloading
102111

103-
---
112+
In this section:
104113

105-
## If there is an issue activating the license
114+
- [Error: "Cannot download sketch file error code: 1"](#error-cannot-download-sketch-file-error-code-1)
115+
- [Cannot generate profile file error message: Error: Path not found](#cannot-generate-profile-file-error-message-error-path-not-found)
116+
- [Error: invalid path creating config dir](#error-invalid-path-creating-config-dir)
117+
- [“Error” in the bottom right corner on first use of the board](#error-in-the-bottom-right-corner-on-first-use-of-the-board)
106118

107-
When activating the license for Arduino Opta or Portenta Machine Control, the following errors may occur:
119+
### Error pop-up: "Cannot download sketch file (error code: 1)"
108120

109-
### Opta
121+
This error may occur when attempting to download the runtime sketch.
110122

111-
After clicking “Activate PLC Runtime”: `Could not activate licenses for the following products: AIPC_Arduino_Opta`
123+
Solutions:
112124

113-
### Portenta Machine Control
125+
1. [Verify that the correct port is selected in the manual sketch download widget.](https://support.arduino.cc/hc/en-us/articles/16724283965596)
114126

115-
- Online activation: `Error #29 activating AlPLC_Arduino_PMC: Generic parameters error`
127+
1. Double-tap the device’s reset button to put it in bootloader mode. First, try selecting the correct COM port. If that doesn’t work, set the Port to “Automatic (BootLoader)” and attempt to download the sketch again.
116128

117-
- Offline activation: `Could not activate licenses for the following products: AIPC_Arduino_PMC`
129+
1. Close any applications blocking the port, such as the Arduino IDE serial monitor.
118130

119-
Solutions:
131+
1. [Reformat the QSPI flash memory](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices)
132+
133+
1. Create a new project and attempt to download the runtime again.
134+
135+
136+
### Cannot generate profile file (error message: Error: Path not found)
137+
138+
If you see this error, it means that the sketch.yaml file is missing from `C:\Users\<Profile-Name>\AppData\Local\T\sketch.yaml`.
139+
140+
### Error: invalid path creating config dir
141+
142+
You may see this error:
143+
144+
`Error: invalid path creating config dir: C:\Users\Sweden UX\AppData\Local\T\A error: mkdir C:\Users\<User>\AppData: Cannot create a file when that file already exists.`
145+
146+
This error can occur when the `arduino-cli.yaml` file is copied from another user.
147+
148+
Do one of the following:
149+
150+
* Delete`arduino-cli.yaml` to use the standard Arduino CLI configuration.
151+
* Open `arduino-cli.yaml` in a text editor and change all paths to use your own user folder.
152+
153+
### “Error” in the bottom right corner on first use of the board
154+
155+
Follow these steps:
156+
157+
1. In the Output panel, open the **Resources** tab and check for error messages.
158+
2. [Reformat the QSPI flash memory.](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices)
159+
160+
---
161+
162+
## If there is an issue activating the license
163+
164+
When activating the license you may see one of these errors:
165+
166+
* `Could not activate licenses for the following products: AIPC_Arduino_Opta`
167+
* `Error #29 activating AlPLC_Arduino_PMC: Generic parameters error`
168+
* `Could not activate licenses for the following products: AIPC_Arduino_PMC`
169+
170+
Try the following:
120171

121172
- Upload the [Memory Partitioning sketch](https://docs.arduino.cc/tutorials/opta/memory-partitioning/) using Arduino IDE. Then, try to activate the license again.
122173

@@ -128,7 +179,7 @@ Solutions:
128179

129180
1. Attempt the license activation process again.
130181

131-
> [!NOTE]
132-
> Corporate networks and security programs may interfere with license activation. Disabling these temporarily can help complete the process.
182+
> [!NOTE]
183+
> Corporate networks and security programs may interfere with license activation. Disabling these temporarily can help complete the process.
133184
134185
<!-- markdownlint-disable-file HC001 -->

0 commit comments

Comments
 (0)