Connect to the World
Once updated to the latest OS images, ARTIK 530/710 Linux-based modules can be connected to ARTIK Cloud in under a minute. The modules come with unique credentials in tamper-proof storage to provide secure connectivity. What does this buy you?
» Connect to a Wi-Fi® network using a user-friendly phone app interface
» Send your module commands from a phone app by way of ARTIK Cloud
» Enable future over-the-air (OTA) updates of any Linux packages you choose.
You'll use the Samsung ARTIK phone app to connect your device to Wi-Fi and register it with ARTIK Cloud. There is no charge for the app or service. The demonstration function that comes with it instantly allows you to remotely control an ARTIK GPIO pin to turn on a board LED. You can replace its basic functionality with something of your own making.
You are not required to use on-boarding capability for ARTIK modules, and can remove it from your own custom builds if desired. However, we encourage you to try it out first!
On-boarding capability is included in os_18.05.00 (June 2018) and later releases. Before proceeding, make sure your board is up-to-date. Check the release information like this:
Step 1. Upgrade your OS. ARTIK modules come pre-loaded with a specific Linux operating system (OS), depending on module type:
- Ubuntu only (ARTIK 530s and 710s modules)
- Fedora upgradable to Ubuntu (ARTIK 530 and 710 standard modules)
- Fedora 24 only (ARTIK 520)
- Fedora 22 only (ARTIK 1020).
Fedora is more compact than Ubuntu, but its support lifetime is limited compared to Ubuntu (5 yrs). Move to Ubuntu now to avoid reloading all your software and tools later. Click to install the latest ARTIK image and choose the newest image for your module.
Step 2. Connect to a Network. To load software, you'll need to either connect an Ethernet cable or set up your Wi-Fi® network and password.
Try out "on-boarding." If you like, jump ahead to the Connect to the World article to set your network connection using a simple smart phone app.
Step 3. Upgrade installed packages. Start by reading a primer on package management systems. Now you're ready for the latest software updates.
In the version of Ubuntu we use,
apt are nearly interchangeable. We use
apt but you can feel free to use either.
apt install build-essential
Verify your repository first as noted below, then type
Note: A patch is available in the repositories for the KRACK vulnerability of
wpa_supplicant. Simply run the normal update/upgrade process to implement the fix. You can also patch just the affected package as follows.
apt install --only-upgrade wpasupplicant
dnf upgrade wpa_supplicant
Step 4. Install a development environment on your PC. If you loaded the ARTIK IDE earlier, you're nearly done – go to the Update SDK article to check for updates. If not, go to Software Tools to get an overview of what's available.
Step 5. Update SDK. ARTIK API support is included automatically when you install the ARTIK IDE. For the latest Ubuntu images (os_18.05.00 or newer), just update the SDK version on the board.
apt install libartik-sdk
For Fedora or older Ubuntu images, you need to enable repository access on your ARTIK board first and then install the SDK as directed in that article.
Step 6. Add additional packages. You'll eventually want to add other software, typically using a package installer. We've included instructions throughout the articles about what packages you'd need for a specific feature (like adding Node-RED as we describe in the Tutorials).
Verifying Fedora repository
At the conclusion of active development for a given Fedora release, Fedora repositories may be phased out and moved to a permanent archive. If you are having any problems with
dnf update or package downloads, make sure the repository URLs point to the right locations.
You'll find the information in
/etc/yum.repos.d/ in various files. You can either change them manually or use a command like the one below to make the substitution.
sed -i 's|archive\.fedoraproject\.org\/pub|archives\.fedoraproject\.org\/pub\/archive|g' /etc/yum.repos.d/*
Auto-connect ARTIK 5/7 to Wi-Fi and ARTIK Cloud
You'll need to "on-board" your kit once initially and any time you load a new OS image. 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!
With everything connected and ready, proceed as shown below.
Connect phone app to ARTIK module over BLE
The phone app uses a Bluetooth/BLE connection to exchange information with the ARTIK module. (The app does not use Wi-Fi to talk with ARTIK Linux modules.)
|Step||description||Looks like this|
Open the app. Any devices you currently have registered will show up.
Enable Bluetooth on your phone, then
press + to begin on-boarding.
Select "Use QR code"
Center the ARTIK module QR code on
the screen and steady the camera.
The app will register your MAC address.
Enter a name and location – the way you want your gateway to show up on your ARTIK Cloud "Devices" page. Hit Enter.
|6.||With the module powered and booted, hit Continue on the app. Then press the BLE pairing switch (LED turns red).
|7.||Once paired, click Connect to Wi-Fi.
When you get the list of available Wi-Fi networks, choose one and provide its passphrase.
|The app sends the selected AP name and passphrase to the module, which adds it to its list.|
As long as the module is able to connect to your chosen Wi-Fi access point (AP), the module software:
saves this AP to be used for automatic Wi-Fi connection on every subsequent boot
proceeds to register the module with ARTIK Cloud
provides a channel for over-the-air (OTA) update of any module packages you choose, by simply uploading a package set to ARTIK Cloud.
Once configured, the module will connect directly through the selected access point to ARTIK Cloud. Through your app, and on any type of Internet connection, you can:
Tap to select your ARTIK 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, delete the previous entry from your phone app and from ARTIK Cloud.
Need to change AP? You can run the app again just like a new on-boarding, but skip the name and location. The Wi-Fi information will be updated. ARTIK Cloud registration will fail the second time since you have already registered once, but you can ignore this. Or you could just use Connection Manager to make the change.
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.
You will get "Registration failure" if you try to on-board a module that you previously on-boarded and did not remove.
Remove a module from the app by selecting the module and then choosing Delete Device from the menu in the upper right corner. Make sure your phone is Internet-connected at this time; otherwise, the app will not be able to simultaneously remove the device from ARTIK Cloud.
If you tried to remove a module from the app but it is not removed from the list, delete the module from your ARTIK Cloud account. Then uninstall the app and install the latest version. Any module not registered to ARTIK Cloud will be taken out of the app listing.
The phone running the app does not need to be on the same network as the the module being on-boarded.
If all else fails, uninstall the app and then install the latest version from the app store.
If you are having problems with Wi-Fi not being detected at all, refer to the Connection Manager troubleshooting hints for information on re-enabling (
connmanctl) and unblocking (
If you are looking for clues to failed connections, it often helps to run the journal:
journalctl -f -o"cat" &
With a little planning, you can on-board using Wi-Fi that goes through a proxy to the Internet.
The phone app may work with a proxied connection to ARTIK Cloud, depending on whether your proxy administrator permits the necessary access.
The module can also be connected through a proxy to the network – provided that you have previously copied in the local issuer certificate, and exported the proxy name/URL and username+password. Usually this means:
– Setting the proxy name and your login name and password in
– Copying your local issuer certificate to
Refer to the Proxies and Certificates article for details.