FAQ

Arduino Nano/Uno/Mega is not detected¶

When you runarduino-cli board list, your board doesn't show up. Possible causes:

• Your board is a cheaper derivative, or
• It's a board, such the classic Nano, that uses a USB to serial converter like FTDI FT232 or CH340. These chips always report the same USB VID/PID to the operating system, so the only thing we know is that the board mounts that specific USB2Serial chip, but we don’t know which board that chip is on.

What's the FQBN string?¶

FQBN stands for Fully Qualified Board Name. It has the following format:VENDOR:ARCHITECTURE:BOARD_ID[:MENU_ID=OPTION_ID[,MENU2_ID=OPTION_ID ...]], with eachMENU_ID=OPTION_ID being anoptional key-value pair configuration. TheVENDOR andARCHITECTURE parts can be empty. For a deeper understanding ofhow FQBN works, you should understand theArduino platform specification.

How to set multiple board options?¶

Additional board options have to be separated by commas (instead of colon):

$ arduino-cli compile --fqbn "esp8266:esp8266:generic:xtal=160,baud=57600" TestSketch

Where is the Serial Monitor?¶

The serial monitor is available through themonitor command. By the way, the functionality providedby this command is very limited and you may want to look for other tools if you need more advanced functionality.

There are many excellent serial terminals to chose from. On Linux or macOS, you may already havescreen installed. OnWindows, a good choice for command line usage is Plink, included withPuTTY.

How to change monitor configuration?¶

Configuration parameters of the monitor can be obtained by executing the following command:

$ arduino-cli monitor -p <port> --describe

These parameters can be modified by passing a list of<key>=<desiredValue> pairs to the--config flag. For example,when using a serial port, the monitor baud rate can be set to 4800 with the following command:

$ arduino-cli monitor -p <port> --config baudrate=4800

"Permission denied" error in sketch upload¶

This problem might happen on some Linux systems, and can be solved by setting up serial port permissions. First, searchfor the port your board is connected to, with the command:

$ arduino-cli board list

Then add your user to the group with the following command, replacing<username> with your username and<group> withyour group name. Logging out and in again is necessary for the changes to take effect.

$ sudo usermod -a -G <group> <username>

Additional assistance¶

If your question wasn't answered, feel free to ask onArduino CLI's forum board.