↓

Filter results by

Connect to the World

The ARTIK 05X module can be connected to ARTIK Cloud, its gateway to the world, in under a minute. As an alternative, you can "stay local" and use only the command line interface to interact for now.

Reset

You're ready to start! First, a word about Reset: Don't press it unless directed. Here's why: The ARTIK 05X module resets itself when you apply power (here, by connecting the USB cable). After that, the pre-loaded firmware is designed to enter one of two modes:

  • By default, you enter Command Line Interface (CLI) mode.
    You'll see the TASH> prompt when you hit Enter.

  • If you press Reset, you enter "on-boarding" mode instead.

The main Reset button (next to the red LED) is shown below. For normal operation, you (or your end user) should not need to use this button.

in the box

Just to see the outcome, press reset now. You should see system information on your terminal emulator, followed by a message indicating that it is ready for on-boarding.

Now unplug and reconnect your board, and restart your terminal emulator session to get back to CLI mode operation.

Connect Options

Each ARTIK 05X module comes with unique security credentials in tamper-proof storage. The module is pre-loaded with a Tizen RT demonstration image that provides easy and secure connectivity to Wi-Fi® and to ARTIK Cloud.

  • The Samsung ARTIK App connects your device to Wi-Fi and registers it with ARTIK Cloud – instantly allowing you to remotely control and monitor ARTIK 05X GPIO functions. There is no charge for the app or service.

  • If you prefer, you can bypass onboarding. You will need to manually set up Wi-Fi using the terminal emulator console.

With either choice, you'll be up and running in no time.

Auto-connect to
ARTIK Cloud		   Use Command Line Interface (CLI)
Attach USB cable and press reset
(on-boarding mode)		   Attach USB cable but do not press reset
(CLI mode)
Follow auto-connect instructions   Enter commands at TASH> prompt on console

Auto-connect ARTIK 05X to Wi-Fi and ARTIK Cloud

You'll need to "on-board" your kit once initially and any time you load new firmware. Start by downloading and installing the free Samsung ARTIK app.

where to find the app look for this logo Requirements

<a href="https://play.google.com/store/apps/details?id=com.artik.onboarding&hl=en" target=_blank">Android phone</a>: from Google Play

<a href="https://itunes.apple.com/us/app/samsung-artik/id1206231856?mt=8" target=_blank">iPhone</a>: at iTunes app store		 Android 5.0
or later

When asked, sign in to ARTIK Cloud; if you don't have an account, sign up for it. It's free, too!

With everything connected and ready, press reset on the Starter Kit board. You'll see a message on the terminal emulator console that you're in on-boarding mode. Then proceed as shown below.

Step   Looks like this
1.


2.		 Open the app. Any devices you currently have registered will show up.

Press   +  to begin on-boarding.
3. Select "Use QR code"
4. Center the ARTIK module QR code on the screen.
5.


6.


7.		 Steady the camera; the app will register your MAC address.

Hit Continue when asked if the module is powered.

When the app lists Wi-Fi access points, select one and provide its passphrase.

The app will first connect with the ARTIK 05X module locally (not with your Wi-FI access point just yet) to set up the module Wi-Fi. Once done, the module will connect directly through the selected access point to ARTIK Cloud, and you can:

  • Tap to select your ARTIK 05X device

  • Tap setOn to turn on the board LED

  • Tap setOff to turn the LED off.

That's it – you're Wi-Fi-connected, and on-board with ARTIK Cloud! Using the app, you are telling ARTIK Cloud to send Action messages to remotely turn the LED on the board on and off.

For security reasons, on-boarding is a one-time operation. To do it again:
– Re-flash a new image
– Delete the previous entry from ARTIK Cloud and from your phone app.

Rules. ARTIK Cloud Rules let you define situations where an action should be sent to a device. You can go to my.artik.cloud, select the RULES page, and define a NEW RULE to control this LED the same way as your phone did.

Command Line Interface operation

For command line operation, you will not be using the reset button. Instead, after attaching the USB cable, hit the Enter key.

You'll see the TASH> prompt. This bash-like shell is available for the simple command line interpreter (CLI) that interacts with the module. Use it to run any of the pre-loaded sample applications. Type:
help
to get a list of available commands.

Use the ping command to test whether the Wi-Fi is working. It will eventually time out.

Ctrl-C won't break out of ping or other loops in Tizen RT. On PuTTY, you can right-click on the top bar and select Special Command > break. The ARTIK IDE console does not currently have this feature.

Use Linux-like commands

The Tizen RT OS is based on the NuttX RTOS, which employs soft event handling. Tizen RT adds additional features such as simple-to-use Wi-Fi and ARTIK Cloud connectivity.

Many commands listed using help should look familiar to you, as they are meant to mimic Linux operations. We've grouped the keywords by category below.

command category
wifi    iperf    ping   
ifconfig    ifup    ifdown		 network operations
mkdir    rmdir    pwd    cd
ls    cat
rm  
mount    umount		 file system operations
(note that cp and mv
are not present)
ps    kill    killall    heapinfo
free    stkmon    sleep    exit    sh		 process-related
commands
setenv    unsetenv    getenv    date environment variable
access
mkrd    mksmartfs* RAM disk / flash file
system creation

*NuttX nomenclature for "Sector Mapped Allocation for Really Tiny (SMART) flash File System"

Try using ls -l to get a listing of the file system.

Turn on a GPIO pin to light an LED

On the pre-loaded firmware, you'll find a test app called gpio that you can use to set GPIO pin function. Try it out now.

gpio write 45 1 turns on the red LED
gpio write 49 1 turns on the blue LED

On the production firmware that you will load in the ARTIK IDE article, this gpio app will be part of the sensor app.

Set up a flash drive

You'll find that the flash drive at /dev/smart0p8 can be mounted and used for file storage. You can set up a flash drive as follows. Start fresh from a hard reset.

mksmartfs /dev/smart0p8

mount -t smartfs /dev/smart0p8 mydir

(You'll see under /proc/fs that smartfs is the only mount option for -t.)

When you do
ls -l
you'll find /mydir listed.

Set up a RAM disk drive

The mkrd command creates a RAM disk drive

TASH>>mkrd 1
TASH>>tash_mkrd: RAMDISK at 205e830

Manually Set Up Wi-Fi

Establishing a Wi-Fi connection manually couldn't be easier. It uses the Tizen RT version of 'wpa_supplicant' services and works just like you'd expect.

  1. Stop any current Wi-Fi operations.
    wifi stop

  2. Start the 'wpa_supplicant' service in client (STA) mode.
    wifi startsta

  3. Look for access points to connect to (unless you know yours already).
    wifi scan

  4. Enter the information for the Wi-Fi network using the connect command.*
    wifi connect <ssid> <password>
    For example:
       wifi connect NETGEAR12 MyPass123

  5. Enter a request for an IP address, and wait (it may take a minute).
    ifconfig wl1 dhcp

That's all you'll need to do to connect! You can use ping to try out your connection. Later we'll do some MQTT examples to show how easily you can send a message.

* The command on later code releases becomes wifi join and works slightly differently.

Developing with the ARTIK IDE

Now you're ready to start creating your first Tizen RT application. Proceed to Build and Run Tizen RT Applications.

If you'd like to learn a little more about the board pinout, stop off at the Board Reference article and take a look around!

Last updated on: