Filter results by

Set Up the ARTIK IDE

The ARTIK Integrated Development Environment (IDE) makes for easy application development on ARTIK modules. The installer includes all software SDK packages, tools, and drivers required to build and debug applications.

Install the ARTIK IDE. Initially, we'll just use its terminal emulator interface to your ARTIK board. Then, once you have a chance to play with the command line interface, we'll show you how to use the IDE to compile and run your first application.

Step 1. Click the tab for ARTIK IDE setup instructions for your OS.

ARTIK IDE Installation under Windows

The ARTIK IDE is a breeze to install, configure, and use. Install as described below, then follow the subsequent articles to configure the terminal emulator and to use the IDE for a Linux or Tizen RT project.

Installing ARTIK IDE

We recommend that Windows users install the ARTIK IDE. As part of its complete development environment, it integrates a convenient terminal emulator program that you can start using right away to talk to your ARTIK board.

System Requirements
– Microsoft Windows 7/8/10 (64-bit)
– 3 GB RAM minimum, 8 GB recommended
– 2.5 GB disk space minimum, 5 GB recommended
– 1280 x 800 screen resolution

Installing the IDE. The ARTIK IDE installation on your development PC enables creation of a binary file that runs on your target ARTIK board. It has been tested on Windows 7, 8, and 10.

Download Installer

Install the ARTIK IDE on your development system by downloading and running the installer package. If you already installed the ARTIK IDE for one ARTIK module type, you do not need to install it again.

  1. Accept the license agreement. Upon launching the installer, you will be presented with the ARTIK IDE license agreement. Read it through and accept to proceed.

  2. Specify the location. Specify the installation directory for the IDE using Browse, or accept the default directory location. Ensure there are no spaces in the directory path name. Click Next to proceed.

  3. Proceed with installation. The installer will display the installation location. If there is no further change, click Install to install the IDE and tools. The installation can take as little as 5 minutes, but may take much longer, depending on the system. Click Finish to complete the procedure.

  4. Install SDKs. On the initial run, the IDE will ask you to install the Software Development Kits (SDKs) of interest, corresponding to the devices you plan to use. Simply check the boxes next to the releases you want to install (typically just the newest). Also check the boxes next to the toolchains (check all available if unsure of which you'll need).

    You'll be able to repeat this process at any time, or check for updates, as shown in the Updating ARTIK SDK article.

    Note: You must be connected to the Internet, or you will see this message.

    If that happens, go to the Updating ARTIK SDK article once you have re-established a connection.

Running the IDE. Each time you want to open the ARTIK IDE:

  • Locate and run the installed ARTIK IDE program.

Go ahead now to terminal emulator setup. When finished, you'll be ready for the Tutorials.

ARTIK IDE Installation under Linux

The ARTIK IDE is a breeze to install, configure, and use. Install as described below, then follow the subsequent articles to configure the terminal emulator and to use the IDE for a Linux or Tizen RT project.

Installing ARTIK IDE

We recommend that Linux users install the ARTIK IDE. As part of its complete development environment, it integrates a convenient terminal emulator program that you can start using right away to talk to your ARTIK board.

System Requirements
– Ubuntu-14 x64 16.04 (64-bit)
– 3 GB RAM minimum, 8 GB recommended
– 2.5 GB disk space minimum, 5 GB recommended
– 1280 x 800 screen resolution

Installing the IDE. The ARTIK IDE installation on your development PC enables creation of a binary file that runs on your target ARTIK board. You can download the installer package to your desktop and be up and running in no time. If you already installed the ARTIK IDE for one ARTIK module type, you do not need to install it again.

  1. Using a Linux terminal window, add the necessary support packages.
    sudo dpkg --add-architecture i386
    sudo apt-get update
    sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 zlib1g:i386

  2. If using an ARTIK 053 board, also read the additional A053 information.

  3. Download the installation package. If you're reading this using your Linux-based browser, click below to download the package right to your Linux Home directory.

    Download Installer

  4. Double-click on the package to open it with Archive Manager.

  5. Click Extract to produce a .run file, and move the extracted file to a new directory of your choice.

  6. Double-click on the .run file icon to begin.

  7. Accept the license agreement. Upon launching the installer, you will be presented with the ARTIK IDE license agreement. Read it through and accept to proceed.

  8. Specify the location. Specify the installation directory for the IDE using Browse, or accept the default directory location. Ensure there are no spaces in the directory path name. Click Next to proceed.

  9. Proceed with installation. The installer will display the installation location. If there is no further change, click Install to install the IDE and tools. The installation can take as little as 5 minutes, but may take much longer, depending on the system.

  10. Launch the ARTIK IDE. Once the installer is done, allow it to launch the IDE.

  11. Install SDKs. On its initial run, the IDE will ask you to install the Software Development Kits (SDKs) of interest, corresponding to the devices you plan to use. Simply check the boxes next to the releases you want to install (typically just the newest). Also check the boxes next to the toolchains (check all available if unsure of which you'll need).

    You'll be able to repeat this process at any time, or check for updates, as shown in the Updating ARTIK SDK article.

    Note: You must be connected to the Internet, or you will see this message.

    If that happens, go to the Updating ARTIK SDK article once you have re-established a connection.

Running the IDE. Each time you want to open the ARTIK IDE:

  1. Go to the IDE/v1 subdirectory of the directory where you installed the IDE.
  2. Double-click on the artik_ide icon.

  3. Click on the Workbench icon to enter the IDE.

Go ahead now to terminal emulator setup. When finished, you'll be ready for the Tutorials.

Additional information for ARTIK 053 only

Configure USB permissions on Linux

The first time you connect an ARTIK 053 board to your Linux PC, you need to add new rules in udev. Otherwise, when you try to flash a new image with regular user rights in the ARTIK IDE, openocd access might fail for lack of superuser rights.

1. Copy the entire rule below and paste it into a terminal window command line.

1
2
3
sudo tee /etc/udev/rules.d/99-artik051-evalboard.rules << __EOF__
SUBSYSTEMS=="usb",ATTRS{idVendor}=="0403",ATTRS{idProduct}=="6010",MODE="0666" RUN+="/sbin/modprobe ftdi_sio" RUN+="/bin/sh -c 'echo 0403 6010 > /sys/bus/usb-serial/drivers/ftdi_sio/new_id'"
__EOF__

2. Trigger the rule.

sudo udevadm trigger

Configure Tizen RT

By default, the ARTIK IDE build environment provides configurations of 'typical', 'extra', etc. that fit most applications. As an option, you can create and name custom configurations tailored to your exact needs.

  1. Access the ARTIK options by holding the ALT key down to get the drop-down selectors on the IDE window, clicking Samsung ARTIK, and then selecting Tizen RT System Configuration.

  2. Choose an existing configuration from which to start your changes, and click Next. (You could also choose one of your previously added configurations to edit.)

  3. Check off the features you want to add to or remove from the configuration, and click Build to regenerate the configuration.

  4. Click Next and give your custom configuration a name, then click Finish when complete.

ARTIK IDE Installation under Mac OS

The ARTIK IDE is a breeze to install, configure, and use. Install as described below, then follow the subsequent articles to configure the terminal emulator and to use the IDE for a Linux or Tizen RT project.

Installing ARTIK IDE

We recommend that Mac users install the ARTIK IDE. As part of its complete development environment, it integrates a convenient terminal emulator program that you can start using right away to talk to your ARTIK board.

System Requirements
– Mac Cocoa (64-bit)
– 3 GB RAM minimum, 8 GB recommended
– 2.5 GB disk space minimum, 5 GB recommended
– 1280 x 800 screen resolution

Installing the IDE. The ARTIK IDE installation on your development PC enables creation of a binary file that runs on your target ARTIK board. You can download the installer package to your desktop and be up and running in no time. If you already installed the ARTIK IDE for one ARTIK module type, you do not need to install it again.

  1. Download the installation package. Click below to download the package, then move it to the folder of your choice.

    Download Installer

  2. Double-click to extract the installer.

  3. Double-click the installer icon to begin.

  4. Accept the license agreement. From the initial screen, click Next to be see the ARTIK IDE license agreement. Read it through and accept to proceed.

  5. Specify the location. Specify the installation directory for the IDE using Browse, or accept the default directory location. Ensure there is no space in the directory path. Click Next to proceed.

  6. Proceed with installation. The installer will display the installation location. If there is no further change, click Install to install the IDE and tools. The installation can take as little as 5 minutes, but may take much longer, depending on the system.

  7. Un-check the "Launch ARTIK IDE" checkbox, then click Finish to complete the procedure.

  1. Add username and path. Do not start the ARTIK IDE before completing this.
    1. Open this configuration file for editing.
      sudo vim /etc/sudoers
    2. Find the line:
        %adminALL=(ALL) ALL
    3. Add this line below it:
      username ALL = (ALL) NOPASSWD: $ARTIKIDEPath/tools/mac-driver/switch-driver.py
      For example:
      samsung ALL = (ALL) NOPASSWD: /Applications/ARTIK/tools/mac-driver/switch-driver.py
    4. Double-check your work, as adding this line correctly is critical.

Running the IDE. Each time you want to open the ARTIK IDE:

  1. Double-click on the artik_ide icon.

  2. Click on the Workbench icon to enter the IDE.

  3. On the initial run, the IDE will ask you to install the Software Development Kits (SDKs) of interest, corresponding to the devices you plan to use. Simply check the boxes next to the releases you want to install (typically just the newest). Also check the boxes next to the toolchains (check all available if unsure of which you'll need).

    You'll be able to repeat this process at any time, or check for updates, as shown in the Updating ARTIK SDK article.

    Note: You must be connected to the Internet, or you will see this message.

    If that happens, go to the Updating ARTIK SDK article once you have re-established a connection.

  4. The package update will proceed.

Go ahead now to terminal emulator setup. When finished, you'll be ready for the Tutorials.


Terminal Emulator Interface. Your interaction with the board takes place through a terminal emulator window.

The ARTIK 053 Starter Kit communicates through an FTDI USB-to-serial device that requires installation of an FTDI driver. The driver exposes two COM port devices:

  • UART interface for console debug, which you will use with a serial terminal emulator console to access the command line interface (CLI)

  • JTAG interface for program transfer, which will be controlled by the utility programs supplied with the kit.

Once the base COM port drivers are installed on your development PC and the ARTIK board is attached, the two serial COM ports become accessible:

– The lower-numbered port will typically be for JTAG transfer

– The higher-numbered port will typically be the UART interface.

Your terminal emulator console connects to the UART interface. Follow the correct procedure below for your PC type. Select the higher-numbered port to start with; if you fail to get a connection, try the other port.

PC type Terminal Emulator Example
Windows ARTIK IDE or PuTTY COM22 – COM23
Linux screen or minicom /dev/ttyUSB2 – /dev/ttyUSB3
Mac Terminal /dev/tty.usbserial-AI02ZWTO – *

*You may need to try each displayed port to determine the correct one.

   Step 2. Click the tab for terminal emulator setup instructions for your system.

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

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.

That's it for now – you're ready to connect to the outside world!

Last updated on: