How to get started with Novacore SDK?

The Novacore SDK is distributed as a shared server and a suite of API components that you can use in your applications.
The API components are a set of dlls with a simple C-interface. These dlls are used only by your application allowing you to include or distribute only those dlls that offer the functionality you need. Here is a list of API components that form the Novacore SDK:

Core Module
Activation Module
Diagnostics Module
Gps Module
File Manager
Connection Module
Sms Encoding Module
Also included with the SDK is a merge module and driver installer that can be bundled into your application installer for deployment.

After installing the SDK you are ready to start building applications. To develop an application using the SDK you need to start with the main API component, NvtlSdk.dll This component is the primary interface of the SDK and is required by all applications. This component allows applications to discover WWAN devices on the system, attach to them, and perform typical operations.
Usage of this component involves physically loading the dll, creating an interactive session with the dll, and then locating and attaching to a device for use. Once a device is located and attached to the sdk you can then proceed to load and utilize the other dlls as needed in a similar manner.

The SDK includes a set of console applications that demonstrate how to perform a wide variety of common tasks. These can be used as a starting point for getting familiar with the SDK. The most basic sample is the AttachDevice application which demonstrates how to use the SDK to attach to a device and receive basic information such as the phone number and firmware version. You may also refer to How to attach to a device and monitor its state? for an overview of this process.

What are the basic steps required for using NovaCore SDK?
The core component of the SDK is NvtlSDk.dll. This component is responsible for managing a device and provides, basic information, events, device detection, and common or often used functions. This component is always required and should be the first component of the SDK to be loaded and used when building applications.

Following are the general steps that should be taken when using the NvtlSdk.dll component
Load the component. This is done using LoadLibrary() or related function
Create a session with the component using method NvtlCommon_CreateSession. This allows the component to create the internal contexts it needs to allow a host application to receive events and manage devices. A session is required for all subsequent interaction with the SDk.
Register an event callback using method NvtlCommon_RegisterEventCallback. Registering a callback function allows the SDK to send events to the host applications regarding device addition or removal, device state, signal strength, roaming status, etc.
Query available devices using method NvtlCommon_GetAvailableDevices. This method allows a host application to receive a list of all devices currently present in the system that are recognized by the SDK. If there are no devices currently available the host application should wait and call this method again in response to a device added event when a device becomes available.
Attach to a device using method NvtlCommon_AttachDevice. Once an available device is recognized the host application must inform the SDK that it wishes to attach to a device for use.
Once a device is attached the application can proceed to interact with the device, execute various functions of the SDK, and utilize various other modules of the SDK.
When done using a device, the host application should reverse the steps by detaching from the device, destroying the session, and unloading the component.

Using the remaining SDK components is similar except that they should be utilized only after a device is available, and the CreateSession method of each of those components requires the session created with NvtlSdk as a parameter.
Examples demonstrating this and various specific tasks can be found in the supplied sample code. The sample code also includes some C++ wrapper classes that can be used to help manage the component loading and unloading.


Does NovaCore SDK come with source code?
The SDK package comes with binaries (a set of dlls), and sample source code (C++) that demonstrates the use of SDK components.