
Welcome to the Freescale "My Wireless Application Demo".

VERSION:
1.01, Feb 14, 2005


INTRODUCTION:
This software package is an introduction to programming the Freescale
802.15.4 MAC. A suite of small applications demonstrates the various
steps required to create an 802.15.4 enabled application. Since the
purpose is to teach the basics of interfacing the Freescale 802.125.4
MAC the application examples are kept fairly simple. Thus, the included
code should not be regarded as having production quality.

The included applications go hand in hand with the Freescale 802.15.4
Software User's Manual. To maximize the learning experience it is
recommended to use the User’s Manual as the starting point before diving
into the application examples. The manual refers to each application in
this package while describing the steps required to build an 802.15.4
based wireless application.


SOFTWARE PACKAGE CONTENTS:
The package contains stand-alone applications requiring no additional
source code. Only the build environment and a debugger must be
installed beforehand.

If the zip archive has been properly un-zipped you must have the
following directory structure. It is relative to the path of this
readme.txt file:

..\..\Freescale_Reference_Libs\Mac\ - 802.15.4 MAC libraries
..\..\Freescale_Reference_Libs\Phy\ - 802.15.4 PHY library
Mcp\                                - MCP project file
Src\Build\                          - Linker file
Src\Code\App\                       - Demo application source code
Src\Code\Sys\                       - Required system files
Src\Code\Uart\                      - UART driver 
Src\Ghdr\                           - Interface header files


BUILD INSTRUCTIONS:
The Metrowerks Compiler V3.0 or V3.1 for the Motorola HCS08 MCU must
be installed to build the demo applications. The native version of
the included MCP project is V3.0. If Metrowerks Compiler V3.1 is
used the MCP project must be converted to a new format. This happens
when opening the MCP project. The conversion must be accepted in the
dialog box that appears.

To compile the applications you must go to the "mcp" folder and open
the My_Wireless_App.mcp. If Metrowerks was properly installed the
MCP project will open in the Codewarrior IDE. Select each project
in turn and compile. 

The executables (elf files) are created in the
Mcp\My_Wireless_App_Data\ My_Wireless_App_Ex*** folders.


EXECUTING THE APPLICATIONS:
A prerequisite for running the demo applications is the Freescale
Evaluation Kit (EVK). The kit includes at least two MC13192 based
boards, and a P&E USB Multilink debugger. 

The demo consists of a number of applications with an increasing
level of functionality. The first demo application focuses on
initialization while the last application demonstrates data transfer
over an 802.15.4 wireless point-to-point network. The applications in
between are the single steps required to get from the first to the
last application.

It is recommended to compile and run each of the applications in the
following order (applications with an 'a' at the end of the name are
of type coordinator, while 'b' signifies reduced function devices):

My Wireless App Ex01:  Initialization of the 802.15.4 MAC.
                       Shows how to call Mlme_Main() in a loop.
My Wireless App Ex02:  Coordinator performs Energy Detection Scan for
                       selecting a logical channel before starting as
                       a PAN coordinator.
My Wireless App Ex03a: Start a PAN coordinator. Now the MAC will 
                       respond to Active Scans from devices.
My Wireless App Ex03b: Device use Active Scan to find a coordinator.
My Wireless App Ex04a: Coordinator replies to Association requests
                       from devices.
My Wireless App Ex04b: Device requests association to a coordinator.
My Wireless App Ex05a: Coordinator receives data from device.
My Wireless App Ex05b: Device sends data to a coordinator.
My Wireless App Ex06a: Coordinator send indirect data to the device.
My Wireless App Ex06b: Device polls for data pending at the coordinator.
My Wireless App Ex07a: Coordinator starts a beaconed network.
My Wireless App Ex07b: Device automatically receives data from the 
                       coordinator in a beaconed network (no polling).
My Wireless App Ex08a: Coordinator starts a beaconed network with
                       secured data packets.
My Wireless App Ex08b: Device automatically receives data from the 
                       coordinator in a beaconed network (no polling).
                       Data packets are secured using MAC security.

The 'a' and 'b' applications belong together in numbered pairs. The 'a'
device must be started first, then the 'b' device. E.g. "My Wireless
App Ex03a" is started before "My Wireless App Ex03b". 

If the EVK boards are connected to a PC via an RS232 cable, then text
output showing the progress of the demo application can be displayed
using terminal software on the PC. The terminals com-port settings
must be 19200bps, 8N1.
