Filter results by

Setting Up the Terminal Console

You're probably anxious to set up the communications link to your ARTIK board. But before we delve into the topic at hand, let's clarify what we mean by "communicate".

Serial Port – When you communicate with ARTIK to type commands and check status, you do it over a serial port. The USB "debug" connector is used for this purpose, and you'll talk over it using a text-based "terminal emulator" program running on your PC.

The built-in serial console of the ARTIK IDE is a good choice for this. You'll use it to view:

  • Linux shell on ARTIK 5 & 7 Linux-based modules. You can view the Linux boot logs, and use the shell to connect to Wi-Fi or perform other operations.

  • Tizen RT shell on ARTIK 05x modules. You can view the Tizen RT boot log and output from application programs, and can also access the TASH prompt.

Network Connection – When other devices communicate with ARTIK, they do it over a wired (Ethernet) network connection or one of many wireless choices (Wi-Fi®, ZigBee®, Bluetooth®, etc.).

  • Once ARTIK Linux modules are connected to a network, you can remotely access the shell by network connection via telnet or SSH.

  • You'd need to go to the Ethernet and Wi-Fi article to set up such a device-to-device channel. But we won't do that right away.

For now, let's just focus on getting you connected, using the ARTIK IDE terminal console.

You cannot use an HDMI display and keyboard attached to the USB OTG connector for debug or for monitoring flash update of your OS.

These instructions cover terminal console setup for ARTIK 5, 7, 10, and 05x series modules. If you arrived here from Getting Started, you can then return and start Tutorials for your module.

The ARTIK 020 and 030 modules use a different development environment; go to the ARTIK 020/030 Getting Started article and follow the links to your device.

Communicating with ARTIK (Windows)

You'll first identify the COM port, then configure the ARTIK IDE (and optionally, PuTTY) to use it.

Identify the COM port

You'll need to determine the COM port number assigned to your board. Start with the USB cable unattached, then watch Device Manager to see which device appears when you plug it in.

  1. Open Device Manager in the Control Panel.

    Click Start.


    Type “device manager” and Enter.

  2. Check the COM port number when you connect a USB serial cable to the PC. (If the COM port connection is not detected, you may need to power on the ARTIK board.)

ARTIK 5/7/10 ARTIK 053

For ARTIK 053 you'll find two COM ports.
The higher-numbered one is for the debug serial port.

Troubleshooting Tip. Does the port not install, or install with an error as FT232R USB UART?

Update COM Port Drivers
  1. Browse to the ARTIK_IDE_Installation_Directory\tools directory.
  2. Run the zadig-2.3.exe application.
  3. Under Options, select List All Devices.
  4. Under the devices drop-down list, select
    -- for ARTIK 5/7/10: FT232R USB UART
    -- for ARTIK 05x: Interface 1 of the dual COM port interfaces.
  5. Update the driver to the WinUSB driver by clicking Replace Driver.
ARTIK 5/7/10ARTIK 05x

Set up the ARTIK IDE integrated console

With the ARTIK IDE installed and running, you'll need to set up the COM port in its terminal emulator application. Open a serial terminal emulator console as follows.

  1. Select Windows » Show View » Console to open the console view in the lower right part of the IDE.

  2. Create a new Command Shell Console by clicking the drop down icon shown.

  3. Select the Connection Type to Serial Port. Create a new Connection name with the options as shown below; specify the correct COM port.

When you reset the board, you should see boot messages on the console view. If prompted to log in, use:
   login: root
   password: root

Linux Tizen RT

You've completed the COM port assignment. You won't need to revisit this procedure unless you plug your board into a different USB port.

Using the Console port

You'll need to run through these steps each time you want to open the console for use.

  1. Open a Console View by selecting Windows » Show View » Console.
  2. Create a new Command Shell Console, and select a port using the connection name you set up previously.
  3. Use the pull-down icon shown to select among multiple Eclipse console views (build and load status, debug tool, serial interface to your ARTIK board).

Create multiple console windows by opening a new command shell console and dragging its tab to a position elsewhere on the screen.

All good? Great! You're ready for the Tutorials.

Optional: Set Up PuTTY

Install PuTTY. Windows users may optionally install and configure PuTTY, a free serial console program.

  1. Download PuTTY and install it according to instructions.

  2. Set the PuTTY configuration as follows:
    -- Serial line is the COM port number found previously.
    -- Set speed to "115200".
    -- Set connection type to "Serial".
    -- Name and save the session.
    Next time, you can just double-click on the saved session name.
  3. Click "Open". Initially, the resulting screen will be blank.
  4. Reset the board. The ARTIK module will now go through the boot sequence.
    Troubleshooting Tip. No display? Refer to the No Display section.
  5. When prompted to log in, use:
       login: root
       password: root

You should see something like this:

Communicating with ARTIK (Mac)

Once the serial connector is attached and the board is powered on, Mac users can follow these instructions.

Identify the serial port

From your development system, you'll need to determine the serial port number assigned to your board.

In Terminal, go to /dev and look for an entry like this tty.usbserial-XXXXXXXX, where "XXXXXXXX" is a unique identifier (e.g., tty.usbserial-AI02ZWTO). This is the serial connection to the development board.

Set up ARTIK IDE integrated console

With the ARTIK IDE installed and running, you'll need to set up the serial port in its terminal emulator application. Open a serial terminal emulator console as follows.

  1. Select Windows » Show View » Console to open the console view in the lower right part of the IDE.

  2. Create a new Command Shell Console by clicking the drop down icon shown.

  3. Select the Connection Type to Serial Port. Create a new Connection name with the options as shown below; specify the correct serial port.

When you reset the board, you should see boot messages on the console view. If prompted to log in, use:
   login: root
   password: root

Linux Tizen RT

You've completed the serial port assignment. You won't need to revisit this procedure unless you plug your board into a different USB port.

Optional: Screen or Minicom

Install Screen or Minicom. You can optionally set up one of these free programs to listen to the specified device port and provide a serial console. Follow the instructions below to install and run either program. All commands shown are entered at the command prompt of the Linux host system, except as noted.

Install Screen

Install Screen using:
$ sudo apt-get install screen

Start Screen as superuser.
$ sudo screen /dev/ttyUSB0 115200 cs8 ixoff

Login instructions are below.

Install Minicom

Install Minicom using:
$ sudo apt-get install minicom

Configure Minicom, first time only.

  1. Start Minicom in configuration mode.
    $ sudo minicom –o –s

  2. Using the alphabet letters indicated, select serial port settings to change.

  3. Press [Enter] by itself to leave this screen.
  4. Select 'Save setup as dfl', and then select 'Exit' from Minicom.

Start Minicom as superuser.
$ sudo minicom


Log In (Screen or Minicom)

Once you have connected using Minicom or Screen, the display window will initially be blank.

  1. Reset the board. The ARTIK module will now go through the boot sequence.
    Troubleshooting Tip. No display? Refer to the No Display section.
  2. When prompted to log in, use:
       login: root
       password: root

For Linux, you should see something like this:

Mac Users

You can use Screen with the Mac by issuing the command in this format (replace `XXXXXXXX` with the correct ID):
$ screen /dev/tty.usbserial-XXXXXXXX 115200

Initially, the resulting screen will be blank. Reset the board. The ARTIK module will now go through the boot sequence.

When closing the connection, use \<Ctrl-A\> followed by \<Ctrl-\\\> to kill all windows and cleanly terminate Screen.

Troubleshooting Tip: If it is still not properly released, preventing a new instance from reconnecting, try killing the previous instance with pkill SCREEN, or using -R to open, as in: $ screen –R /dev/tty.usbserial-XXXXXXXX 115200

All good? Great! You're ready for the Tutorials.

Communicating with ARTIK (Linux)

You'll first identify the COM port, then configure the ARTIK IDE (and optionally, Screen or Minicom) to use it.

Identify the serial port

From your development PC, you'll need to determine the serial port number assigned to your board. Start with the USB cable unattached.

Use the following command to find the port name.

$ dmesg | tail | grep tty

For USB serial devices, this command returns something like ttyUSB* after plugging in the USB cable (we'll show ttyUSB0 throughout this example).

Note: If your Linux development is by way of VirtualBox, you'll need to transfer control of the USB port to be able to see the serial port.

Set up ARTIK IDE integrated console

With the ARTIK IDE installed and running, you'll need to set up the serial port in its terminal emulator application. Open a serial terminal emulator console as follows.

  1. Select Windows » Show View » Console to open the console view in the lower right part of the IDE.

  2. Create a new Command Shell Console by clicking the drop down icon shown.

  3. Select the Connection Type to Serial Port. Create a new Connection name with the options as shown below; specify the correct serial port.

When you reset the board, you should see boot messages on the console view. If prompted to log in, use:
   login: root
   password: root

Linux Tizen RT

You've completed the serial port assignment. You won't need to revisit this procedure unless you plug your board into a different USB port.

All good? Great! You're ready for the Tutorials.

Optional: Screen or Minicom

Install Screen or Minicom. You can optionally set up one of these free programs to listen to the specified device port and provide a serial console. Follow the instructions below to install and run either program. All commands shown are entered at the command prompt of the Linux host system, except as noted.

Install Screen

Install Screen using:
$ sudo apt-get install screen

Start Screen as superuser.
$ sudo screen /dev/ttyUSB0 115200 cs8 ixoff

Login instructions are below.

Install Minicom

Install Minicom using:
$ sudo apt-get install minicom

Configure Minicom, first time only.

  1. Start Minicom in configuration mode.
    $ sudo minicom –o –s

  2. Using the alphabet letters indicated, select serial port settings to change.

  3. Press [Enter] by itself to leave this screen.
  4. Select 'Save setup as dfl', and then select 'Exit' from Minicom.

Start Minicom as superuser.
$ sudo minicom


Log In (Screen or Minicom)

Once you have connected using Minicom or Screen, the display window will initially be blank.

  1. Reset the board. The ARTIK module will now go through the boot sequence.
    Troubleshooting Tip. No display? Refer to the No Display section.
  2. When prompted to log in, use:
       login: root
       password: root

For Linux, you should see something like this:

Mac Users

You can use Screen with the Mac by issuing the command in this format (replace `XXXXXXXX` with the correct ID):
$ screen /dev/tty.usbserial-XXXXXXXX 115200

Initially, the resulting screen will be blank. Reset the board. The ARTIK module will now go through the boot sequence.

When closing the connection, use \<Ctrl-A\> followed by \<Ctrl-\\\> to kill all windows and cleanly terminate Screen.

Troubleshooting Tip: If it is still not properly released, preventing a new instance from reconnecting, try killing the previous instance with pkill SCREEN, or using -R to open, as in: $ screen –R /dev/tty.usbserial-XXXXXXXX 115200

No Display

Do you only see a blank screen after you try to start ARTIK using the POWER push-button switch?

  • Try pressing RESET. The POWER button works only once, after initial power-on. Maybe you pressed POWER before the terminal emulator was connected.
  • Make sure your module is properly seated in the socket. Turn the power off, press the module firmly into the socket, turn power on again and press POWER.
  • Make sure your board is not trying to boot from the SD card. That is, all DIP switch positions should be OFF for
    – ARTIK 520 and 1020: SW2
    – ARTIK 530: SW402
    – ARTIK 710: SW402 (but for board revisions prior to 1.0, leave SW4-3 ON)
  • For ARTIK 1020 version V3.2: Refer to the image here to check the correct jumper settings on J20 and J36.

Last updated on: