Filter results by

Compile and Load Image to ARTIK 053

With the SDK loaded onto the host system, you're ready to configure, code, and go!

Configuring Build

Pre-defined configurations of the ARTIK 053 are available through the SDK.

Go to the Tizen RT build environment directory.
cd ~/ARTIK053/tinyara/os/tools

Run the script for your chosen board/configuration.
./configure.sh <board>/<cfg>

The board name will always be artik053 for the ARTIK 053 Starter Kit. For your first run through, we suggest you use the nettest configuration. So the command line would be

./configure.sh artik053/nettest

The script will initialize the Tizen RT configuration, readying it for building.

Compiling

Building Tizen RT, complete with all your apps and code, is simpler than you might expect.

You should compile the initialized configuration once, unmodified, to verify that it will build and run as expected. After that, you'll want to try coding changes to the files using your favorite editor. Wait until the next article so you'll have all the tools available.

Compile First Time

From your bash or Linux prompt:

  1. Make sure the build process can find the toolchain. Verify that the setting is correct (you should have set it in ~/.bashrc).
       echo $CROSSDEV
        arm-none-eabi-

  2. Change to the Tizen RT operating system directory.
    cd ~/ARTIK053/tinyara/os

  3. Build the image.
    make

    If any of the included applications have unmet dependencies, you could get compilation errors. If so, disable the applications(s) from the menu (refer to the next article) and try again.

Building creates a tinyara_head.bin file in the tinyara/build/output/bin directory. It contains the compiled Tizen RT binary image for the ARTIK 053.

Subsequent Re-Compile

After you have built and loaded the image the first time, you'll probably want to make some code changes and recompile.

  1. When you are ready to recompile, run:
    make clean

  2. If you optionally want to start again from the original project:

    1. Run make distclean

    2. Set the initial configuration again as you did in Configuring Build.

  3. Run make from the os directory as before.

Loading Images

The ARTIK 053 hardware JTAG port is accessed through OpenOCD. Prepared scripts take care of all the necessary flash memory operations.

  • Make sure you have the FTDI libusb driver installed to enable JTAG (refer to previous article)

Use a bash window on the PC to run the scripts and perform uploads, not the terminal emulator window (which goes to the Starter Kit debug interface). The scripts automatically identify and use the correct USB connection for communicating over JTAG.

  1. Open a bash window on your development PC.

  2. If you are using VirtualBox, switch the FTDI USB ports to its control.

  3. Go to the Tizen RT build OpenOCD directory.

    cd ~/ARTIK053/tinyara/build/configs/artik053/tools/openocd

  4. Flash the required images to the ARTIK 053 module. Copy and paste these lines.

1
2
3
4
5
6
7
8
9
./linux64/openocd -f artik053.cfg -c \
' \
flash_write bl1 ../../bin/bl1.bin; \
flash_write bl2 ../../bin/bl2.bin; \
flash_write sssfw ../../bin/sssfw.bin; \
flash_write wlanfw ../../bin/wlanfw.bin; \
flash_write os ../../../../output/bin/tinyara_head.bin; \
shutdown \
'

The first time, use all lines; after that you can flash just the tinyara_head.bin file. If you get an erasure warning message, confirm that it is okay to proceed.

Does it exit immediately and not do a flash update? Maybe you forgot to switch the ports over to VirtualBox control (Devices » USB » FTDI…). Also try hitting the RESET button on the board.

That's all there is to it! The output of the script will display the fusing of each of the binary images associated with the ARTIK 053 module. Once complete, the ARTIK 053 module is ready to use.

Running Applications

Once an image is loaded onto the ARTIK 053 module, you'll use the UART interface to connect through the terminal emulator console as you did in the introductory section.

  1. If using VirtualBox and your terminal emulator is a Windows application, switch the USB ports back to Windows control.
  2. Open a terminal emulator as usual. The screen will initially be blank.
  3. Press Reset.

You should see messages related to the loaded Tizen RT versions. Once the boot messages are finished, hit Enter on the terminal keyboard to get a TASH >> prompt.

The TASH shell CLI interacts with the module to run any pre-loaded application, including your own.

Tutorial Example

A good place to try out this procedure is the sensorbd_demo application; with it, you can run the Blink an LED tutorial.

Proceed to the Kconfig article to install the customization tool, and follow its example to include the Sensor app in your TASH> list.

Onboarding Example

To recreate the onboarding environment that your ARTIK 053 module arrived with, follow these instructions.

  1. Change to the artik-e2e branch of Tizen RT as noted here.
  2. Configure the build from tinyara/os/tools using ./configure.sh artik053/typical (instead of nettest).
  3. Build and flash as usual.

You can do this without installing or running the Kconfig tool.

Last updated on: