101-1279 Rabbit Semiconductor, 101-1279 Datasheet

PLASTIC ENCLOSURE FOR BL4S100

101-1279

Manufacturer Part Number
101-1279
Description
PLASTIC ENCLOSURE FOR BL4S100
Manufacturer
Rabbit Semiconductor
Datasheet

Specifications of 101-1279

Accessory Type
Enclosure
Product
Prototyping Accessories
Processor Type
BL4S100
Board Size
146 mm x 96 mm x 16 mm
Interface Type
Ethernet
For Use With/related Products
BL4S100
Lead Free Status / RoHS Status
Not applicable / Not applicable
Other names
316-1159
BL4S100
C-Programmable Single-Board Computer with Networking
User’s Manual
019–0172_C

Related parts for 101-1279

101-1279 Summary of contents

Page 1

BL4S100 C-Programmable Single-Board Computer with Networking User’s Manual 019–0172_C ...

Page 2

BL4S100 User’s Manual Part Number 019-0172_C • Printed in U.S.A. ©2008-2010 Digi International Inc. • All rights reserved. Digi International reserves the right to make changes and improvements to its products without providing notice. Rabbit, RabbitCore, and Dynamic C are ...

Page 3

Chapter 1. Introduction 1.1 BL4S100 Description ...........................................................................................................................4 1.2 BL4S100 Features.................................................................................................................................4 1.3 Development and Evaluation Tools......................................................................................................6 1.3.1 Tool Kit .........................................................................................................................................6 1.3.2 Software ........................................................................................................................................7 1.3.3 Optional Add-Ons .........................................................................................................................7 1.4 CE Compliance .....................................................................................................................................8 1.4.1 Design Guidelines .........................................................................................................................9 1.4.2 Interfacing the BL4S100 to Other ...

Page 4

Chapter 4. Software 4.1 Running Dynamic C ...........................................................................................................................33 4.1.1 Upgrading Dynamic C ................................................................................................................35 4.1.2 Add-On Modules.........................................................................................................................35 4.2 Sample Programs ................................................................................................................................36 4.2.1 Digital I/O ...................................................................................................................................37 4.2.2 Serial Communication.................................................................................................................43 4.2.3 A/D Converter Inputs..................................................................................................................45 4.2.4 Real-Time Clock .........................................................................................................................46 4.2.5 TCP/IP Sample Programs ...........................................................................................................46 ...

Page 5

D.1 Digital I/O Pin Associations ............................................................................................................127 D.2 Interpreting Error Codes ..................................................................................................................128 Appendix E. Plastic Enclosure E.1 Assembly Instructions ......................................................................................................................131 E.2 Dimensions .......................................................................................................................................133 Appendix F. Additional Configuration Instructions F.1 XBee Module Firmware Downloads ................................................................................................134 F.1.1 Dynamic C v. 10.44 and Later ...

Page 6

The BL4S100 series of high-performance, C-programmable single- board computers offers built-in RS-232, digital I/O and analog inputs combined with Ethernet and ZigBee network connectivity in a compact form factor. The BL4S100 single-board computers are ideal for both discrete manufacturing and ...

Page 7

Battery-backed real-time clock. • Watchdog supervisor. Four BL4S100 models are available. Their standard features are summarized in Table 1. Feature Microprocessor Program Execution SRAM Data SRAM Serial Flash Memory (program) A/D Converter Ethernet Interface ZigBee Interface BL4S100 single-board computers ...

Page 8

Development and Evaluation Tools 1.3.1 Tool Kit A Tool Kit contains the hardware essentials you will need to use your own BL4S100 single- board computer. These items are supplied in the Tool Kit. • Getting Started instructions. • Dynamic ...

Page 9

... Rabbit sales representative or authorized distributor. 1.3.3 Optional Add-Ons Rabbit has a plastic enclosure and a Mesh Network Add-On Kit available for the BL4S100. • Mesh Network Add-On Kit (Part No. 101-1272)  ® Digi XBee USB (used as ZigBee coordinator)  ...

Page 10

CE Compliance Equipment is generally divided into two classes. CLASS A Digital equipment meant for light industrial use Less restrictive emissions requirement: less than 40 dB µV (40 dB relative to 1 µV/m) or 300 µV/m ...

Page 11

Design Guidelines Note the following requirements for incorporating the BL4S100 series of single-board computers into your application to comply with CE requirements. General • The power supply provided with the Tool Kit is for development purposes only ...

Page 12

Chapter 2 explains how to connect the programming cable and power supply to the BL4S100. BL4S100 User’s Manual ETTING TARTED 10 ...

Page 13

BL4S100 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 ...

Page 14

Step 2 — Connect Power Supply 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 Tool ...

Page 15

Installing Dynamic C If you have not yet installed Dynamic C version 10.44 (or a later version now by inserting the Dynamic C CD from the BL4S100 Tool Kit in your PC’s CD-ROM drive. If autorun is ...

Page 16

Starting Dynamic C Once the BL4S100 is connected to your PC and to a power source, double-clicking on the Dynamic C icon on your desktop or in your Store Program in Flash on the “Compiler” tab in the Dynamic ...

Page 17

Run a ZigBee Sample Program This section explains how to run a sample program in which the BL4S100/BL4S150 is used in its default setup as a router and the Digi ® 1. Connect the Digi XBee USB acting as ...

Page 18

Where From Here? NOTE: If you purchased your BL4S100 through a distributor or Rabbit partner, contact the distributor or partner first for technical support. If there are any problems at this point: • Use the Dynamic ...

Page 19

Chapter 3 describes the principal subsystems for the BL4S100. • Digital I/O • Serial Communication • A/D Converter Inputs • Memory Figure 4 shows these Rabbit-based subsystems designed into the BL4S100. Figure 4. BL4S100 Subsystems BL4S100 User’s Manual 3. S ...

Page 20

BL4S100 Pinouts The BL4S100 pinouts are shown in Figure 5. 3.1.1 Connectors Standard BL4S100 models are equipped with an RJ-45 Ethernet jack, four 1 × 9 screw- terminal headers and one 1 × 6 screw-terminal header for the I/O ...

Page 21

Digital I/O 3.2.1 Digital Inputs The BL4S100 has 12 digital inputs, IN0–IN11, each of which is protected over a range of – +36 V. The inputs are factory-configured to be pulled but they ...

Page 22

The actual switching threshold is approximately 1.40 V. Anything below this value is a logic 0, and anything above 1. logic 1. The digital inputs are each fully protected over a range of - +36 ...

Page 23

Keep the following guidelines in mind when selecting special uses for the digital input pins. • Interrupts, event counters, and input capture are available on any digital input pin. • Each Quadrature Decoder channel requires at least two digital input ...

Page 24

Digital Outputs The BL4S100 has eight digital outputs, OUT0–OUT7, which can each sink up to 200 mA. Figure 8 shows a wiring diagram for using the sinking digital outputs. Figure 8. BL4S100 Digital Outputs OUT0–OUT3 are powered by +K1, ...

Page 25

Blocks of digital output pins are associated with counters/timers on the Rabbit RIO chip. Table 4 provides complete details for these associations. Table 4. Counter/Timer Associations for BL4S100 Digital Output Pins Configurable I/O Pin(s) OUT0–OUT1 OUT2–OUT3 OUT4–OUT5 OUT6–OUT7 Appendix D ...

Page 26

PWM/PPM Outputs Setup A PWM output is described as noninverted when it starts high, remains high for a duty cycle that is a fraction of the period, then goes low for the remainder of the period. Similarly, an inverted ...

Page 27

Serial Communication The BL4S100 has two RS-232 serial ports, which can be configured as one RS-232 serial channel (with RTS/CTS two RS-232 (3-wire) channels using the ware function call. Table 5 summarizes the options. Table 5. Serial ...

Page 28

The BL4S100 can be reset from the programming port via the /RESET_IN line. The Rabbit microprocessor status pin is also presented to the programming port. The status pin is an output that can be used to send ...

Page 29

A/D Converter Inputs The single A/D converter chip used in the BL4S100 has a resolution of 12 bits (11 bits for the value and one bit for the polarity). The A/D converter chip has a programmable-gain amplifier. Each external ...

Page 30

Table 6. A/D Converter Input Voltage Ranges Amplifier Gain 4–20 mA operation is available with an ampli- fier gain the differential mode, each individual channel is limited to half the total voltage—for ...

Page 31

A/D Converter Calibration When you start to develop your application, run folder to save the factory calibration constants in case you inad- SAMPLES\UserBlock vertently write over them while running the sample programs. To get the best results from the ...

Page 32

USB Programming Cable The USB programming cable is used to connect the serial programming port of the BL4S100 USB port. The programming cable converts the voltage levels used by the PC USB port to the CMOS ...

Page 33

Other Hardware 3.6.1 Clock Doubler The BL4S100 takes advantage of the Rabbit microprocessor’s internal clock doubler. A built-in clock doubler allows half-frequency crystals to be used to reduce radiated emissions. The clock doubler may be disabled if the higher ...

Page 34

Memory 3.7.1 SRAM All BL4S100 boards have 512KB of battery-backed data SRAM, and 512KB–1MB of fast program execution SRAM. 3.7.2 Flash Memory BL4S100 boards have 1MB—2MB of serial flash memory. Writing to arbitrary flash memory addresses at run time ...

Page 35

Dynamic integrated development system for writing embedded software. It runs on an IBM-compatible PC and is designed for use with single-board computers and other devices based on the Rabbit microprocessor. Chapter 4 provides the libraries, function calls, ...

Page 36

Dynamic C has a number of standard features: • Full-feature source and/or assembly-level debugger, no in-circuit emulator required. • Royalty-free TCP/IP stack with source code and most common protocols. • Hundreds of functions in source-code libraries and sample programs:  ...

Page 37

Upgrading Dynamic C 4.1.1.1 Patches and Updates Dynamic C patches that focus on bug fixes and updates are available from time to time. Check the Web site at www.rabbit.com/support/ updates. The default installation of a patch or update is ...

Page 38

Sample Programs Sample programs are provided in the Dynamic C demonstrates the output to the PONG.C The various directories in the trate the use of the corresponding Dynamic C libraries. The folder provides sample programs specific to the BL4S100. ...

Page 39

Digital I/O The following sample programs are found in the Figure 14 shows the signal connections for the sample programs that illustrate the use of the digital inputs. Figure 14. Digital Inputs Signal Connections —Demonstrates the use of the ...

Page 40

Figure 15 shows the signal connections for the sample programs that illustrate the use of the digital outputs. Figure 15. Digital Outputs Signal Connections —Demonstrates the use of the sinking digital outputs. Using the Demonstra- • DIGOUT.C tion Board, you ...

Page 41

Rabbit RIO interrupt service capabilities. • INTERRUPTS.C Set up the Demonstration Board as shown in Figure 14 with IN0 connected to SW1. The sample program sets up two interrupt sources, an external interrupt tied to ...

Page 42

Once the connections have been made, compile and run this sample program. Change the offset and duty cycle for a given PPM channel via the Dynamic C and watch the change to the begin and end counts measured on the ...

Page 43

QUADRATURE_DECODER.C BL4S100. See Figure 16 for hookup instructions of the digital I/O pins on headers J3 and J4 with the Demonstration Board. Figure 16. Quadrature Decoder Signal Connections Once the connections have been made, compile and run this sample ...

Page 44

PPM_QUADRATURE_DECODER.C output channels connected back to four digital inputs to simulate two Quadrature Decoders feeding signals into the BL4S100. The PWM and PPM outputs are adjusted through a menu system to simulate the movement of a Quadrature Decoder. The ...

Page 45

Serial Communication The following sample programs are found in the —This sample program repeatedly sends byte values 0–127 from Serial Port D • PARITY.C to Serial Port F. The program will cycle through parity types on Serial Port D. ...

Page 46

Stop bits: 1 Flow control: None Once you compile and run this program, configure the serial port using the following menu options in the Dynamic C Menu q - Quit s - Send "Sample Text" Reset Counters n ...

Page 47

A/D Converter Inputs The following sample programs are found in the You will need a separate power supply and a multimeter to use with these sample programs. NOTE: The calibration sample programs will overwrite the calibration constants set at ...

Page 48

ADC_RD_CALDATA.C gain and offset, in the Dynamic C operation. —Demonstrates how to read and display voltage and equivalent val- • ADC_RD_DIFF.C ues for a differential A/D converter channel using calibration coefficients ...

Page 49

BL4S100 Libraries Two library directories provide libraries of function calls that are used to develop applica- tions for the BL4S100. —libraries associated with features specific to the BL4S100. The functions in • BL4S1xx the library are described in Section ...

Page 50

BL4S100 Function Calls 4.4.1 Board Initialization void brdInit (void); FUNCTION DESCRIPTION Call this function at the beginning of your program. This function initializes Parallel Ports A–E, the Rabbit RIO chip, and the A/D converter. The ports are initialized according ...

Page 51

Digital I/O int setDigIn(int channel); FUNCTION DESCRIPTION Sets an input channel general digital input. PARAMETERS digital input channel, 0–11 (pins IN0–IN11) channel RETURN VALUE 0 — success. — invalid parameter value. -EINVAL SEE ALSO brdInit, digIn, ...

Page 52

FUNCTION DESCRIPTION Reads the state of the 12 digital input channels in banks input channels. PARAMETER digital input bank pins: bank RETURN VALUE Data read from the bank of digital inputs. Data Bits ...

Page 53

FUNCTION DESCRIPTION Sets the specified channel interrupt. The interrupt can be configured as a rising edge, falling edge, or either edge. PARAMETERS digital input channel to be configured as an ...

Page 54

FUNCTION DESCRIPTION Sets up Quadrature Decoder functionality on the specified channels. The Quadrature Decoder may optionally use an index channel. PARAMETERS channel to use as Input A (also known as in-phase ...

Page 55

FUNCTION DESCRIPTION Sets up the channel as a counter input, with selectable modes and edge settings. The counter will increment or decrement on each selected edge event. Use to read the ...

Page 56

RETURN VALUE 0 — success. — invalid parameter value or pin use. -EINVAL — pin type does not permit this function. -EPERM — resource needed by this function is not available. -EACCESS — internal data fault detected. -EFAULT ...

Page 57

FUNCTION DESCRIPTION Sets up the channel as an event capture input, with selectable modes and edge settings. The counter will run from a gated main or prescaled clock signal based on ...

Page 58

BL_CNT_TIL_END all others modes — end input and edge can be selected. For all modes, the prescale clock and save limit flags can be used (OR in). For input and edge selection, use: ...

Page 59

FUNCTION DESCRIPTION Reads the current count of the counter register within the counter block hosting the given channel. PARAMETERS digital input channel that uses the desired counter block, channel 0–11 (pins IN0–IN11) pointer to word ...

Page 60

FUNCTION DESCRIPTION Reads the current value of the end register within the counter block hosting the given channel. PARAMETERS digital input channel that uses the desired counter block, channel 0–11 (pins IN0–IN11) pointer to word ...

Page 61

FUNCTION DESCRIPTION Sets the value of the limit register within the counter block hosting the given channel. This new value will take effect on the next counter overflow or by resetting the counter via the ...

Page 62

FUNCTION DESCRIPTION Sets the synch for the block the digital input channel is associated with. Note that when more than one block is synchronized to the same synch signal (global or external), each ...

Page 63

FUNCTION DESCRIPTION Sends a single pulse to the global synch inputs of all RIO chips. Note that when more than one block is synchronized to the same synch signal (global or external), each block has its own independent ...

Page 64

FUNCTION DESCRIPTION Configures the output channel as a simple digital output. The output state of the chan- nel is also initialized to logic 0 or logic 1 based on the function should be used to ...

Page 65

FUNCTION DESCRIPTION Sets the state of a digital output channel to a logic logic 1. This function will only allow control of pins that are configured by the PARAMETERS digital output channel, ...

Page 66

FUNCTION DESCRIPTION Sets the state (logic 0 or logic bank of 8 digital output pins to the states contained in the parameter. This function only updates the channels that are configured to ...

Page 67

FUNCTION DESCRIPTION Sets up a PWM output on the selected digital output channel with the specified frequency and duty cycle. The PWM output can be inverted. The PWM channel ...

Page 68

RETURN VALUE 0 — success. — invalid parameter value. -EINVAL — pin type does not permit this function. -EPERM — resource needed by this function is not available. -EACCES — internal data fault detected. -EFAULT positive number — ...

Page 69

FUNCTION DESCRIPTION Sets up a PPM output on the selected digital output channel with the specified frequency and duty cycle. The PPM output of the ...

Page 70

RETURN VALUE 0 — success. — invalid parameter value. -EINVAL — pin type does not permit this function. -EPERM — resource needed by this function is not available. -EACCES — internal data fault detected. -EFAULT positive number — ...

Page 71

FUNCTION DESCRIPTION Sets the frequency of all the PWM or PPM outputs on the same block as the channel. Will preserve the duty cycle and offset percentages for all of the channels on the same ...

Page 72

FUNCTION DESCRIPTION Sets the duty cycle of the PWM or PPM output on a digital output channel. Will affect any PWM/PPM that has been bound to this channel’s PWM/PPM. PARAMETERS digital output channel that is ...

Page 73

FUNCTION DESCRIPTION Sets the offset of a PPM output on a digital output channel. This function call will not affect the position of the trailing edge of the PPM output and so will change the ...

Page 74

FUNCTION DESCRIPTION Disables a PWM/PPM output and sets the output to the same PWM/PPM operation as before by calling PARAMETERS digital output channel that is getting its PWM/PPM disabled, channel 0–7 (OUT0–OUT7) state that the ...

Page 75

FUNCTION DESCRIPTION Sets the synch for the block the digital output channel is associated with. Note that when more than one block is synchronized to the same synch signal (global or external), each ...

Page 76

FUNCTION DESCRIPTION Returns the block match register use for the given channel. May optionally be filtered to specific sources by the PARAMETERS digital output channel about which to get match information, channel 0–7 (OUT0–OUT7) source ...

Page 77

Rabbit RIO Interrupt Handlers int addISRIn(int channel, int ier, void (*handler)()); FUNCTION DESCRIPTION Adds an interrupt handler for the interrupts specified in the RIO block hosting the given configurable I/O pin. The interrupt service routine (ISR) is always disabled ...

Page 78

FUNCTION DESCRIPTION Adds an interrupt handler for the interrupts specified in the RIO block hosting the given digital output pin. The interrupt service routine (ISR) is al- ways disabled when created. Call given ...

Page 79

FUNCTION DESCRIPTION Sets the Interrupt Enable Register (IER) mask for an interrupt handler. Note that the in- terrupt handler must be currently disabled to set the IER value. Disabling the ISR can be done by ...

Page 80

FUNCTION DESCRIPTION Enables or disables an interrupt handler. PARAMETERS index to the desired ISR isr_handle non-zero enables the ISR, enable zero disables the ISR RETURN VALUE 0 — success. — invalid parameter given. -EINVAL SEE ...

Page 81

Serial Communication Library files included with Dynamic C provide a full range of serial communications sup- port. The library provides a set of circular-buffer-based serial functions. The RS232.LIB library provides packet-based serial functions where packets can be delim- PACKET.LIB ...

Page 82

A/D Converter Inputs void anaInConfig(int channel, int opmode); FUNCTION DESCRIPTION Configures an A/D converter input channel for a given mode of operation. This function must be called before accessing the A/D converter chip. The channel pairs for the differential ...

Page 83

FUNCTION DESCRIPTION Calibrates the response of a given A/D converter channel as a linear function using the two conversion points provided. Gain and offset constants ...

Page 84

Gain Code the first A/D converter value value1 the voltage corresponding to the ...

Page 85

FUNCTION DESCRIPTION Reads the state of an A/D converter input channel. PARAMETERS analog input channel number ( corresponding to AIN0–AIN7 channel Single-Ended channel the gain ...

Page 86

RETURN VALUE A value corresponding to the voltage on the analog input channel: 0–2047 for 11-bit A/D conversions value of BL_ERRCODESTART A/D converter operation errors (will not create run-time error): BL_TIMEOUT BL_OVERFLOW BL_WRONG_MODE System errors (can create run-time ...

Page 87

FUNCTION DESCRIPTION Reads the state of a single-ended A/D converter input channel and uses the previously set calibration constants to convert it to volts. The voltage ranges given in the table below are nominal ranges ...

Page 88

RETURN VALUE A voltage on the analog input channel value of dicate an error condition: A/D converter operation errors (will not create run-time error): — A/D converter is not calibrated for this channel/gain. BL_NOT_CAL — A/D ...

Page 89

FUNCTION DESCRIPTION Reads the state of a differential A/D converter input channel and uses the previously set calibration constants to convert it to volts. Voltage ranges given in the table below are the nominal ranges ...

Page 90

RETURN VALUE A voltage on the analog input channel value of indicate an error condition: A/D converter operation errors (will not create run-time error): — A/D converter is not calibrated for this channel/gain. BL_NOT_CAL — A/D ...

Page 91

FUNCTION DESCRIPTION Reads the state of a single-ended A/D converter input channel and uses the previously set calibration constants to convert floating-point current value in milli amps. The nominal range ...

Page 92

FUNCTION DESCRIPTION Reads the calibration constants, gain and offset, from the user block on the flask. PARAMETER analog input channel number ( corresponding to AIN0–AIN7 channel Single-Ended channel 0 1 ...

Page 93

RETURN VALUE 0 — success. -1 — invalid address or range. -2 — no valid user block found (block version 3 or later) -3 — flash read error — invalid parameter -EINVAL SEE ALSO anaInCalib, _anaInAddr BL4S100 User’s ...

Page 94

FUNCTION DESCRIPTION Low-level driver to read the ADS7870 A/D converter chip. Reads the voltage of an an- alog input channel by serial clocking an 8-bit command to the ADS7870 by its Direct Mode method. anaInConfig() assumes that ...

Page 95

Differential channel_code Input Lines 0 +AIN0 -AIN1 1 +AIN2 -AIN3 2 +AIN4 -AIN5 3 +AIN6 -AIN7 4 Reserved 5 Reserved 6 Reserved 7 Reserved RETURN VALUE A value corresponding to the voltage on the analog input channel, which ...

Page 96

SRAM Use The BL4S100 has a battery-backed data SRAM and a program-execution SRAM. Dynamic C provides the protected into the battery-backed SRAM. The compiler generates code that maintains two copies of each protected variable in the battery-backed SRAM. The ...

Page 97

U Chapter 5 discusses using the Ethernet TCP/IP features on the BL4S100 boards. 5.1 TCP/IP Connections Before proceeding you will need to have the following items. • If you don’t have Ethernet access, you will need at least a ...

Page 98

BL4S100 User’s PC Crossover CAT 5/6 Ethernet cable Direct Connection (network of 2 computers) Figure 17. Ethernet Connections The PC running Dynamic C through the serial programming port on the BL4S100 does not need to be the PC with the ...

Page 99

TCP/IP Sample Programs We have provided a number of sample programs demonstrating various uses of TCP/IP for networking embedded systems. These programs require that you connect your PC and the BL4S100 together on the same network. This network can ...

Page 100

... Half-Duplex” “Auto-Negotiation” connection on the “Advanced” tab. NOTE: Your network interface card will likely have a different name. 3. Now select the IP Address click on “Properties” to assign an IP address to your computer (this will disable “obtain an IP address automatically”): IP Address : 10.10.6.101 Netmask : 255.255.255.0 Default gateway : 10.10.6.1 4. Click <OK> or < ...

Page 101

Run the PINGME.C Demo Connect the crossover cable from your computer’s Ethernet port to the BL4S100’s RJ-45 Ethernet connector. Open this sample program from the compile the program, and start it running under Dynamic C. When the program starts ...

Page 102

Running More Demo Programs With a Direct Connection The following sample programs are found in the Figure 18 shows the signal connections for the sample programs that illustrate the use of TCP/IP. Figure 18. TCP/IP Sample Programs Demonstration Board ...

Page 103

... Dynamic C's receiving the characters typed via TCP/IP. BL4S100 User’s Manual macro in the sample program, enter TCPCONFIG 1 window. It uses a digital input to indicate STDIO ). As long as you have not modified the library. Each character TCP_CONFIG.LIB window, indicating that the board is STDIO TCPCON- 101 ...

Page 104

Where From Here? NOTE: If you purchased your BL4S100 through a distributor or Rabbit partner, contact the distributor or partner first for technical support. If there are any problems at this point: • Use the Dynamic ...

Page 105

U Chapter 6 discusses using the ZigBee features on the BL4S100 and the BL4S150 models. This networking feature is not avail- able on other BL4S100 models. 6.1 Introduction to the ZigBee Protocol The ZigBee PRO specification was ratified in ...

Page 106

The XBee RF module used by the BL4S100 and the BL4S150 presently supports using them in a mesh network. BL4S100 and the BL4S150 boards are preconfigured with ZB router firmware; coordinator and end-device firmware are included in the Dynamic C ...

Page 107

Setting Up the Digi XBee USB Coordinator ® 1. Connect the Digi XBee USB acting as a ZigBee coordinator to an available USB port on your PC or workstation. Your PC should recognize the new USB hardware. 2. Connect ...

Page 108

Confirm the following hardware setup is displayed on the “PC Settings” tab. • 115200 baud • Hardware flow control • 8 data bits • No parity • 1 stop bit Now select the COM port the Digi Com Port” ...

Page 109

Select a device with your mouse pointer and click on the selected device to select that device. This device will now be displayed in the “Selected Device” area. 8. You are now ready to interface with the BL4S100/BL4S150 via ...

Page 110

Channel mask — defaults to 0x1FFE, i.e., all 16 possible channels via the macro in the Dynamic C LIB\Rabbit4000\XBee\XBee_Firmware\XBEE_API.LIB you want to limit the channels used, all devices on your network should use the same channel mask. #define DEFAULT_CHANNELS XBEE_DEFAULT_CHANNELS ...

Page 111

The XBee sample programs in the Dynamic C the use of the XBee function calls. —This sample program demonstrates having the XBee RF module wake the • SLEEP.C Rabbit up upon receipt of a packet. It also demonstrates conditional use ...

Page 112

Once the sample program is compiled and running, open your PC Web browser. As long as you have not modified the the following server address in your Web browser to bring up the Web page served by the sample program. ...

Page 113

Dynamic C Function Calls Function calls for use with the XBee RF modules are in the Dynamic C library. These ZigBee specific function calls are described in An XBee\XBEE_API.LIB Introduction to ZigBee, which is included in the online documentation ...

Page 114

A PPENDIX Appendix A provides the specifications for the BL4S100. BL4S100 User’s Manual A. S PECIFICATIONS 112 ...

Page 115

A.1 Electrical and Mechanical Specifications Figure A-1 shows the mechanical dimensions for the BL4S100. Figure A-1. BL4S100 Dimensions NOTE: All measurements are in inches followed by millimeters enclosed in parentheses. All dimensions have a manufacturing tolerance of ±0.01" (0.25 mm). ...

Page 116

Table A-1 lists the electrical, mechanical, and environmental specifications for the BL4S100. Table A-1. BL4S100 Specifications Feature Microprocessor Ethernet Interface ZigBee Interface Serial Flash Memory (program) Program Execution SRAM Data SRAM Backup Battery Digital Inputs Digital Outputs Analog Inputs Serial ...

Page 117

Table A-1. BL4S100 Specifications (continued) Feature Humidity Board Size RF Module Compliance A.1.1 Exclusion Zone It is recommended that you allow for an “exclusion zone” of 0.25" (6 mm) around the BL4S100 in all directions when the BL4S100 is incorporated ...

Page 118

A.2 Jumper Configurations Figure A-3 shows the header locations used to configure the various BL4S100 options via jumpers. Figure A-3. Location of BL4S100 Configurable Positions Table A-2 lists the configuration options. Table A-2. BL4S100 Jumper Configurations Header Description Serial Communication ...

Page 119

Table A-2. BL4S100 Jumper Configurations (continued) Header Description A/D Converter Voltage/Current J10 Measurement Options A/D Converter Voltage/Current J11 Measurement Options Digital Inputs (IN0–IN11) Pull- J13 Up Options The location at J1 provides a stuffing option to support an RJ-45 jack ...

Page 120

A.3 Use of Rabbit Microprocessor Parallel Ports Table A-3 lists the Rabbit microprocessor parallel ports and their use in the BL4S100 boards. Table A-3. Use of Rabbit Microprocessor Parallel Ports Port I/O PA0–PA7 I/O PB0 Output PB1 Input PB2 Output ...

Page 121

Table A-3. Use of Rabbit Microprocessor Parallel Ports (continued) Port I/O PE4 Output PE5 Output PE6 Output PE7 Output BUFEN Output CLK Output BL4S100 User’s Manual Signal Serial Flash /CS Ethernet LINK XBee /RTS Ethernet ACT /CS (A/D converter) CLK ...

Page 122

A PPENDIX Appendix B describes the power circuitry provided on the BL4S100. B.1 Power Supplies Power is supplied to the BL4S100 boards via the Micro-Fit BL4S100 is protected against reverse polarity by a diode at D27 as shown in Figure ...

Page 123

B.2 Batteries and External Battery Connections The SRAM and the real-time clock on the BL4S100 modules have battery backup. Power to the SRAM and the real-time clock (VRAM) is provided by two different sources, depending on whether the main part ...

Page 124

PPENDIX Appendix C explains how to use the Demonstration Board with the BL4S100 sample programs. BL4S100 User’s Manual EMONSTRATION B OARD 122 ...

Page 125

C.1 Connecting Demonstration Board Before running sample programs based on the Demonstration Board, you will have to con- nect the Demonstration Board from the BL4S100 Tool Kit to the BL4S100 board. Proceed as follows. 1. Use wires to connect screw-terminal ...

Page 126

C.2 Demonstration Board Features The Demonstration Board can be used to illustrate I/O activity via LEDs and pushbutton switches. C.2.1 Pinout Figure C-2 shows the pinouts for the input signals on screw-terminal header J1 and the outputs on screw-terminal header ...

Page 127

The four LED output indicators can be configured as sinking outputs or as sourcing out- puts via jumpers on headers JP1–JP4 as shown in Figure C-4. Figure C-4. LED Output Indicators Sinking or Sourcing Configuration NOTE: Disconnect power before changing ...

Page 128

A PPENDIX Appendix D provides the pin and block associations on the Rabbit RIO chip with their corresponding I/O on the BL4S100 boards. The main shared resource within the RIO chips are the counter/timer blocks — the RIO chip has ...

Page 129

D.1 Digital I/O Pin Associations Table D-1. Digital I/O Pin Associations I/O Pin IN0 IN1 IN2 IN3 IN4 IN5 IN6 IN7 OUT0 OUT1 IN8 IN9 OUT2 OUT3 OUT4 OUT5 OUT6 OUT7 IN10 IN11 BL4S100 User’s Manual Block Pin 0 0 ...

Page 130

D.2 Interpreting Error Codes Some BL4S100 function calls may return a Mode Conflict error code. This error code is a 4-bit value that identifies other pins using the same counter/timer block on a RIO chip that require this block to ...

Page 131

Table D-2 shows all counter/timer modes of the RIO block and which functions can use the given modes. The use of synch signals is allowed with all the functions, but does affect the timer/counter so it may have an adverse ...

Page 132

A PPENDIX The plastic enclosure provides a secure way to protect your BL4S100. The enclosure itself may be mounted on any flat surface. The complete plastic enclosure consists of a base and a cover. The base alone is a convenient ...

Page 133

E.1 Assembly Instructions 1. Attach the BL4S100 board to the plastic enclosure base. Position the BL4S100 board over the plastic enclosure base as shown below in Figure E-1. Attach the BL4S100 to the base using the four 4-40 × ¼ ...

Page 134

Attach the enclosure cover to the base. Position the cover over the plastic enclosure base as shown below in Figure E-2. Attach the cover to the base using the four 4-40 × ½ screws supplied. Figure E-2. Attach Enclosure ...

Page 135

E.2 Dimensions Figure E-3 shows the dimensions for the plastic enclosure. Figure E-3. Plastic Enclosure Dimensions When fully assembled, the total height of the plastic enclosure will be 1.5" (38 mm). NOTE: All measurements are in inches followed by millimeters ...

Page 136

PPENDIX Appendix F provides information on how to find the latest firm- ware for the XBee RF module and the Digi the ZigBee coordinator, and how to install the firmware. F.1 XBee Module Firmware Downloads By default, ...

Page 137

... XBee USB Configuration The Digi XBee USB device is an optional accessory and is available as a part of the Mesh Networking Add on Kit (101-1272), or for separate purchase (101-1286 not a part of the standard BL4S200 Tool Kit. You may experience difficulty when you use the ZigBee sample programs and the Digi XBee USB with the default settings if you are working simultaneously with more than one ZigBee coordinator ...

Page 138

Continue the following steps with the Digi Since the ZigBee Utility XBEE_GPIO_GUI.exe ZigBee Utility running. 1. Start X-CTU from the desktop icon and set the “PC Settings” tab to flow control, HARDWARE 2. On the “PC Settings” ...

Page 139

PRO™ RF modules are presently not compatible with the XBee Series 2 module used with the BL4S100/BL4S150, but the general documentation about ZigBee and the use of AT commands for the XBee™ and the XBee PRO™ RF modules is relevant. ...

Page 140

F.2.2 Update Digi XBee USB Firmware The firmware version used by the Digi installed on the BL4S100/BL4S150. If you have updated the BL4S100/BL4S150 firm- ware (or you have a need to re-install the firmware on the Digi sponding firmware ...

Page 141

A A/D converter ....................... 27 buffered inputs .................. 27 calibration ......................... 29 calibration constants ......... 28 function calls anaIn() ........................... 83 anaInCalib() .................. 81 anaInConfig() ................ 80 anaInDiff() .................... 87 anaInDriver() ................. 92 anaInmAmps() .............. 89 anaInRdCalib() .............. 90 anaInVolts() ...

Page 142

... A/D converter AD_CALDIFF_CH.C ... 29 AD_RD_SE_UNIPO- LAR.C ........................ 46 ADC_AVERAGING_SE_ UNIPOLAR.C ............ 45 ADC_CAL_DIFF.C ...... 45 ADC_CAL_MA.C ........ 45 ADC_CAL_SE_UNIPO- LAR.C ........................ 45 ADC_RD_CALDATA ADC_RD_DIFF.C ........ 46 ADC_RD_MA.C .......... 46 digital I/O DIGIN_BANK.C .......... 37 DIGIN.C ........ 37, 100, 101 DIGOUT_BANK.C ...... 38 DIGOUT.C .................... 38 INTERRUPTS.C ........... 39 PPM_QUADRATURE_ DECODER.C ............. 42 PPM.C ..................... 23, 39 PULSE_CAPTURE_IRQ.C 40 PULSE_CAPTURE PWM.C ................... 23, 40 QUADRATURE_DECOD- ER.C ........................... 41 how to set IP address ........ 97 PONG.C ............................ 14 real-time clock RTC_TEST.C ................ 46 SETRTCKB ...

Page 143

AT_RUNONCE.C ...... 108 MODEMFWLOAD.C 134, 135 SLEEP.C ..................... 109 XBEE_GPIO_SERVER.C 105, 109 XBEE_WEB_GATE- WAY.C ..................... 109 ZigBee ............................... 46 ZigBee setup ................... 104 serial communication ............ 25 function calls serMode() ...................... 79 programming port ............. 25 RS-232 ...

Page 144

BL4S100 Schematic www.rabbit.com/documentation/schemat/090-0265.pdf 090-0252 USB Programming Cable Schematic www.rabbit.com/documentation/schemat/090-0252.pdf 090-0272 Rabbit Demonstration Board www.rabbit.com/documentation/schemat/090-0272.pdf You may use the URL information provided above to access the latest schematics directly. BL4S100 User’s Manual S CHEMATICS 142 ...

Related keywords