Filter results by

Communicating with ARTIK

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. You'll use a text-based Terminal Emulator program, which will run from your PC.

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 just yet.

For now, let's just focus on getting you connected. Start in the section below if you use a Windows® PC, or click to go to the Mac® or Linux sections. When finished, you're ready for the Tutorials.

Activation and Reset

Initial Activation. After you first apply power, you'll need to activate the board with a 1-second reset pulse using the POWER push-button switch – located as shown for the different ARTIK boards. Wait until the instructions below tell you to push it.

ARTIK 530 and 710 POWER (SW2) ARTIK 520 and 1020 POWER (SW3)

Normal Restart. Once the POWER circuit has been activated, pushing it again has no effect. Use the reboot command to restart. Doing so ensures that files are properly closed before restart commences.

Normal Shutdown. For an orderly power-down sequence, use the shutdown now command.

Forced Restart. The RESET button (located below the ARTIK 520 and 1020 power jack, or next to the ARTIK 530 and 710 POWER button) forces the module to restart.

File Corruption Warning. Using the RESET button may leave pending disk writes incomplete.

ARTIK 520 and 1020 Board Developers: When you design a circuit to replace the POWER button, be aware that the ARTIK 520 and 1020 modules expect a reset pulse.

Leaving the signal active all the time would result in endless reset cycles.

ARTIK 530 and 710 Board Developers: The ARTIK 530 and 710 modules require a minimum 1-second active signal on their POWER input, but do not demand a pulse. That is, the signal can be left active if desired. Jumper J19 is provided to demonstrate this feature – if you install it, the board will boot as soon as you apply power.

Communicating with ARTIK (Windows)

We recommend that Windows users install PuTTY, a free serial console program.

PuTTY configuration screen

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

  1. Open Device Manager in the Control Panel.
    • Click Start

    • In 'Search programs and files' type “Device Manager”

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

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

  3. Set the PuTTY configuration as follows:
    • Serial line is the COM port number found in Step 2.
    • 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.

  4. Click "Open". Initially, the resulting screen will be blank.
  5. Activate the board by pressing and holding the POWER push-button switch for 1 second. The ARTIK module will now go through the boot sequence.

    Troubleshooting Tip. No display? See Troubleshooting below.

  6. When prompted to login, use:

    login: root
    password: root

  7. You should see something like this:

    after login

All good? Great! Let's do one last check before heading to the Tutorials.

Communicating with ARTIK (Mac)

Once the serial connector is attached and the board is powered on, Mac users can follow these instructions instead of using PuTTY:

  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. Activate the board by pressing and holding the POWER push-button switch for 1 second. The ARTIK module will now go through the boot sequence.

    Troubleshooting Tip. No display? See Troubleshooting below.

  4. When prompted to login, use:

    login: root
    password: root

  5. You should see something like this:

    after login

  6. 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! Let's do one last check before heading to 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. Activate the board by pressing and holding the POWER push-button switch for 1 second. The ARTIK module will now go through the boot sequence.

    Troubleshooting Tip. No display? See Troubleshooting below.

  2. When prompted to log in, use:

    login: root
    password: root

  3. You should see something like this:

All good? Great! Let's do one last check before heading to the Tutorials.

Troubleshooting

Does PuTTY 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.

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: