background image

 

 

User Manual 

RaspBee

TM

 

 

 

 

 

 

 

 

 

 

 

Document Version V1.6 
2017-12-10

 

Summary of Contents for RaspBee premium

Page 1: ...User Manual RaspBeeTM Document Version V1 6 2017 12 10 ...

Page 2: ...3 Setup the components 9 5 Preconfigured image 10 5 1 Install and start the application without preconfigured image 10 6 Software 10 6 1 deCONZ on RPi 11 6 1 1 Installation 11 6 1 2 Configure serial port 11 6 1 3 Start and run the application 11 6 1 4 Autostart deCONZ GUI on boot 11 6 1 5 Autostart deCONZ headless on boot 12 6 2 Notes on custom firmware 12 6 3 GCFFlasher 12 6 3 1 Installation 12 6...

Page 3: ... Dimensions 18 9 2 Housing 18 10 Pin assignment 19 11 Hardware modifications 20 11 1 Assemble the service header 21 11 2 Using an external antenna 21 12 Radio certification 22 12 1 United States FCC 22 12 2 European Union ETSI 22 12 3 Approved antenna list 23 13 Ordering information 23 14 Packaging dimension 24 15 Revision notes 24 References 25 ...

Page 4: ...ded 2016 04 04 1 2 Including support of RPi2 and RPi3 RaspBee basic is obsolete 2016 04 04 1 3 Update Raspbian Jessie UART configuration 2017 04 25 1 4 Adjust installation of the deCONZ software 2017 07 20 1 5 Add installation firmware by using GCFFlasher 2017 12 10 1 6 Update deCONZ installation for Raspbian Jessi and Stretch Update preconfigured SD card image from Raspbian Jessi to Stretch Docum...

Page 5: ...ging of embedded devices also known as IEEE 1149 1 standard interface MAC Medium Media Access Control MCU µC Microcontroller Unit OS Operating System RF Radio Frequency RPi Raspberry Pi a famous inexpensive single board computer in credit card size R TTE Radio and Telecommunications Terminal Equipment Directive of the European Union U S ART Universal Synchronous Asynchronous Receiver Transmitter Z...

Page 6: ...are is interfaced by a program called deCONZ which runs on the RPi and is responsible for ZigBee network control and monitoring Basically the RaspBee is a reference design for the ZigBee radio module deRFmega256 23M12 by dresden elektronik 2 Applications Mainly the RaspBee is designed to handle ZigBee 3 0 ZigBee Light Link ZLL and ZigBee Home Automation ZHA applications in connection with the Rasp...

Page 7: ... 3 3 V voltage to supply the radio module and LEDs Note All RaspBee signals UART RESET GPIO JTAG work on a 3 3 V domain A level shifting of the signals to other voltage domains may be required if the RaspBee is used on other base boards than the RPi The onboard placed radio module deRFmega256 23M12 by dresden elektronik contains an 8 bit AVR microcontroller with an integrated low power 2 4 GHz tra...

Page 8: ...TAG signals of the built in microcontroller are available In delivery state the adapter header is not assembled See Section 11 1 for a custom modification The 2 4 GHz radio module has two RF output traces In default delivery state only one RF line is used which is routed to the assembled onboard chip antenna Each firmware shall ensure that the correct RF port gets selected Although the chip antenn...

Page 9: ... V DC min 2 A SD card MicroSD card for OS and software 4 2 2 Software Linux operating system Raspbian Jessie or Stretch1 deCONZ for ARMv6 Linux2 ZigBee firmware for RaspBee3 optionally 4 3 Setup the components 1 Unpack the RaspBee unit 2 Please make sure that the Pi is switched off 3 Connect the RaspBee to the RPi user header Pin 1 of RaspBee square marker must be connected to Pin 2 of RPi header ...

Page 10: ... de funktechnik solutions wireless light control raspbee gw sd card image L 1 Otherwise please follow the installation instructions of the chapter 5 1 1 Power On the RPi and wait until the main screen is available 2 The deCONZ application starts automatically 5 1 Install and start the application without preconfigured image 3 Power On the RPi and wait until the login prompt is available 4 Log in a...

Page 11: ...nfig tool sudo raspi config 2 Select Interfacing Options 3 Select Serial 4 Would you like a login shell to be accessible over serial No 5 Would you like the serial port hardware to be enabled Yes 6 Exit config tool and reboot RPi 6 1 3 Start and run the application 1 If not already running start the desktop environment startx 2 Start deCONZ application from start menu Menu Programming deCONZ The a...

Page 12: ...or which can be used to update the RaspBee firmware without additional programming hardware It is also used by deCONZ if the ZigBee firmware needs to be updated GCFFlasher accepts firmware files in binary file format and in dresden elektronik proprietary GCF file format There is no EEPROM programming support within GCFFlasher EEPROM programming must be done within your application code Please note...

Page 13: ...with superuser rights as follows sudo GCFFlasher f filename bin GCF 6 4 EEPROM layout The radio module contained on the RaspBee uses the following EEPROM sections If developing custom firmware please do not modify the sections already used Table 1 EEPROM sections EEPROM sections address range content remark 0x0000 0x00FF Bootloader specific 0x0100 0x1EFF user available 0x1F00 0x1FDF ZigBee firmwar...

Page 14: ...ble 3 Table 3 LED status LED status Application Application state LED1 red LED2 green Bootloader during initial 200 ms after start awaiting commands Off Blinking firmware update Off Blinking no target application invalid Firmware empty FLASH Off Blinking target application started depending application ZigBee firmware Idle mode TRX OFF Fast blinking Off Connecting Slow blinking Off Connected On Of...

Page 15: ...atings Value Descriptor Parameter Min Typ Max Unit Supply voltage Vin_max T 25 C 5 5 V Supply current Iin_max TX_ON TX_PWR 0x0 215 mA Note Stresses beyond those listed under Absolute maximum ratings may cause permanent damage to the device This is a stress rating only and functional operation of the device at these or any other conditions beyond those indicated in the operational sections of this ...

Page 16: ...TX_PWR 0x0 Vin 5 0 V TX_PWR 0x6 Vin 5 0 V TX_PWR 0xF 213 7 168 2 55 1 mA mA mA Iin_rxon Vin 5 0 V Max Sens Vin 5 0 V Reduced Sens Vin 5 0 V RPC On 32 0 31 7 26 6 mA mA mA Table 8 MCU clock MCU clock Value Descriptor Parameter Min Typ Max Unit MCU clock CLKMCU 8 MHz Table 9 Radio characteristics Radio characteristics Value Descriptor Parameter Min Typ Max Unit Antenna ANT1 Type Chip Ceramic Gain 0 ...

Page 17: ..._PWR 0x0 Vin 5 0 V TX_PWR 0x6 Vin 5 0 V TX_PWR 0xF 20 9 19 6 3 0 dBm dBm dBm Receiver sensitivity SENS Data Rate 250 kBit s Data Rate 500 kBit s Data Rate 1000 kBit s Data Rate 2000 kBit s 105 101 99 94 dBm dBm dBm dBm Data rate gross DR TRX_CTRL_2 0x00 TRX_CTRL_2 0x01 TRX_CTRL_2 0x02 TRX_CTRL_2 0x03 250 500 1000 2000 kbps kbps kbps kbps ...

Page 18: ...ht of 12 0 mm including socket for RPi Figure 4 Mechanical size 9 2 Housing The slim board size allows the usage of housing for the RPi Tested and recommended items are MULTICOMP MC RP001 white FARNELL order code 2113797 MULTICOMP MC RP001 black FARNELL order code 2113798 MULTICOMP MC RP001 clear FARNELL order code 2113799 Recommended housing for RPi2 and RPi3 is RS Pro ASM 1900036 11 RS Online or...

Page 19: ...ET Reset 10k pull up onboard low active 27 PB7 SW1 GPIO 15 PD7 LED1 Red low active 8 PG2 LED2 Green low active 57 RFOUT1 Wire antenna or coaxial connector Not assembled trace terminated with 49R9 resistor 53 RFOUT2 Chip antenna 48 PF4 TCK JTAG Header not assembled 47 PF5 TMS JTAG Header not assembled 46 PF6 TDO JTAG Header not assembled 45 PF7 TDI JTAG Header not assembled Vin Voltage supply 5 V s...

Page 20: ...or RaspBee 12 RESET Reset signal for RaspBee Service socket not assembled 1 TCK JTAG 2 GND 3 TDO JTAG 4 VCC 3 3 V generated internally 5 TMS JTAG 6 RESET Reset signal for RaspBee 7 VCC 3 3 V generated internally 8 NC 9 TDI JTAG 10 GND 11 Hardware modifications Besides the factory default RaspBee configuration it is also possible to modify the hardware to enhance its functionality ...

Page 21: ...ication of the pre allocated EEPROM memory sections or removal of the pre installed bootloader will irreversibly preclude restoring booting or upgrading the shipping firmware at all dresden elektronik will neither support such modifications see Section 6 2 for details 11 2 Using an external antenna External antennas will be often used if an improved radio characteristics performance is needed or t...

Page 22: ...es These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the instruction manual may cause harmful interference to radio communications Operation of this equipment in a residential area is l...

Page 23: ...upplier External antenna 2400 to 2483 5 MHz Rubber antenna 5dBi peak RP SMA 17013 RSMA WiMo U FL to RP SMA pigtail 15 cm 0 5dB BN 023769 dresden elektronik Integrated antenna 2400 to 2483 5 MHz Chip antenna 1 3dBi peak SMT 2450AT43B100 Johanson Technology According to KDB 178919 it is allowed to substitute approved antennas through equivalent antennas of the same type Equivalent antennas must be o...

Page 24: ...12 10 RaspBee ZigBee addon board www dresden elektronik de Page 24 of 27 14 Packaging dimension Default package size 138 x 90 x 29 mm LxWxH One package contains one RaspBee unit 15 Revision notes Actually no design issues are known ...

Page 25: ...URL https www dresden elek ek tronik de funktechnik service download documentation L 1 eID dam_frontend_push docID 4621 4 User Manual deRFmega256 radio modules URL http www dresden elektronik de funktechnik service downloads documentation eID dam_frontend_push docID 1250 5 Software Programming User Manual URL http www dresden elektronik de funktechnik products radio modules oem derfmega descriptio...

Page 26: ...roducts are trademarks or registered trademarks of their respective holders and should be noted as such Disclaimer This note is provided as is and is subject to change without notice Except to the extent prohibited by law dresden elektronik ingenieurtechnik gmbh makes no express or implied warranty of any kind with regard to this guide and specifically disclaims the implied warranties and conditio...

Page 27: ... ZigBee addon board www dresden elektronik de Page 27 of 27 than the purchaser s personal use without the written permission of dresden elektronik ingenieurtechnik gmbh Copyright 2017 dresden elektronik ingenieurtechnik gmbh All rights reserved ...

Reviews: