basic.c

This example is discussed in First steps

/*******************************************************************************
 * First Steps
 *
 * This is a program to demonstrate the basic use of the DevBot
 * APIs. It covers initializing the library, configuring a device from
 * a text file, retrieving that device by name and then using it to do
 * something.
 *
 * This represents the standard use case.
 * 
 *******************************************************************************/

/* Include the main devbot header, all devbot-based applications will
 * do this */
#include <devbot/bot.h>

/* Include the headers for any interfaces we're going to use, in this
 * case we're just using the distance sensor interface
 * BotDistanceInterface */
#include <devbot/distance.h>

int main(int argc, char **argv)
{
  /* 1. Initialize the devbot library specifying a device configuration file */
  bot_initialize_from_file("basic.config");
  
  /* 2. Retrieve a device by name */
  BotDevice *rangefinder = bot_get_device("rangefinder");
  
  /* 3. Check we've got the device and that it supports the distance
   * interface.  
   *
   * It is not *necessary* to do this, but should be considered good
   * defensive programming practice */
  if (!(rangefinder && bot_device_get_interface(rangefinder, BotDistanceInterface)))
  {
    exit(1);
  }

  /* 4. Retrieve and print the distance */
  g_message("Distance was: %lf", bot_distance_get_metre(rangefinder));

  /* 5. Shutdown the libarary
   * 
   * This will free internal data structures, unload drivers etc.
   * It is not *necessary* to do this, but it is good practice */
  bot_shutdown();
}

---