Digi Rabbit Control for Device Cloud Application Kit Quick start guide

Brand: Digi

Model: Rabbit Control for Device Cloud Application Kit

Type: Quick start guide

Digi Rabbit Control for Device Cloud Application Kit combines Digi's ConnectPort X4 gateway with Rabbit's BL4S100 single-board computer to enable wireless-enabled industrial control. It features a sample application that can be used as a template for your own, and comes with instructions for setup and use. The kit also includes the BL4S100 User's Manual for complete hardware reference and software function calls, and sample programs specific to the operation of the BL4S100.

Rabbit, XBee, and Dynamic C are registered trademarks of Digi International Inc. iDigi is a trademark of Digi International Inc.

ZigBee is a registered trademark of the ZigBee Alliance.

Rabbit Control for iDigi™ Application Kit

BL4S100 Getting Started Instructions

The Rabbit Control for iDigi Application Kit combines Digi’s ConnectPort™ X4 gateway with Rabbit’s

BL4S100 single-board computer to demonstrate the plumbing of wireless-enabled, industrial control

through to an end-user application. Sample applications are provided and can be used as a template for

your own application. These Getting Started instructions explain how to set up the BL4S100. Separate

Getting Started instructions explain how to set up Digi’s ConnectPort™ X4 gateway.

Application Kit Contents

• Digi’s ConnectPort™ X4 gateway with power supply, and cables.

• BL4S100 single-board computer with XBee ZB RF module.

• Dynamic C

CD-ROM, with Rabbit-branded product documentation on disk.

• USB programming cable, used to connect your PC USB port to the BL4S100.

• Universal AC adapter, 12 V DC, 1 A (includes Canada/Japan/U.S., Australia/N.Z., U.K., and

European style plugs).

• Demonstration Board with pushbutton switches and LEDs. The Demonstration Board can be

hooked up to the BL4S100 to demonstrate the I/O and capabilities of the BL4S100.

• DB9 to bare leads serial cable.

• Two CAT 5/6 Ethernet cross-over cables.

• Wire assembly to connect Demonstration Board to BL4S100.

• Screwdriver.

• Rabbit 4000 Processor Easy Reference poster.

• Registration card.

Visit our online Rabbit store at www.rabbit.com/store/ for the latest information on peripherals and acces-

sories that are available for the BL4S100 series of single-board computers.

Step 1 — Install Dynamic C

Before doing any development, you must install Dynamic C. Insert the CD from the Application Kit in

your PC’s CD-ROM drive. If the installation does not auto-start, run the setup.exe program in the root

directory of the Dynamic C CD. Install any Dynamic C modules after you install Dynamic C.

Run a Sample Program

Once the BL4S100 is connected to your PC and to a power source, start Dynamic C by double-clicking on the

Dynamic C icon on your desktop or in your Start menu. Select Store Program in Flash on the “Com-

piler” tab in the Dynamic C Options > Project Options menu. Then click on the “Communications” tab

and verify that Use USB to Serial Converter is selected to support the USB programming cable. Select

the COM port used for the USB connection in the dropdown menu under Options > Project Options, on

the Communications tab, then click OK.

Use the File menu to open the sample program PONG.C, which is in the Dynamic C SAMPLES folder. Press

function key F9 to compile and run the program.The STDIO window will open on your PC and will display a

small square bouncing around in a box.

Where Do I Go From Here?

If the sample program ran fine, you are now ready to go on to other sample programs. Information on how to

set up and use Digi’s ConnectPort™ X4 gateway and Application Note AN422, Using the Rabbit Control for

iDigi™ Application Kit and the iDigi BL4S100 Add-On Kit ZB, are available on the www.digigreen.com

Web site. Instructions for the sample programs and the source code are provided to allow you to modify them

for your own use.

The BL4S100 User’s Manual included with the Dynamic C installation provides complete hardware

reference information and describes the software function calls for the BL4S100. Sample programs specific to

the operation of the BL4S100 are available in the Dynamic C SAMPLES\BL4S1xx folder.

The Digi

XBee USB identified in Chapter 2 of the BL4S100 User’s Manual and additional XBee ZB RF

modules are available in a separate Rabbit-branded ZigBee Mesh Network Add-On Kit. These accessories can

be used in a ZigBee network with the BL4S100.

Troubleshooting

If Dynamic C cannot find the target system (error message "No Rabbit Processor Detected."):

• Check that the BL4S100 is powered correctly — the red power LED next to the power connector at J17

should be lit when the AC adapter is plugged in.

• Check both ends of the programming cable to ensure that they are firmly plugged into the PC and the

PROG connector, not the DIAG connector, is plugged in to the programming port on the BL4S100 with

the marked (colored) edge of the programming cable towards pin 1 of the programming header.

• If a program compiles and loads, but then loses target communication before you can begin debugging, it is

possible that your PC cannot handle the default debugging baud rate. Locate the Serial Options dialog in

the Dynamic C Options > Project Options > Communications menu. Choose a lower debug baud

rate.

Press <Ctrl-Y> to force Dynamic C to recompile the BIOS. You should receive a

Bios compiled

successfully

message once these steps are completed successfully.

If there are any other problems:

• Use the Dynamic C Help menu to get further assistance with Dynamic C.

• Check the Rabbit Technical Bulletin Board and forums at www.rabbit.com/support/bb/ and at

www.rabbit.com/forums/.

• Use the Technical Support e-mail form at www.rabbit.com/support/.

NOTE: If you purchased your BL4S100 or Rabbit Control for iDigi Application Kit through a distributor or

through a Rabbit partner, contact the distributor or partner first for technical support.

Hardware Connections

Step 1 — Connect Programming Cable

The programming cable connects the BL4S100 to the PC running Dynamic C to download programs and

to monitor the BL4S100 module during debugging.

Connect the 10-pin PROG connector of the programming cable to header J8 on the BL4S100. Ensure that

the colored edge lines up with pin 1 as shown. (Do not use the DIAG connector, which is used for monitor-

ing only.) Connect the other end of the programming cable to an available USB port on your PC or

workstation.

Figure 1. Connect Programming Cable and Power Supply

Your PC should recognize the new USB hardware, and the LEDs in the shrink-wrapped area of the USB

programming cable will flash — if you get an error message, you will have to install USB drivers. Drivers

for Windows XP are available in the Dynamic C Drivers\Rabbit USB Programming Cable\

WinXP_2K folder — double-click DPInst.exe to install the USB drivers. Drivers for other operating

systems are available online at www.ftdichip.com/Drivers/VCP.htm.

Step 2 — Connect Power

Once all the other connections have been made, you can connect power to the BL4S100.

First, prepare the AC adapter for the country where it will be used by selecting the plug. The Add-On Kit

presently includes Canada/Japan/U.S., Australia/N.Z., U.K., and European style plugs. Snap in the top of

the plug assembly into the slot at the top of the AC adapter as shown in Figure 2, then press down on the

spring-loaded clip below the plug assembly to allow the plug assembly to click into place. Release the clip

to secure the plug assembly in the AC adapter.

Connect the power supply to header J17 on the BL4S100 as shown in Figure 1. Be sure to match the latch

mechanism with the top of the connector to header J17 on the BL4S100 as shown. The Micro-Fit

connec-

tor will only fit one way.

GND

RP1

RP2

OUT2 OUT1 OUT0 IN3 IN2 IN1 IN0 +K GND

+5 V +K2 +K1 GND OUT7 OUT6 OUT5 OUT4 OUT3

BUTTON

DS1

DS2

RX TX/1W CTS RTS +5 V GND

RNET

PWR

R41

R31

R43

R45

R40

R38R44

R33

C13

R24

R30

R25

R35

C11

JP1

C10

D10

D11

R23

R26

R34

R13

R14

R15

R16

R17

R18

R19

R20

R21

R22

R12

R10

R11

D12

D15

D14

D13

C58

C69

C74

R69

R72

R73

R74

U18

J10

J11

AIN0 AIN1

AIN2 AIN3

R87

R89

R90

R93

AIN0 AIN1 AIN2 AIN3 AIN4 AIN5 AIN6 AIN7 AGND

IN11 IN10 IN9 IN8 IN7 IN6 IN5 IN4 GND

RST

PWR

AGND

C65

C64

C68

R63

R65

BT1

C86

C87

R86

U20

C96

C91

C92

C95

C97

C101

C102

C103

C104

C105

C106

C107

C108

R98

R99

R100

R101

R102

R103

R104

R105

R106

R107

R108

R109

R110

R111

R112

R113

ADC PROGRAMMER

GND

J12

J15

R115

RP5

RP3

R94

R91

D19

D20

D21

D22

D23

D24

D25 D26

RP4

J13

RP6

J16

C114

J14

R117

D27

DS3

DS4

J17

PWR

L12

C93

D18

C112

R116

R118

L10 L11

C109

C110

R88

C98

C111

C99

U21

C100

R95

R96

R77

C94

R92

C113

R97

U19

R75

R85

C90

R76

C89

C88

U17

C17

C18

C19

C20

C21

C22

C23

C24

C41

C44

R54

R55

C46

C49

C47

C50

U15

R62

R60

D17

C60

R66

C78

C80

C82

C81

C83

C84

R67

R68

R70

R71

R79

R80

R78

R81

R82

R83

R84

C70

C75

C72

C76

C73

C77

C71

C85

C79

U16

C55

C59

C66

R59

C38

C42

C43

C30

C33

C29

C32

C37

C52

R58

C51

C57

C67

C62

C63

C53

C54

R57

C61

R61

R64

R47

U13

R46

R51

C27

C34

C31

C28

R56

C45

C40

C39

U14

C56

U10

R53

R52

C35

C36

U12

C26

C25

R48

R49

D16

U11

R28

R29

R50

C48

C16

C15

C14

C12

R27

R39

R42

R37

R32

R36

XBee

Colored

edge

PC USB port

PROG

DIAG

Programming

Cable

PROG

Figure 2. Power Supply Connections

Plug in the AC adapter. The red LED next to the power connector at J17 should light up. The BL4S100 is now

ready to be used.

CAUTION: Unplug the power supply while you make or otherwise work with the connections to the headers.

This will protect your BL4S100 from inadvertent shorts or power spikes.

A hardware reset is done by unplugging the power supply, then plugging it back in, or by pressing the RESET

button located next to the Ethernet jack.

Digi Rabbit Control for Device Cloud Application Kit Quick start guide

Digi Rabbit Control for Device Cloud Application Kit Quick start guide

Digi Rabbit Control for Device Cloud Application Kit Quick start guide

Related papers

Other documents