Create the Windows Client Software Library Sample Applications

The Windows client software library sample applications must be created before they can run on your device.

  1. Set up your development environment. See Set Up Your Development Environment to Use the Windows Client Software Libraries.
  2. Open a command prompt and run this command to move to the make directory: cd iotcs/csl/windows/samples/make.
  3. Run this command to build a sample application: make build [CC_CFG= <CC_CFG_Option>][LIB_CFG=<LIB_CFG_Option>][PROXY=<your-company-proxy-server>].
    Replace <CC_CFG_Option> and <LIB_CFG_Option> with one of the commands listed in the table. Replace <your-company-proxy-server> with the IP address of your company server if you are running the sample applications behind a corporate firewall.
    Command Where Used Description
    cl <CC_CFG_Option> Builds the client software library on Windows computers. This is the default compiler.
    gcc <CC_CFG_Option> Builds the client software library on Linux computers and adds the GNU Compiler Collection (GCC).
    nots <LIB_CFG_Option> Builds the directly connected device sample application with these options: messaging thread safety=false, messaging dispatcher=false, and virtualization support=false.
    ts <LIB_CFG_Option> Builds the directly connected device sample application with these options: messaging thread safety=true, messaging dispatcher= false, and virtualization support=false.
    ts_md_gw <LIB_CFG_Option> Builds the gateway device sample application with these options: messaging thread safety=true, messaging dispatcher= true, virtualization support=false, and indirect activation=true.
    ts_md_vs <LIB_CFG_Option> Builds a directly connected device sample application with these options: messaging thread safety=true, messaging dispatcher= true, and virtualization support=true.
    ts_md_vs_gw <LIB_CFG_Option> Builds a gateway device sample application with these options: messaging thread safety=true, messaging dispatcher= true, virtualization support=true, and indirect activation=true. This is the default value for the LIB_CFG parameter.
  4. (Optional) Run this command to clean the sample applications: make clean [LIB_CFG=<LIB_CFG_Option>].
  5. Run the sample applications. See Run the Windows Sample Applications.