Getting Started Guide for Devicescape Agent Supplicant
The following topics are included in this Getting Started Guide:
What's in the Box?
|
Item
|
Description & Licenses
|
|
Devicescape Agent Supplicant package
(devicescape-dsa-<version>)
|
Software development package for creating wireless LAN (WLAN) client devices.
Includes ANSI C source code for wpa_supplicant, wpa_cli, GUI and configuration management interfaces.
Includes binary or source code of WinCE/WinMobile IM Driver (depending on license terms).
Optionally includes WPS (Wireless Protected Setup) support.
License: Devicescape Software, Inc.
Note: An enhanced version of DSA source package with support for CCX v1 - v4, is available only to Cisco Licensees. For more information, see Support for CCX Extensions.
|
|
OpenSSL
(openssl-0.9.8a-devicescape-dsa)
|
Toolkit for OpenSSL, including extensions for EAP-FAST support.
|
|
DSA Documentation
|
Complete documentation is provided to describe product implementation, porting, interfaces, and so on.
|
What is the Devicescape Agent Supplicant?
The Devicescape Agent Supplicant (DSA) is a software development package for enabling authentication and security in wireless LAN (WLAN) client devices.
The DSA software development package is comprised of a full featured 802.1X supplicant, Intermediate Driver (IM) support for WinCE or Windows Mobile, a CLI Interface, and a sample GUI.
DSA is fully compliant with IEEE 802.11i, IEEE 802.1X, and Wi-Fi WPA/WPA2/WPS security standards.
DSA is distributed in source code, and it is designed to be fully portable to different operating systems and hardware. The source code also includes a version of the OpenSSL library that has been modified to work with EAP-FAST. For convenience, binary versions of DSA for use on supported Windows operating systems are also available.
DSA is compatible with all WLAN chipsets on the Windows operating system that use the NDIS driver interface, and provides built-in support for most popular Linux WLAN drivers.
The DSA documentation package provides a Developer Guide, and API documentation that explains how the supplicant is implemented and how to modify it. The documentation guides you through how to add support for a new driver, port to a different operating system, or build a UI that interacts with the wireless client configuration and management interfaces.
Product Usage Model
The DSA development package (source code, binaries, interfaces, documentation, etc) is designed to provide developers with an understanding of how DSA is implemented and how to modify it for these purposes:
- Add support for a new driver
- Port to a different operating system
- Build a user interface (UI) using the Configuration and Management interfaces provided, and the sample GUI
Support for CCX Extensions
DSA supports Cisco Compatible Extensions v1, v2, v3, and v4 (CCX) as an option (available only to Cisco Licensees). DSA with CCX extensions takes advantage of Cisco's innovations for enhanced security, mobility, quality of service, and network management.
Validated Platforms
Development Host Platform
A "development host" is the computer on which you develop and build the wireless system before loading it onto the target system. The development host should be an Intel-based PC running any modern Linux distribution or Microsoft Windows XP system.
DSA source code can be integrated into any standard development environment.
Validated Target System Platforms
A target system is the platform that functions as the wireless device. It is a combination of processor board and radio chipset. The low-level hardware drivers have been incorporated.
DSA can run on any target system to which the code has been ported. The client source code, as shipped, supports several Linux and Microsoft Windows target operating systems.
For the current list of validated operating systems, boards, and chipset combinations, see Data Sheets and other product information on the Devicescape website at http://www.devicescape.com/products/WLAN_supplicant.php.
The Devicescape Customer Support Web site also contains a comprehensive list of the tests performed and their results. These results reflect testing of the Devicescape Agent Supplicant only and do not reflect test results on specific boards.
Extracting Source Packages
The Devicescape Agent Supplicant source code package for both Linux and Microsoft Windows does not require an installer. When you are ready to start development, obtain the following archive files and extract them to a location of your choosing on your development host.
|
File
|
Description
|
|
devicescape-dsa-<version>.zip (Windows)
devicescape-dsa-<version>.tar.gz (Linux)
|
zip or tar.gz file of the Devicescape DSA source package
|
|
openssl-0.9.8a-devicescape-dsa.zip (Windows)
openssl-0.9.8a-devicescape-dsa.tar.gz (Linux)
|
zip or tar file of the OpenSSL source package.
|
Installing Binary Packages on the Target
The Devicescape Agent Supplicant is also available in binary format for supported Windows targets. For installation information, refer to the README.txt file that is included with the binary, and the Developer Guide.
Where to Go Next
A complete set of documentation for the Devicescape Agent Supplicant is included in a zip file downloadable from the Web, on the Devicescape Agent Supplicant Documentation CD that ships with the product, and is also available online at the Devicescape Product Documentation Web site at http://www.devicescape.com/docs/dsa/.
The documentation available is as follows:
- Getting Started Guide - This document.
- Developer Guide - Provides a product overview, DSA build instructions, and a map of the DSA codebase. The Developer Guide describes how to configure and manage interfaces, how to configure and manage the runtime client, how to port to specific operating systems, and how to implement a driver wrapper.
- API Reference - Provides API reference for configuration and management interfaces (function calls, library for using control interface). Provides API reference for porting and driver implementation wrappers.
- Release Notes - Outlines known issues with the product and any security vulnerabilities, including resolutions for such issues. (Release Notes are available on the Devicescape Customer Support Web site.)
Where to Get Support
For support on Devicescape Agent Supplicant, contact Devicescape Customer Support or your Devicescape Sales representative.
|
Customer Support
|
Telephone Number: +1 650 829 2600 option 3
|
|
Sales
|
Telephone Number: +1 650 829 2600 option 2
|
