The WDCInterface Library is an a C++ API for connecting to the Internet using a Wistron NeWeb Corporation (WNC) M14A2A Series data module. The WDCInterface library consists of a WDC Controller class, a collection of sockets, and an interface class. Collectively, these files create an interface class that is used in the AT&T Cellular IoT Starter Kit which is sold by Avnet (http://cloudconnectkits.org/product/att-cellular-iot-starter-kit). This interface class library is a drop-in replacement for an EthernetInterface class.

Occasionally, the WNC Data Module will encounter internal failures that cause the device to cease communicating. To prevent the system from unexpectedly hanging, the WNCInterface class has implemented three user configuration settings as described below:

1. Configure the WNCInterface for (1) debug enabled OR (2) disabled. The default/current setting is debug enabled. When debug is enabled, it opens stdio using the OpenSDA USB (serial over USB running at 115200-N81).

2. Configure the WNCInterface to either (1) Hang by executing a 'while(true)' loop when the error occurs OR (2) Have the WNCInterface return a Failure (-1) for the current and all subsequent calls. The default/current setting is to Hang execution.

3. Configure the WNCInterface to either (1) Display the failure location to the debug port OR (2) display nothing when the error occurs. The default/current setting is to display the failure location.

To create the complete WNCInterface class, you must also install the WncController class. This is the hardware abstraction layer utilized by WNCInterface to communicate with the hardware. It is installed within the WNCInterface class from: https://developer.mbed.org/teams/Avnet/code/WncControllerLibrary/

To demonstrate the use of the WDCInterface, a series of example programs have been developed. Links to these examples are provided below.

NOTE: This library/class is specific to the AT&T Cellular IoT Starter Kit which uses a FRDM-K64F. The users mbed.org compiler should be configured to use the FRDM-K64F platform.

Example Programs

Import the example programs below and follow the README.md in each to run the example program.

• WNCInterface_HTTP
• WNCInterface_M2Xdemo
• WNCInterface_M2XMQTTdemo
• WNCInterface_MQTT_hivemq

WNC FIRWARE VERSION

The WNCInterface class has been tested with the following firmware version(s):

• MPSS: M14A2A_v11.21.162331 APSS: M14A2A_v11.27.162331

License

This library is released under the Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License and may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.