You are here

Getting Started

Welcome!  This guide describes how to quickly build and run two software IoT Devices, based on IoTivity-Lite:

  1. The "Server", a command-line application, which emulates a simple smarthome IoT Device

  2. The "Client", a GUI-driven application, which controls the Server

IoTivity_Client_and_Server_diagram

The steps below assume a Linux development environment, although Windows is also supported.  See Troubleshooting and FAQ for more on different environments, common issues, etc.  Note: if you are looking for instructions on getting started with the IoTivity Raspberry Pi based hardware kit, those are linked here, or may also be found on the USB thumbdrive included with the kit.

There is a very useful set of primers posted at https://openconnectivity.org/developer/developer-kit, but it is also possible to go straight into building and running, just by following these steps:

  1. Open a Linux command prompt on your development system

  2. Download the IoTivity-Lite source by executing this command at the Linux command prompt:

    curl https://openconnectivity.github.io/IOTivity-Lite-setup/install.sh | bash
  3. Generate and build a Server Device, by executing "gen.sh" and "build.sh" at the Linux command prompt, as detailed in "Initial Flow" steps 1 and 2 in these instructions:

    https://github.com/openconnectivity/IoTivity-Lite-setup#initial-flow

  4. Download and install the pre-built Linux OTGC - an example Client application - using this command at the Linux command prompt:

    curl https://openconnectivityfoundation.github.io/development-support/otgc/linux/install.sh | bash
  5. Launch the Server Device by executing "run.sh" at the Linux command prompt, as detailed in "Initial Flow" step 3 in these instructions:

    https://github.com/openconnectivity/IoTivity-Lite-setup#initial-flow

  6. Also on the Development system, Launch the OTGC application by following instructions here:

    https://github.com/openconnectivityfoundation/development-support/blob/m...

  7. Use the OTGC to discover and "onboard" (pair) your Server Device, by following the instructions here:

    OTGC User Manual -> "User Instructions" -> "Linux" -> "Onboard Device"

  8. Use the OTGC to Retrieve and Update some Resources on the Server Device

Congratulations!  You are ready to begin building out your own OCF Device.  You may want to check out our guide for building an OCF Device for your own hardware.