1°/ Under Linux
1.1°/ port not detected by the OS
Case: the dev. board is plugged but there is not port /dev/ttyACMX or /dev/ttyUSBX taht is detected by arduino
- some computers have special USB sockets (ss-usb) that are sometimes not well managed by Linux. Try to plug the USB cable on another socket.
- If there is still the problem, mainly under Ubuntu, there may be a conflict with the application brltty, which makes the port creation fail. To remove brltty : sudo apt-get remove brltty
- If you have a more "exotic" distribution (like ArchLinux, Mint, ...), it is possible that the chipset driver to setup the serial-usb communication is not installed. In that cas, change of OS :-) ... Or, go into the documentation of the dev. board to find what chipset is used, and then find the appropriate drviers. For example, the dev. board TTGO T8 uses a chipset CP2104, and the Lolin D1 mini R2 uses a CH340
1.2°/ unable to upload a sketch
Case: compiling the sketch is ok, but uploading the result fails.
There are many possible causes but the main are :
- if the error message indicates that it cannot find python3, it must be installed: apt-get install python3
- if the error message contains the word "serial", it is possible that the python module to do serial communication is missing. To install it: apt-get install python3-serial
- if the error message indicates that it cannot find the upload port, meanwhile arduino detects it, (e.g. "port /dev/ttyACM0 does not exists"), you are certainly not in the user group dialout. To add you:
- as root, open the file /etc/group
- find a line with dialout:x:...: . Dans certaines distributions linux (Arch, manjaro, ...), c'est plutôt uucp:x:...:
- after the last : add your login, then save the file
- close your session, then relog (or event reboot)
2°/ Under Windows
It is quite rare that arduino does not work straight forward under windows. Nevertheless, here are some possible problems:
2.1°/ Impossible to download SDK, board manager, ...
Case: when arduino starts, it cannot download SDK for esp8266/esp32, or libraries.
It surely means that your network access is off (or limited), or that the windows firewalls blocks the execution of the arduino download manager.
2.2°/ cannot find cmd.exe
Your PATH variable does not contain the directory C:\Windows\System32, in which is stored cmd.exe
- to modigy PATH, type path in the research bar, and choose "Modify environnement variables" (or something similar)
- The window that opens must contain a button "Environnement Variable", which itself opens a dialog to modify/add variables for the suer and the system.
- In the system part, clic on PATH and then Modify. A third window opens where you can type a path, in the present case C:\Windows\System32
2.3°/ pas de port COMx
Case: Windows does not create a port COMx when the dev. board is plugged
- Generally, it is because the driver of the usb-serial chipset is not installed.
- In that case, go into the documentation of the dev. board to find what chipset is used, and then find the appropriate drivers. For example, the dev. board TTGO T8 uses a chipset CP2104, and the Lolin D1 mini R2 uses a CH340