Ember EMBER2002 Modular Spread Spectrum Transmitter User Manual DevKitUser

Ember Corporation Modular Spread Spectrum Transmitter DevKitUser

UserManual.wiki >

EMBER2002 User Manual

Users Manual

C o m p a n y C o n f i d e n t i a lEmberNet Developer Kit User’s Guide120-0002-210 December 2002

C o m p a n y C o n f i d e n t i a lCopyright © 2002 by Ember CorporationAll rights reservedThe information in this document is subject to change without notice. The statements, configurations, technical data,and recommendations in this document are believed to be accurate and reliable, but are presented without express orimplied warranty. Users must take full responsibility for their applications of any products specified in this document.The information in this document is the property of Ember Corporation.EmberNet and Ember are a trademarks of Ember Corporation.All other trademarks are the property of their respective holders.FCC Compliance for the EmberNet NodeCompliance Statement ( Part 15.19 )The EmberNet Node complies with Part 15 of the FCC Rules and with RSS-210 of Industry Canada. Operation is subject to the following two conditions: --This device may not cause harmful interference, and --This device must accept any interference received, including interference that may cause undesired operation.Warning ( Part 15.21 )Changes or modifications not expressly approved by the party responsible for compliance could void the userís authority to operate the equipment.RF Exposure ( OET Bulletin 65 )To comply with FCC RF exposure requirements for mobile transmitting devices, this transmitter should only be used orinstalled at locations where there is at least 20cm separation distance between the antenna and all persons.The EmberNet Node is intended for installation in mobile devices, and is not intended for installation in portable devices.

EmberNet Developer Kit User’s Guide 120-0002-210 iii C o m p a n y C o n f i d e n t i a lContents PrefaceAbout This Guide viiAssociated EmberNet Documentation viiGetting Help viiCHAPTER 1 EmberNet Developer Kit OverviewDeveloper Kit Requirements 1-2Developer Kit Components 1-3Hardware Components 1-3Software Components 1-4Support Services 1-4Hardware Components 1-5EmberNet Node 1-5EmberNet Node Components 1-6EmberNet Node Connections 1-7EmberNet Breakout Boards 1-8Breakout board components and connections 1-9

iv EmberNet Developer Kit User’s Guide 120-0002-210C o m p a n y C o n f i d e n t i a lEmberNet Gateway 1-9EmberNet Gateway Components 1-10EmberNet Gateway Connections 1-10Radio antenna 1-11USB Programmer with cable 1-11Software Components 1-12GCC Compiler 1-12Alternate Compiler 1-12EmberNet Node Binary for EmberNet Node Hardware 1-12EmberNet Host API and EmberNet SPI Protocol (ESP) Command Set 1-12Sample Applications 1-13Application Template 1-13CHAPTER 2 Connecting the HardwareAttaching antennae 2-2About the antennae 2-2EmberNet Node antenna 2-2EmberNet Gateway antenna 2-4Connecting the antennae 2-5Connecting the EmberNet Breakout Board 2-6Breakout board components and connections 2-6Select Processor 2-9Set the Serial Select Dip Switch (SW4) 2-10Set the LED Select Dip Switch (SW3) 2-10Installing the EmberNet Gateway 2-11Connecting the Gateway 2-11CHAPTER 3 Using the EmberNet Developer Kit SoftwareInstalling the GCC Compiler 3-2To install the compiler 3-2To compile the sample applications 3-2About the sample applications 3-3To run the default sample application 3-3Using the Application Template 3-4To use the applicatoin template 3-4

EmberNet Developer Kit User’s Guide 120-0002-210 vC o m p a n y C o n f i d e n t i a lUsing your Implementer ID 3-4Implementer code 3-5Project code 3-5Tag 3-5Defining services using your implementer ID 3-5CHAPTER 4 Installing and Using the USB ProgrammerInstalling the USB Programmer Software 4-2To install the USB Programmer software: 4-2Attach the USB Programmer 4-3To attach the USB Programmer: 4-3Configuring the ISP Super programmer software 4-6To configure the USB programmer: 4-6Programming the Processor 4-8To program the processor: 4-8

vi EmberNet Developer Kit User’s Guide 120-0002-210C o m p a n y C o n f i d e n t i a l

EmberNet Developer Kit User’s Guide 120-0002-210 viiC o m p a n y C o n f i d e n t i a lPrefaceAbout This GuideThis guide introduces you to the components of the EmberNet Developer Kit and provides basic instruction for their use.Associated EmberNet DocumentationEmberNet OverviewEmberNet Application Development GuideEmberNet View User’s GuideEmberNet Node Technical SpecificationEmberNet Gateway Technical Specification

Prefaceviii EmberNet Developer Kit User’s Guide 120-0002-210C o m p a n y C o n f i d e n t i a lGetting HelpDocumentation, customer service, and support are available at support.ember.com or by contacting your account representative at Ember.

EmberNet Developer Kit User’s Guide 120-0002-210 1-1C o m p a n y C o n f i d e n t i a lCHAPTER 1 EmberNet Developer Kit OverviewOverviewThere are three versions of the EmberNet Developer Kit, a Standard, Advanced and a Premium version. Each Kit contains a number of hardware and software compo-nents to assist you in building an Ember Enabled application. This chapter provides a listing of components and their functions.

EmberNet Developer Kit Overview 1-2 120-0002-210 EmberNet Developer Kit User’s Guide C o m p a n y C o n f i d e n t i a lEmberNet Developer Kit ComponentsThe following table outlines the components for each EmberNet Developer Kit.Table 1-1: EmberNet Developer KitsStandard Advanced PremiumHardware 8 - EmberNet Nodes8 - EmberNet Breakout Boards1 - EmberNet Gateway1 - USB Programmer1 - 6ft. Ethernet patch cable9 - 9V power supplies12 - EmberNet Nodes12 - EmberNet Breakout Boards12 - EmberNet/Ethernet connection boards1 - EmberNet Gateway1 - USB Programmer1 - 6ft. Ethernet patch cable13 - 9V power supplies12 - EmberNet Nodes12 - EmberNet Breakout Boards12 - EmberNet/Ethernet connec-tion boards1 - EmberNet Gateway1 - USB Programmer1 - 6ft. Ethernet patch cable13 - 9V power suppliesSoftware and Documenta-tion1 - EmberNet Developer Kit CD1 - AVR-GCC 3.2.C Compiler (Win 32)1 - EmberNet Node Binary1 - EmberNet Host API Specifi-cations & Libraries1 - Sample Application1 - EmberNet View EmberNet Documentation1 - EmberNet Developer Kit CD1 - AVR-GCC 3.2.C Compiler (Win 32)1 - EmberNet Node Binary1 - EmberNet Host API Specifica-tions & Libraries1 - Sample Application1 - EmberNet View1 - EmberNet Simulator v1.0 (Linux)1 - EmberNet Node Binary for EmberNet Simulator1 - EmberNet/Ethernet Debug Appli-cation EmberNet Documentation1 - EmberNet Developer Kit CD1 - AVR-GCC 3.2.C Compiler (Win 32)1 - EmberNet Node Binary1 - EmberNet Host API Specifi-cations & Libraries1 - Sample Application1 - EmberNet View1 - EmberNet Simulator v1.0 (Linux)1 - EmberNet Node Binary for EmberNet Simulator1 - EmberNet/Ethernet Debug Application EmberNet DocumentationTraining and Support1 year - Web based support Annual Support1 - Training SeatTelephone, email and web supportPremium Support• 3 days - custom engineer-ing(*T&E excluded)• 2 days (up to 5 students) - Onsite training (*T&E excluded)• Telephone, email and web support.Optional Upgrades for additional feeDiscounted first seat trainingPer incident support: • $750 per three incidents • First three incidents free upon completion of trainingEmberNet Debug Kit includes:8 - EmberNet/Ethernet Connec-tion Boards1 - EmberNet Simulator1 - EmberNet/Ethernet Debug applicationAdditional training seatsAnnual supportCustom engineering• Additional Training seats• Custom Engineeringz• Additional Training seats• Additional Custom Engi-neering* Travel and Entertainments

EmberNet Developer Kit User’s Guide 120-0002-210 1-3Developer Kit RequirementsC o m p a n y C o n f i d e n t i a lDeveloper Kit RequirementsMost modern PCs provide the necessary requirements for developing Ember Enabled applications. Refer to the GCC documentation for specific details on the compiler’s requirements, but in general, the following should be sufficient:• Windows 98 and later• An available USB port for downloading images to the EmberNet Node or appli-cation code to the processor.• Adobe Acrobat reader (available via free download from www.adobe.com) for viewing the documentation.Additionally you may require these optional components• if you would like to connect and manage your EmberNet Gateway directly from your PC•Ethernet connection port on your PC•cross-over cable• if you would like to connect and manage your EmberNet Gateway via your local area network•local area network connection•standard serial cable•HyperTerminal (a Windows Accessory component)

EmberNet Developer Kit Overview 1-6 120-0002-210 EmberNet Developer Kit User’s Guide C o m p a n y C o n f i d e n t i a lHardware ComponentsEmberNet NodeAn EmberNet Node is a small-footprint module (2.2" x 1.5") that connects to a car-rier board (the EmberNet breakout board for development and the customized board for integration into an OEM product) and the EmberNet Gateway.Figure 1-2: EmberNet Node, top viewAn EmberNet Node is the primary component of an EmberNet network—it imple-ments the protocols that enable EmberNet networks to organize themselves and route messages across the network on behalf of the applications.

EmberNet Developer Kit User’s Guide 120-0002-210 1-7Hardware ComponentsC o m p a n y C o n f i d e n t i a lEmberNet Node ComponentsThe following block diagram represents the components of an EmberNet Node. Figure 1-3: Block diagram of EmberNet NodeThe main components of an EmberNet Node include:•An 8-bit micro controller which runs the EmberNet Protocol Stack and any application code you may wish to develop. In most cases, the EmberNet Node is embedded into a larger system, where the application code runs on the host pro-cessor and communicates with the EmberNet Node via the high-speed serial interface using the SPI or the EmberNet Host API commands. An EmberNet Node can also be used in stand-alone fashion (attached to an EmberNet Breakout Board or another carrier board for power) as a repeater. You can choose to run application components or whole applications in the EmberNet Node. • The direct sequence spread spectrum baseband controls the radio and mediates communications between the radio and the Node’s processor. Because the EmberNet Node’s processor is small, some of the work, such as encryption, is given to the baseband.• The radio communicates by way of the main RF channel.PA/LNA902-928MHzDSSSTransceiverDSSSBasebandAES-128CryptoEngineEmberNetNetworkProcessorFlash/RAMRF DigitalRFInterfaceSPIInterfacePower Supply/FilteringUnregulatedPower

EmberNet Developer Kit Overview 1-8 120-0002-210 EmberNet Developer Kit User’s Guide C o m p a n y C o n f i d e n t i a lInformation is transmitted into and out of the EmberNet Node in two ways. The pri-mary communications channel is a RF channel, which uses a 900MHz frequency-hopping spread-spectrum radio by which the EmberNet Node communicates with its neighboring nodes. In addition, a high-speed synchronous serial interface (SPI) is used for the EmberNet node to communicate with its host processor on the embedded device.EmberNet Node ConnectionsThe EmberNet Node has the following connections:• The J1 and J3 connectors are used to attach the node to the EmberNet breakout board or your customized carrier board. These connections allow the EmberNet Node to communicate with the host processor on the carrier board. For pinout information on these connectors, refer to the EmberNet Node Technical Specifi-cation.• The J2 antenna controller SMA connector connects the antenna to the EmberNet Node. Refer to Chapter 2 for more information about the antennae and how to connect them to nodes.•Power is supplied to the node via DC power through the carrier boardFigure 1-4: EmberNet Node connectionsJ1 ConnectorJ3 ConnectorJ2 Antenna Controller SMA

EmberNet Developer Kit User’s Guide 120-0002-210 1-9Hardware ComponentsC o m p a n y C o n f i d e n t i a lEmberNet Breakout BoardsThe EmberNet breakout boards are the carrier boards on which an EmberNet Node resides for development only; a custom carrier board will be designed to specifi-cally fit the equipment for which the application is being developed. The following illustration shows the breakout board with an attached EmberNet Node.Figure 1-5: EmberNet Breakout Board with attached EmberNet Node

EmberNet Developer Kit Overview 1-10 120-0002-210 EmberNet Developer Kit User’s Guide C o m p a n y C o n f i d e n t i a lBreakout board components and connectionsThe breakout board consists of several components and connections. The Atmel 8535 processor provides on-board processing capabilities. The SW1 dip switch and offboard processor connector allows the use of an alternative processor. The Rab-bitCore board provides an Ethernet connection for debugging. Two serial connec-tions and four other connections provide communications with the devices under development. For a complete listing of EmberNet Breakout Board components, refer to Chapter 2.EmberNet GatewayThe EmberNet Gateway provides a link between an EmberNet network and a TCP/IP Ethernet network, allowing you to collect data, monitor network status, and per-form limited management, configuration, and debugging of your network.Figure 1-6: EmberNet Gateway

EmberNet Developer Kit User’s Guide 120-0002-210 1-11Hardware ComponentsC o m p a n y C o n f i d e n t i a lEmberNet Gateway ComponentsThe following block diagram represents the components of an EmberNet Gateway. The EmberNet Gateway is comprised of two main components:•A StrongARM single board computer (SBC) that runs LINUX and runs an http server. It includes:• The Apache web server provides access to data from the network.• A CGI server so that external applications can query data from the network.• The EmberNet Protocol Stack server allows the Gateway to use the same host API running on the EmberNet Node.• The EmberNet View application provides the ability to use a web browser to monitor and configure your EmberNet. For more information, refer to the EmberNet View User’s Guide (document 120-0004-100).•An EmberNet Node to provide access to the EmberNet network.The SBC and the EmberNet node communicate using the EmberNet Host API over the SPI high-speed serial interface, just as an EmberNet Node communicates with a host processor on a carrier board.EmberNet Gateway Connections• Power is supplied to the EmberNet Gateway via a 9V power supply.• An RJ-45 Ethernet connection provides access to the TCP/IP Ethernet network.• A (DB-9) serial connection (RS-232) allows you to connect the Gateway to any serial device for configuration. EmberNet NodeStrongARMLinuxComputerw/ Intrinsyc Linux Power InputEthernetSerial Port

EmberNet Developer Kit User’s Guide 120-0002-210 1-13Software ComponentsC o m p a n y C o n f i d e n t i a lSoftware ComponentsA number of EmberNet software tools are used in the development of Ember Enabled devices. GCC CompilerThe EmberNet Developer Kit includes the Win32 build of avr-gcc 3.2, the GCC Compiler for a Windows development environments. The AVR-GCC C compiler is made available under the GNU general public license. There are a number of web sites, including www.avrfreaks.com and gcc.gnu.org, that offer documentation and support via discussion boards for this compiler. Alternate CompilerIf you are interested in purchasing a commercial compiler, we recommend the IAR Embedded Workbench from IAR Systems. Refer to www.iar.com for more infor-mation and pricing, or to download a free demo copy. EmberNet Node Binary for EmberNet Node HardwareThe EmberNet Node binary contains the software image for the EmberNet Node. This image is provided in the event that you need to reload it onto the EmberNet Node.EmberNet Host API and EmberNet SPI Protocol (ESP) Command SetThe EmberNet Host API is a set of commands that allows the EmberNet Node and the host processor to communicate across the high-speed SPI interface. The API should be used if you are using the ATMel 8535 processor on the breakout board for application development. For more information on the API, refer to the Ember-Net Application Development Guide (document 120-0003-100). For development using another processor, you should use the API source code and the EmberNet SPI Protocol (ESP) command set to port the API to the processor of your choice.

EmberNet Developer Kit Overview 1-14 120-0002-210 EmberNet Developer Kit User’s Guide C o m p a n y C o n f i d e n t i a lEmberNet Debug Logging UtilityThe EmberNet Debug Logging Utility provides a means for testing and analyzing EmberNet applications. EmberNet Nodes attached to the breakout board can gen-erate a variety of debugging messages (configurable through EmberNet Host API) and send them through the Ethernet connection to the EmberNet Debug Logger Utility, a Java program that collects and formats the raw data.Sample ApplicationsA few sample applications are included in the EmberNet Developer Kit so that you can examine sample source code for an Ember Enabled application. For more infor-mation on the sample applications, refer to Chapter 3. You can also checksupport.ember.com for additional sample applications. Application TemplateA template is included for assisting in the development of the application for your Ember Enabled device. Refer to Chapter 3 for information on using the template.

EmberNet Developer Kit User’s Guide 120-0002-210 2-1C o m p a n y C o n f i d e n t i a lCHAPTER 2 Connecting the HardwareOverviewIn general, when developing an Ember Enabled device with the Developer Kit, use the following steps:1. Attach the antennae to the EmberNet Nodes and EmberNet Gateways. 2. Attach the EmberNet Breakout Board to the development system PC and to any external devices (sensors, external processor, etc.)3. Write the application code using the EmberNet Host API. Refer to the Ember-Net Application Development Guide. 4. Download the application code to the processor using the USB programmer. Refer to Chapter 4 for information on installing and using the USB programmer.5. Install the EmberNet Gateway to monitor the application using EmberNet View. Refer to the EmberNet View User’s Guide for more details on using this moni-toring tool.6. Use the EmberNet Debug Logging Utility to test and analyze EmberNet appli-cations. Refer to Chapter 5 for information on installing and using the Ember-Net Debug Logging Utility.This chapter discusses attaching antennae to EmberNet Nodes and Gateways, con-necting an EmberNet Breakout Board for development, and installing an EmberNet Gateway.

Navigation menu