Skip to content

Commit ba11318

Browse files
draft
1 parent f26712c commit ba11318

File tree

2 files changed

+104
-48
lines changed

2 files changed

+104
-48
lines changed
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
title: "Identifying the correct Serial Port for your PLC device"
3+
id: 16724283965596
4+
---
5+
6+
When multiple devices are connected to your computer, it's essential to identify which serial ports belong to your PLC device. Follow these steps to determine the correct port:
7+
8+
1. Disconnect your PLC device from your computer.
9+
1. Select **Project > Refresh current target** to refresh the list of ports.
10+
1. Open the runtime sketch download port menu, and take note of the available ports.
11+
12+
![The runtime download widget.](img/plc-ide-runtime-ports.png)
13+
14+
1. Connect your PLC device.
15+
1. Again, select **Project > Refresh current target** to refresh the list of ports.
16+
1. Open the runtime sketch download port menu, and take note of any new ports.
17+
18+
## Using Device Manager to Find Serial Ports
19+
20+
1. Open the Device Manager.
21+
1. Select **View > Devices by container**.
22+
1. Look for an **Arduino Opta** or **Portenta H7 MCUboot** container.
23+
1. Click to expand the container:
24+
25+
![Arduino Opta ports in Device Manager.](img/device-manager.png)
26+
27+
1. Look for **USB Serial Device** items, and note the port names.

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

Lines changed: 77 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ id: 8824551178780
1313

1414
- Ensure you use a USB cable that supports data transfer.
1515

16-
- When downloading the runtime, or connecting to the device, ensure you're [targeting the correct port](#about-ports).
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).
1717

1818
- 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.
1919

@@ -25,83 +25,112 @@ id: 8824551178780
2525

2626
---
2727

28-
## About port selection
28+
## Troubleshooting common issues
2929

30-
It's important to understand which ports to target when configuring your PLC device connection.
30+
### Installing PLC IDE
3131

32-
### How to identify which ports belong to your device
32+
- **"User cancelled installation"**
3333

34-
If other devices connected to your computer have open serial ports, you need to determine which ports belong to your PLC device:
34+
This error occurs when the installation is interrupted before the Arduino IDE Tools Setup Wizard completes.
3535

36-
1. Disconnect your PLC device from your computer.
37-
1. Select **Project > Refresh current target** to refresh the list of ports.
38-
1. Open the runtime sketch download port menu, and take note of the available ports.
36+
Restart the installation process and ensure that you allow the Setup Wizard to finish without interruption.
3937

40-
![The runtime download widget.](img/plc-ide-runtime-ports.png)
38+
- **"Fatal eror during installation"**
4139

42-
1. Connect your PLC device.
43-
1. Again, select **Project > Refresh current target** to refresh the list of ports.
44-
1. Open the runtime sketch download port menu, and take note of any new ports.
40+
This error typically appears when attempting to install the PLC IDE without an internet connection.
4541

46-
You can also use the **Device Manger** in Windows:
42+
Connect to the internet and try the installation again. The installer requires an active connection to download necessary components.
4743

48-
1. Open the Device Manager.
49-
1. Select **View > Devices by container**.
50-
1. Look for an **Arduino Opta** or **Portenta H7 MCUboot** container.
51-
1. Click to expand the container:
44+
---
45+
46+
### Download the runtime
47+
48+
- **"Error: Cannot download sketch file (error code: 1)"**
49+
50+
This error may occur when attempting to download the runtime sketch.
51+
52+
Solutions:
53+
- [Verify that the correct port is selected in the manual sketch download widget.](https://support.arduino.cc/hc/en-us/articles/16724283965596)
54+
55+
- 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.
56+
57+
- Close any applications that might be blocking the port, such as the Arduino IDE serial monitor.
58+
59+
- [Reformat the QSPI flash memory](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices)
60+
61+
- Create a new project and attempt to download the runtime again.
62+
63+
- **"Error: "(DownloadSketch) Can not download sketch: COM port must be used!""**
64+
65+
This error occurs when no COM port is selected.
5266

53-
![Arduino Opta ports in Device Manager.](img/device-manager.png)
67+
[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.
5468

55-
1. Look for **USB Serial Device** items, and note the port names.
69+
- **If nothing happens when downloading the runtime sketch**
70+
71+
- Ensure you've installed the latest version of the Arduino PLC IDE software from the Arduino Software page.
72+
73+
- Verify the "T" Folder Exists
74+
75+
`C:\Users\<Profile-Name>\AppData\Local\T`
76+
77+
If you can't find this folder, Copy it from the computers Admin profile (which requires access authorization e.g. admin password), and then pasting it in the same path on the user profile.
78+
79+
- Restart PLC IDE.
5680

5781
---
5882

59-
## Solutions for specific problems
83+
### Connect to device
84+
85+
- **If the "On-Line > Set up communications" and "On-line > Connect" options are disabled**
6086

61-
### If the "On-Line > Set up communications" and "On-line > Connect" options are disabled
87+
These options are only available when a project is open. Select **File > New Project** to create a new project.
6288

63-
These options are only available when a project is open. Select **File > New Project** to create a new project.
89+
- **Error: “Unable to start the communication”**
6490

65-
### Error: “Unable to start the communication”
91+
When choosing **On-line > Set up communications** you may get this error message:
6692

67-
When choosing **On-line > Set up communications** you may get this error message:
93+
```
94+
Unable to start the communication
95+
Choose 'On-line / Set up communication' to configure it
96+
```
97+
98+
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.
99+
100+
- **“Error” in bottom right corner on first use of the board**
101+
102+
[Reformat the QSPI flash memory.](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices)
103+
104+
---
68105

69-
```
70-
Unable to start the communication
71-
Choose 'On-line / Set up communication' to configure it
72-
```
106+
### License activation
73107

74-
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.
108+
When activating the license for Arduino Opta or Portenta Machine Control, the following errors may occur:
75109

76-
### Error: Cannot download sketch file (error code: 1)
110+
- **Opta**
77111

78-
When downloading the runtime sketch, you may get this error:
112+
After clicking “Activate PLC Runtime”:
113+
`Could not activate licenses for the following products: AIPC_Arduino_Opta`
79114

80-
```
81-
Cannot download sketch file (error code: 1)
82-
```
115+
- **Portenta Machine Control**
83116

84-
Follow these steps:
117+
Online activation: `Error #29 activating AlPLC_Arduino_PMC: Generic parameters error`
85118

86-
1. Double-tap the reset button on the device to set it to **bootloader mode**, and try downloading the sketch again.
87-
2. Close any applications that may be blocking the port, such as the serial monitor in Arduino IDE.
88-
3. [Check the port selection](#about-ports).
119+
Offline activation: `Could not activate licenses for the following products: AIPC_Arduino_PMC`
89120

90-
### If nothing happens when downloading the runtime sketch
121+
Solutions:
91122

92-
<!-- NOTE: Since missing PLC IDE Tools was the only known cause of this issue, it may no longer be relevant. -->
123+
- Upload the [Memory Partitioning sketch](https://docs.arduino.cc/tutorials/opta/memory-partitioning/) using Arduino IDE. Then, try to activate the license again.
93124

94-
1. Ensure you've installed the latest version of the **Arduino PLC IDE** software from the [Arduino Software page](https://www.arduino.cc/en/software#arduino-plc-ide).
95-
2. Restart PLC IDE.
125+
- If you are using a company-owned computer, please follow these steps:
96126

97-
### Error: "(DownloadSketch) Can not download sketch: COM port must be used!"
127+
1. Temporarily disable any antivirus software running on your system.
98128

99-
When downloading the runtime sketch, this error may appear in the console:
129+
1. Temporarily disable the firewall on your computer.
100130

101-
```
102-
(DownloadSketch) Can not download sketch: COM port must be used!
103-
```
131+
1. Attempt the license activation process again.
104132

105-
It can occur if the wrong port is selected in the manual sketch download widget. If you're unsure which port to use, see [About ports in PLC IDE](#about-ports).
133+
> [!NOTE]
134+
> Corporate networks and security programs can sometimes interfere with license activation. By temporarily disabling these protective measures, you may be able to complete the activation successfully.
106135
107136
<!-- markdownlint-disable-file HC001 -->

0 commit comments

Comments
 (0)