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.
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.
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.
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.
|Use Command Line Interface (CLI)|
|Attach USB cable and press reset
|Attach USB cable but do not press reset
|Follow auto-connect instructions||Enter commands at
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
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|
|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.|
|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:
to get a list of available commands.
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
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.
||file system operations
are not present)
||RAM disk / flash file
*NuttX nomenclature for "Sector Mapped Allocation for Really Tiny (SMART) flash File System"
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
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.
mount -t smartfs /dev/smart0p8 mydir
(You'll see under
smartfs is the only mount option for
When you do
Set up a RAM disk drive
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.
Stop any current Wi-Fi operations.
Start the 'wpa_supplicant' service in client (STA) mode.
Look for access points to connect to (unless you know yours already).
Enter the information for the Wi-Fi network using the
wifi connect <ssid> <password>
wifi connect NETGEAR12 MyPass123
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!