Filter results by

Setting Up the Terminal Emulator Program

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 give Linux® 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 console of the ARTIK IDE is a good choice for this.

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 you get deeper into the Tutorials, you will need to go to the Ethernet and Wi-Fi article to set up such a device-to-device channel. But not right away.

For now, let's just focus on getting you connected.

These instructions cover terminal emulator setup for ARTIK 5, 7, 10, and 053 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.

You may need drivers for the USB serial port. You can find the drivers here.

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

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. Log in to your ARTIK board if needed.

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

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

  1. Download PuTTY and install it according to instructions.

    PuTTY configuration screen

  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

For Linux, you should see something like this:

after login

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

Troubleshooting

Does the terminal emulator fail to find a usable COM port, with Device Manager showing a COM port that says something other than "USB Serial Port (COMx)", like "FT232R USB UART"?

  • If you cannot get Windows to recognize the USB port correctly, try downloading the appropriate Windows drivers at the FTDI site.

Communicating with ARTIK (Mac)

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

  1. 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.

  2. You can interact with the ARTIK module in Terminal by issuing the following command (replace XXXXXXXX with the correct ID):

    $ screen /dev/tty.usbserial-XXXXXXXX 115200

    Initially, the resulting screen will be blank.

  3. Reset the board. The ARTIK module will now go through the boot sequence.
    Troubleshooting Tip. No display? Refer to the No Display section.

  4. When prompted to log in, use:
       login: root
       password: root

For Linux, you should see something like this:

after login

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)

We recommend Linux users install 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.

Port Name

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).

Screen

Install Program

Install Screen using:

$ sudo apt-get install screen

Start Program

Start Screen as superuser.

$ sudo screen /dev/ttyUSB0 115200 cs8 ixoff

Login instructions are below.

Minicom

Install Program

Install Minicom using:

$ sudo apt-get install minicom

Configure Program (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 Program

Start Minicom as superuser.

$ sudo minicom

Login (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:

All good? Great! You're ready for the Tutorials. Advanced users may want to jump directly to Linux development environment setup for ARTIK 053 or ARTIK 5/7.

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: