NITRO-SDK Wi-Fi Library
Function Reference Manual
(English Edition)

Supports NITRO-SDK Wi-Fi Library Version 2.0 Release

Confidential

This document contains proprietary information. Please take strict measures to keep this information secret.

Revision History through NITRO-SDK Wi-Fi Library Version 2.0 Release

Introduction

Use of the NITRO-SDK Wi-Fi Library allows Internet access by using Nintendo DS wireless communication (infrastructure mode).

The following limitations apply to the NITRO-SDK Wi-Fi Library:

Supports NITRO-SDK 4.0 and later versions.
Supports CodeWarrior for Nintendo DS version 2.0 SP1 and later.
Set the path to Nintendo WFC in the NITROWIFI_ROOT environment variable.
The NITRO-SDK Wi-Fi Library also contains libraries that have unreleased source code. Please take note of this fact.

Library Structure

Internally, the NITRO-SDK Wi-Fi Library is made up of the hierarchical structure shown below:

WCM: Wireless connection management library. Manages connections with wireless access points and acts as a bridge between the CPS library and the wireless driver.
CPS: TCP/IP protocol stack. This includes ARP, IP, UDP, TCP, ICMP, DHCP client, DNS client, and SSL client.
SOCL: Socket library that runs on the CPS library.
SOC: A wrapper library that makes SOCL match a typical socket interface.

Currently, the following prefixes are reserved for the NITRO-SDK Wi-Fi Library. Therefore, in applications, do not use functions and variables that start with the following names:

WCM Wireless connection library prefix

CPS TCP/IP protocol stack prefix

SOC
SOCL Socket library prefix

Using the Functions

Place the following header file in an include statement in the program's source code:


	#include <nitroWiFi.h>

When this header file is placed in an include statement, both so2soc.h and iw2wcm.h are placed in the include statement by default. These headers are wrappers that redefine the function definition of the library on NITRO-INET to be used with the NITRO-SDK Wi-Fi Library. Even if you have developed applications using NITRO-INET, these wrappers allow you to easily replace just the libraries.

Place the following common build tools in the include statement in the makefile that creates the application libraries.


	include $(NITROWIFI_ROOT)/build/buildtools/commondefs
	include $(NITROWIFI_ROOT)/build/buildtools/modulerules

To run the samples correctly, you need to edit the following file for your wireless access point and rebuild the file.


	$(NITROWIFI_ROOT)/build/demos/shared/ap_info.c

WCM	Wireless connection library prefix
CPS	TCP/IP protocol stack prefix
SOC SOCL	Socket library prefix

NITRO-SDK Wi-Fi Library Function Reference Manual(English Edition)

Introduction

Library Structure

Using the Functions

NITRO-SDK Wi-Fi Library
Function Reference Manual
(English Edition)