dresden elektronik RaspBee User manual

UserManual
RaspBeeTM
Document Version V1.4
2017-04-25
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 2of 22
Tableofcontents
1. Overview.........................................................................................................................6
2. Applications.....................................................................................................................6
3. Features..........................................................................................................................6
3.1. Short facts..............................................................................................................6
3.2. Howdoes the RaspBee work?...............................................................................7
4. Quickstart.......................................................................................................................8
4.1. Content ofdelivery.................................................................................................8
4.2. Requirements.........................................................................................................8
4.2.1. Hardware....................................................................................................9
4.2.2. Software.....................................................................................................9
4.3. Setup the componentsand starttheapplication.....................................................9
5. Software........................................................................................................................10
5.1. deCONZon RPideCONZ.....................................................................................10
5.1.1. Installation................................................................................................10
5.1.2. Startandruntheapplication.....................................................................10
5.1.3. Executethe applicationat start-up............................................................10
5.2. Notes oncustom firmware....................................................................................11
5.3. EEPROMlayout...................................................................................................11
5.4. Fuse setting.........................................................................................................11
6. LED user interface.........................................................................................................11
7. Technicaldata...............................................................................................................13
8. Mechanicalsize.............................................................................................................15
8.1. Dimensions..........................................................................................................15
8.2. Housing................................................................................................................15
9. Pinassignment..............................................................................................................16
10. Hardwaremodifications.................................................................................................17
10.1.Assemblethe service header...............................................................................17
10.2.Usinganexternalantenna....................................................................................18
11. Radiocertification..........................................................................................................18
11.1.United States(FCC).............................................................................................18
11.2.European Union (ETSI)........................................................................................18
11.3.Approved antenna list...........................................................................................19
12. Ordering information......................................................................................................20
13. Packagingdimension....................................................................................................20
14. Revision notes...............................................................................................................20
15. Related Products...........................................................................................................20
15.1.Wireless electronicballasts..................................................................................20
15.2.RaspBee Gateway ...............................................................................................20
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 3of 22
15.3.Starter KitWireless LightControl..........................................................................20
16. References....................................................................................................................21
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 4of 22
Documenthistory
Date Version Description
2013-07-221.0 Initialversion
2013-09-091.1 Updateofradiocerti
fication sectiondue tosuccessfulpassed
certification
Availabilityof basicvariant included
2016-04-041.2 Including support of RPi2and RPi3
RaspBee basicisobsolete
2016-04-041.3 UpdateRaspbian JessieUARTconfiguration
2017-04-251.4 Adjustinstallation ofthe deCONZsoftware
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 5of 22
Abbreviations
Abbreviation Description
IEEE 802.15.4Communication standard,applicabletolow-
rateWireless PersonalArea
Networks(WPAN)
CE ConsumerElectronics
ETSI European Telecommunications StandardsInstitute
FCC FederalCommunicationsCommission
GPIO GeneralsPurposeInputOutput
JTAG JointTest Action Group,digitalinterfacefor debuggingof embedded
devices, also knownas IEEE 1149.1standardinterface
MAC Medium (Media) Access Control
MCU, µC Microcontroller Unit
OS Operating System
RF RadioFrequency
RPi
RaspberryPi,afamousinexpensivesingleboardcomputerincreditcard
size
R&TTE Radioand Telecommunications TerminalEquipment
(DirectiveoftheEuropeanUnion)
U[S]ART Universal[Synchronous/]Asynchronous Receiver Transmitter
ZHA ZigBee Home-Automation profile
ZigBee Low-cost, low-
powerwireless mesh networkstandard.The ZigBee Alliance
isagroupof companies thatmaintainand publishtheZigBeestandard.
ZHA ZigBee HomeAutomation profile
ZLL ZigBee LightLinkprofile
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 6of 22
1.Overview
The RaspBee™ isaZigBee addon boardfortheRaspberryPi (RPi). Byusingthe RaspBee
the RaspberryPi becomes afull functionalwireless node which can be seamlesslyintegrated
intoZigBeenetworks.Thiswill enhance the application rangeofRPi withmonitoring and
controlling ZigBeenetworks.ZigBeecompatibledevices areavailablefromalotof
manufacturers.
The RaspBee addon boardhas been designed tointerconnectwiththe RPi standarduser
header.Due toitsslimsizethe RPi still fitsintomost housingsavailableonthemarket.
The addon boardcontains apowerfulradiomodulewithintegrated poweramplifierand low
noise amplifier. Togetherwiththe assembled onboardchipantenna which hasbeen
optimallytuned thisensures asuperior RFperformance.
The RaspBee board“premium” isshipped withapre-flashed ZigBee firmware.Indelivery
condition it includes abootloaderforsimplefirmwareupdates.
The ZigBee firmwareisinterfaced byasoftwarecalled deCONZwhich runs on the RPiand
isresponsibleforZigBeenetworkcontrolandmonitoring.
Basically,the RaspBee isareference designforthe ZigBee radiomoduledeRFmega256-
23M12 bydresden elektronik.
2.Applications
Mainlythe RaspBee isdesigned tohandleZigBee3.0,ZigBee LightLink (ZLL)and ZigBee
HomeAutomation (ZHA)applications inconnection withthe RaspBee ZigBee firmwareand
RPi softwaredeCONZ.Amoredetailed description ofthe ZLL standard,the features,
benefitsandavailablecertified productscanbefound on the officialalliance website [1].
It isalso possibletouseacustomfirmwareforwireless applications.Followthe instructions
in Sections5 and 10 fordetailed instructions on softwareinstallation and customer
modifications.
Note: Regardthatdependenton the modifications theradiocertification and compliance
maybecomeinvalid.Please getincontactwithus toadvise you foracustomFCC
certifiedand/or compliant design.
3.Features
The RaspBee boardcontains the features listed below. Figure1 illustrates the featureparts
inadetailed view.
3.1.Shortfacts
•Slim size: 48.0x16.5x12.0mm
•Supplyvoltage:5.0V
•Onboard2.4GHzZigBeeradiomodule‘deRFmega256-23M12’
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 7of 22
•Application interfaces:
o1xUART, 1xReset, 1xGPIO
oUser interface: 2xLED (red and green)
Figure 1:RaspBee indetail
3.2.HowdoestheRaspBee work?
ThefunctionalpartsoftheRaspBee areshowninaschematicoverviewin Figure2.
The RaspBeewillbe supplied bythe RPi 5.0Vdomain.Thereforethe AC/DC supplymust be
sufficienttosupporttheadditionalload.The mostusedAC/DC convertersforRPi supply
enoughpowertocompensatethe slightlyincreased currentconsumption ofthe RaspBee.An
onboardlow-drop-outvoltageregulatorgeneratesastable3.3Vvoltagetosupplythe radio
moduleand LEDs.
Note: All RaspBeesignals(UART,RESET,GPIO,JTAG) workon a3.3Vdomain.Alevel
shiftingofthe signalstoothervoltagedomains maybe required ifthe RaspBee is
used on otherbaseboards thantheRPi.
The onboardplaced radiomoduledeRFmega256-23M12 bydresden elektronikcontains an
8-bitAVR microcontrollerwithan integrated low-power2.4GHztransceiverforZigBee and
IEEE 802.15.4applications.The firmwareisstored intheMCU internalflashand starts
automaticallyaftertheboardgetspowered on.Each RaspBee contains aworld-wide unique
identifier,named MAC-ID.Itconsistsofan8byteaddress,includingthe vendorIDand
productID.TheMAC-IDisstored inthe MCU internalEEPROM.
Communication between RPi and RaspBee isrealized viaUARTinterface.Theused signals
areTXDand RXDwithoutanyhandshakesignals.Itisimportanttoenablethe access to
RPi’sserialport (see Section Fehler!Verweisquellekonntenichtgefunden werden.) to
ensurethe properfunction.TwouserLEDs(red,green)areavailabletoshowRaspBee’s
status.The low-activeresetsignalcan be controlled bythe RPi and will cause ahardware
Radiomodule
Service interface
(optional, n.a.)
LED2
LED1
LDO
RPi
socket
U.FL(n.a.)
Wireantenna (n.a.)
Chipantenna
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 8of 22
resetofthe built-inmicrocontroller.Anonboard10kpull-up resistoravoids an unintended
resettrigger.
Viaaservice adapterfootprintthe JTAGsignalsofthe built-inmicrocontrollerareavailable.
Indeliverystatethe adapterheaderisnotassembled.See Section 10.1 foracustom
modification.
The 2.4GHzradiomodulehas twoRFoutputtraces.Indefaultdeliverystate,onlyone RF
line isused which isrouted tothe assembled onboardchipantenna.Each firmwareshall
ensurethatthe correctRFport getsselected.Althoughthe chipantennacoversmostofthe
applications it isalso possibletouse an externalantenna.Thisrequirescustommodifications
described in Section10.2 as well as firmwarechanges.
deRFmega256-23M12
JTAG
UART
VCC
4.5V to5.5V
Reset
RFout1
RFout2
LDO Vout
3.3V
LED1 LED2
Chip-Ant.
Coax-Conn.
GPIO
GPIO GPIO
Figure 2:Block Diagram
4.Quick start
Thissection describes inshort steps afaststart-upofthe RaspBee boardtocontroland
monitoraZigBee network.Detailed descriptions aboutthe firmware,softwareand
functionalitycan befoundin Section 5.
4.1.Contentofdelivery
One shippedRaspBee packagecontains the following:
•1xRaspBee board
•1xInstruction leaflet
TheRaspbee addonboardmayalso be obtained as part of akit (see Section 15.3).
4.2.Requirements
The RaspBee isdesignedtoworkon aRaspberryPi.Ingeneralall actualavailabletypes of
RPi willworkwiththe RaspBee.HoweverwerecommendRPi type B,RPi2and RPi3with
assembled Ethernetcomponents.Forfull functionalitythe followingadditionalcomponents
arerequired:
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 9of 22
4.2.1.Hardware
•RaspberryPi (type B), RPi2or RPi3
•RecommendedPower supplyforRaspberryPi,RPi2or RPi3
(AC/DC toMicro-USB, 5.0VDC, min.2A)
•SD card/ MicroSD cardforOSandsoftware
4.2.2.Software
•Linuxoperating system(Raspbian Linuxdistribution1)
•deCONZfor ARMv6Linux2
•ZigBee firmwareforRaspBee3(optionally)
4.3.Setup thecomponentsand starttheapplication
1.Unpack theRaspBee unit.
2.Please make surethatthe Pi isswitched off.
3.ConnecttheRaspBee tothe RPi’suserheader.Pin1ofRaspBee (squaremarker)must
be connected toPin2ofRPi header P1at the boardedge. Use the sameheader position
forRPi2or RPi3.
Figure 3:RPi userheader
Notes: Doublecheck thatthe headeris NOT shifted inadvertentlysince thismay
damagethe RaspBeeboardirreversible.
DonotconnecttheRaspBee ifthe RPi ispowered since thiswill cause a
restartof thehost device.
4.Power-OntheRPi and wait until the loginprompt isavailable.
5.Log inand acquiresuperuserrights.
1Referto http://www.raspbian.org/ fordownload and installation instructions
2deCONZisavailableinthedownload area on http://www.dresden-elektronik.de
3ZigBee firmwareisavailable inthedownload area on http://www.dresden-elektronik.de. (section
deCONZ, file extension .bin.GCF).
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 10 of22
6.Install the ZigBee controland monitoringsoftware‘deCONZ’on RPi (see Section5.1.1).
7.StartthedeCONZapplication (see Section 5.1.2).
5.Software
All followingexplanationsassumethecustomerfulfilsthe softwareprerequisites as given in
Section 4.2.2 andtheinitialsetup(see Section 4.3)has beenperformed.
Note:You can also download apreconfigured ImagewithJessieOS,deCONZand VNC-
Server.
https://www.dresden-elektronik.de/funktechnik/solutions/wireless-light-control/raspbee-gw-sd-card-
image/?L=1
5.1.deCONZon RPi
deCONZisapowerfulsoftwarewhich allowsforconfiguration,operation,monitoringand
maintenanceof ZigBeenetworks.
5.1.1.Installation
1.Download deCONZsoftwarepackage:
$ wget http://www.dresden-elektronik.de/rpi/deconz/deconz-
latest.deb
2.Install deCONZsoftwarepackage:
$ sudo dpkg -i deconz-latest.deb
5.1.2.Startand run theapplication
1.If notalreadyrunningstartthedesktop environment
$ startx
2.Starttheapplication fromstartmenu
Menu àProgramming àdeCONZ
The application shall nowconnecttothe RaspBee shieldautomaticallyand ablue node with
address 0x0000 whichrepresentsthe RaspBee coordinatorappears.Fordetailson the
operation,refertothedeCONZusermanual [2]. Once running,deCONZisalso accessible
viaaWebapplication [3].
5.1.3.Executetheapplication atstart-up
1. Createthe folder“autostart”:
$ mkdir -p /home/pi/.config/autostart/
2. Createandedit thefile“deCONZ.desktop”:
$ nano /home/pi/.config/autostart/deCONZ.desktop
2. Insertthe followinglines and savethefile:
[Desktop Entry]
Type=Application
Name=deCONZ
Exec=deCONZ-autostart.sh
StartupNotify=false
Now, the application will run automaticallyafterstart-up ofthe RPi.
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 11 of22
5.2.Notes on custom firmware
Forcommunication between RPiand Raspberry,settheUARTspeed to38400 baud
preferably. Toupload thefirmwareorrecovertheZigBee firmware,use GCFFlasher4.
Notes: WhenusingtheJTAGinterfaceanyhow,do nottouch sensitiveEEPROM
areas (Bootloadercontrolsection,ZigBee firmwaresettings,NV-section
containingi.e.MAC address)unless you areabsolutelysurewhatyouare
doing.
Please also notethatdresden elektronikwill neitherprovide firmwareimages
ofthebootloadernorsupport restoringthebootloaderorEEPROMonce
overwritten.
5.3.EEPROMlayout
The radiomodulecontained on the RaspBee uses the followingEEPROMsections.If
developingcustomfirmware,please donotmodifythe sections alreadyused.
Table 1:EEPROMsections
EEPROM sections
address range content/remark
0x0000 ... 0x00FF Bootloader specific
0x0100 ... 0x1EFF user available
0x1F00 ... 0x1FDF ZigBee firmwarespecific
0x1FE0 ... 0x1FFF NV-section
5.4.Fuse setting
The tablebelowshowsthe recommended fusebytesettings forthe RaspBee which the
boardalso comes withinfactorynewcondition.Please refertotheradiomoduleuser
manual [4] for their description and alternativeconfigurations.
Table 2:Extendedfuse bytes
Fuse bytes Setting Description
EXTENDED 0xF8 Extended fuse byte
HIGH 0x90 Fuse highbyte
LOW 0xCE Fuse lowbyte
6.LEDuserinterface
The LED userinterface consistsofared and agreen low-activelow-currentLED. Theyshow
the actualstatusofthe RaspBee board(Table3).
Table 3:LED status
LEDstatus
Application Application state LED1(red) LED2(green)
4Imagesofthe ZigBeeFirmwareareavailableinthe download area on http://www.dresden-
elektronik.de
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 12 of22
Bootloaderduring initial200 msafter start
(awaitingcommands) Off Blinking
firmwareupdate Off Blinking
no targetapplication (invalid
Firmware/emptyFLASH) Off Blinking
target application started dependingapplication
ZigBee firmware Idlemode(TRXOFF) Fast blinking Off
Connecting Slowblinking Off
Connected On Off
Transmit Off On
Transmitted Off Off
customfirmware n/a dependingapplication
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 13 of22
7.Technical data
The RaspBee contains the 2.4GHzIEEE 802.15.4radiomodule‘deRFmega256-23M12’by
dresden elektronik.Adetailed description ofthe module’scharacteristicsand properties can
be foundintheradiomoduleusermanual [4].
Table 4:Mechanical data
Mechanical data
Value Descriptor Parameter Min Typ Max Unit
Size L 48.0 mm
W 16.5 mm
H 12.0 mm
Table 5:Temperaturerange
Temperaturerange5
Value Descriptor Parameter Min Typ Max Unit
Working
temperature Twork -40+25 +85 °C
Table 6:Absolute maximum ratings
Absolutemaximumratings
Value Descriptor Parameter Min Typ Max Unit
Supplyvoltage V
in_max
T=25°C 5.5 V
Supplycurrent I
in_max
TX_ON,TX_PWR=0x0 215 mA
Note: Stresses beyond those listed under“Absolutemaximumratings”maycause
permanentdamagetothe device.Thisisastress ratingonlyand functional
operation ofthe device atthese oranyotherconditions beyond those
indicated inthe operationalsections ofthismanualarenotimplied.Exposure
toabsolutemaximumratingconditions forextended periods mayaffectdevice
reliability.Formoredetailsaboutthese parameters,refertoindividual
datasheetsofthe componentsused.
5The givenvaluesareonlyvalidforthe RaspBee board. Theymaydifferfromthe RaspberryPior
othercustombaseboards.Check the appropriatedocumentationsforthe working and storage
temperature ofthe whole system.
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 14 of22
Table 7:Electrical characteristics
Electricalcharacteristics
Value Descriptor Parameter Min Typ Max Unit
Supplyvoltage V
in
4.5 5.0 5.5V
Output voltage V
out
3.3 V
Supplycurrent I
in_trxoff
V
in
=5.0V 15.8 mA
Iin_txon Vin=5.0V, TX_PWR=0x0
Vin=5.0V, TX_PWR=0x6
V
in
=5.0V, TX_PWR=0xF
213.7
168.2
55.1
mA
mA
mA
Iin_rxon Vin=5.0V,Max. Sens.
Vin=5.0V,Reduced Sens.
V
in
=5.0V,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 CLK
MCU
8 MHz
Table 9:Radiocharacteristics
Radiocharacteristics
Value Descriptor Parameter Min Typ Max Unit
Antenna ANT1 Type ChipCeramic
Gain -0.7 dBi
CoaxialconnectorCOAX Type U.FL
Frequencyrange F
range
PHY_CC_CCA = 0x0B..0x1A 2405 2480 MHz
Channels CH PHY_CC_CCA = 0x0B..0x1A 16
AbsoluteTXpower POUT Vin=5.0V, TX_PWR=0x0
Vin=5.0V, TX_PWR=0x6
Vin=5.0V, TX_PWR=0xF
20.9
19.6
3.0
dBm
dBm
dBm
Receiver sensitivity SENS DataRate=250 kBit/s
DataRate=500 kBit/s
DataRate=1000 kBit/s
DataRate=2000 kBit/s
-105
-101
-99
-94
dBm
dBm
dBm
dBm
Datarate(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
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 15 of22
8.Mechanical size
8.1.Dimensions
The RaspBee board(Figure4)has alengthof48.0mm, awidthof16.5mmand aheightof
12.0mm(includingsocketforRPi).
Figure 4:Mechanicalsize
8.2.Housing
The slim boardsizeallowsthe usageof housing forthe RPi.Tested andrecommended items
are:
•MULTICOMP- MC-RP001 white(FARNELL order code2113797)
•MULTICOMP- MC-RP001 black(FARNELL order code2113798)
•MULTICOMP- MC-RP001 clear(FARNELL order code2113799)
Recommendedhousingfor RPi2and RPi3is:
•RS Pro- ASM-1900036-11 (RS-Online order code908-4212)
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 16 of22
9.Pinassignment
Thissection listsall availablesignalsandtheirfunction on theRaspBee.
Note: ThesignalNC meansNot Connected.
Table 10:Signalpindescription
Signal pindescription
Radiomodulepin Signal Function Comment
28 PE0/RXD0 UARTRX Communicationinterface
29 PE1/TXD0 UARTTX Communicationinterface
4 RESET 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 Wireantenna or
coaxialconnector
Notassembled,trace terminated
with49R9resistor
53 RFOUT2 Chipantenna
48 PF4/TCK JTAG Header notassembled
47 PF5/TMS JTAG Header notassembled
46 PF6/TDO JTAG Header notassembled
45 PF7/TDI JTAG Header notassembled
- Vin Voltagesupply 5Vsupplied byRPi
2, 50 VCC Voltagesupply 3.3Vgenerated internally
1, 31, 44, 49, 51 GND Ground Systemground
Table 11:Headerpindescription
Headerpindescription
Header Pin Signal Comment
RPi socket 1 Vin 5.0Vsupplied byRPi
2 NC
3 NC
4 NC
5 GND
6 NC
7 RXD UARTRX
8 NC
9 TXD UARTTX
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 17 of22
10 GND
11 SW1 GPIOforRaspBee
12 RESET Reset signal forRaspBee
Service socket
(notassembled) 1 TCK JTAG
2 GND
3 TDO JTAG
4 VCC 3.3Vgenerated internally
5 TMS JTAG
6 RESET Reset signal forRaspBee
7 VCC 3.3Vgenerated internally
8 NC
9 TDI JTAG
10 GND
10.Hardwaremodifications
Besides the factory-defaultRaspBee configuration itisalso possibletomodifythe hardware
toenhanceitsfunctionality.
10.1.Assembletheservice header
The service interface provides the microcontrollerprogramminginterface ofthe radio
module.Itisusefultoassemblea50 mil 10-pinheaderon the top side toensureaproper
connection.Werecommend theuse ofthelisted header:
•MOUSER ELECTRONICS ordernumber: 855-M50-3500542
•FARNELL order number:1022305
•DIGI-KEY ordernumber:952-1383-ND
Figure 5:RaspBee service header(defaultnot assembled)
The pindescription can be found in Section 9 in Table11.Adetailed description ofsuitable
programmersandrelatedsoftwaretoolsarelistedin [5].
Note: Improperhandlinginrespectoferasing oroverwriting theMCU internalflash
orEEPROMcompletelyorinpartsmayresultinan unusableRaspBee unit.
Modification ofthe pre-allocated EEPROMmemorysections orremovalofthe
pre-installed bootloaderwillirreversiblypreclude restoring,bootingor
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 18 of22
upgradingthe shippingfirmwareatall.dresden elektronikwillneithersupport
such modifications (see Section 5.2 for details).
10.2.Using anexternalantenna
Externalantennas willbe often used ifan improved radiocharacteristics performance is
needed or the device isput intoametallized enclosure.Inthiscase it ispossibletoassemble
asurface-mountcoaxialconnector. The footprintisdesigned touse the coaxialconnector
‘U.FL-R-SMT-1(10)’byHIROSE.Itcan beobtainedfromi.e.the followingdistributors:
•MOUSER ELECTRONICS ordernumber: 798-U.FL-R-SMT-110
•FARNELL order number:1688077
•DIGI-KEY ordernumber:H11891CT-ND
Additionallythe terminatingresistormustbe removed fromthe antennaport.Assemblea
22 pFcouplingcapacitorand a10 kresistorinparalleldirectlynext totheU.FLconnector.
The RaspBee has beentested and measuredwiththe approved antenna(s)listed in
Section 11.3.
Notes: The use ofantenna types otherthan the listed approved antennas willcause
inloss ofthe FCC certification.Regardthe notes in Section 11.3 toworkwith
acustomantennainrespect of CEand FCC requirements.
Thepre-installed ZigBeefirmwaredoes notsupportthe2nd antenna port.
11.Radiocertification
11.1.UnitedStates (FCC)
The RaspBee contains the radiomodule‘deRFmega256-23M12’,which iscertified according
toFCC part 15.The FCC-IDofthe radiomoduledeRFmega256-23M12 is
XVV-MEGA23M12and isprinted on avisiblepermanentlyaffixed labelon the top ofthe
module’sRFshielding.
Thisequipmentcomplies withPart 15 of the FCC Rules.Operation issubjecttothe following
twoconditions:(1)thisdevice maynotcause harmfulinterference,and(2)thisdevice must
acceptanyinterference received,includinginterference thatmaycause undesired operation
(FCC 15.19).The internal/externalantenna(s)used forthismobiletransmittermustprovide
aseparation distance ofatleast20 cmfromall persons and mustnotbe co-locatedor
operatinginconjunction withanyotherantennaortransmitter.
Modifications notexpresslyapproved bythe manufacturercouldvoidthe user'sauthorityto
operatethisequipment(FCC section 15.21).
Thisequipmenthas beentested and found tocomplywiththe limitsforaClass Adigital
device,pursuanttoPart 15 ofthe FCC Rules.These limitsaredesigned toprovide
reasonableprotection againstharmfulinterference when the equipmentisoperatedina
commercialenvironment.Thisequipmentgenerates,uses,and can radiateradiofrequency
energyand,ifnotinstalled and used inaccordance withthe instruction manual,maycause
harmfulinterference toradiocommunications.Operation ofthisequipmentinaresidential
area islikelytocause harmfulinterference inwhich case the userwillberequired tocorrect
the interferenceattheirownexpense (FCC section 15.105).
11.2.EuropeanUnion (ETSI)
TheRaspBee isconform for useinEuropeanUnion countries.
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 19 of22
Ifthe RaspBee isincorporated intoaproduct,themanufacturermustensurecompliance of
the finalproducttotheEuropean harmonized EMCand low-voltage/safetystandards.A
Declaration ofConformitymustbeissued foreach ofthesestandardsand kepton fileas
described inAnnexII ofthe R&TTEDirective.
The manufacturermustmaintainacopyofthe RaspBee documentation and ensurethe final
productdoes notexceed the specified powerratings,antenna specifications,and/or
installation requirementsas specified inthe usermanual.Ifanyofthesespecifications are
exceeded inthe finalproduct, asubmission mustbe made toanotified bodyforcompliance
testingtoall requiredstandards.
The CEmarking mustbeaffixed toavisiblelocation on theOEMproduct.The CEmarkshall
consist ofthe initials"CE"taking thefollowingform:
•If theCE markingisreduced orenlarged, the proportions must berespected.
•The CE markingmust haveaheight ofat least 5mm except wherethisisnot possibleon
account ofthenatureofthe apparatus.
•TheCE markingmust beaffixed visibly, legibly, and indelibly.
Moredetailed informationaboutCE markingrequirementscanbe found in [6].
11.3.Approvedantennalist
The RaspBee has an integrated chipantenna.The designisfullycompliantwithall
regulations and certifiedas reference designofthe radiomoduledeRFmega256-23M12
(FCC-ID: XVV-MEGA23M12).
Asapproved antenna(s)inconnectionwiththe coaxialconnector(see Section 10.2)anda
suitableU.FLtoRP-SMAadaptercable,thefollowingantenna(s) areallowed touse:
Table 11-1:Approvedantenna(s)
Approvedantenna(s)fordeRFmega256-23M12
Type Gain Mount Order code Vendor /Supplier
Externalantenna
2400 to2483.5MHz
Rubber antenna +5dBi (peak) RP-
SMA 17013.RSMA WiMo
U.FL-to-RP-SMA
pigtail, 15 cm -0.5dB BN-023769 dresden elektronik
Integratedantenna
2400 to2483.5MHz
Chipantenna +1.3dBi (peak)SMT 2450AT43B100
Johanson Technology
AccordingtoKDB 178919 itisallowed tosubstituteapproved antennas throughequivalent
antennas ofthe sametype:
‘Equivalentantennas mustbe ofthe sametype(e.g.,yagi,dish,etc.),mustbe of
equalorless gainthan an antenna previouslyauthorized underthe sameFCC ID,
and musthave similarinband and out-of-band characteristics (consultspecification
sheetforcutofffrequencies).’
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de

User Manual
Version 1.4
2017-04-25
RaspBeeZigBee addonboard
www.dresden-elektronik.de Page 20 of22
Additionaldescription tocertification and approved antenna issuescanbefound inthe radio
module’susermanual [4].
12.Ordering information
Table 2:Ordering Information
Ordering information
Part Number ProductName Comment
BN-600052 RaspBee premiumContains bootloaderandZigBeefirmware
13.Packaging dimension
Default packagesize: 138x90 x29 mm(LxWxH).
One packagecontains one RaspBee unit.
14.Revision notes
Actuallyno designissuesareknown.
15.RelatedProducts
15.1.Wirelesselectronicballasts
Withthe easytointegrateZLL compliantwireless electronicballastsbydresden elektronika
greatnumberoflamps fromthe classiclightbulbtotheadvanced multicolored LED matrix
can be wirelesslycontrolled.Thereisachoice offourvariations thatareapplied alternatively
orincombination withconventionalelectronicballasts.Theycomealongwithstandard
interfacessuchas 0/1-10Vtechnologyand PWMas well as wireless dimmersfordimmable
energysavingbulbs.
15.2.RaspBee Gateway
The gatewayisapre-configured assemblywithhousingtogetstarted controllingyourlights
wirelessly.The gateway,as heart of ourwireless lightcontrolsystem, isacombination of the
single-boardcomputerRaspberryPi 3and theaddon moduleRaspBee.You can operate
withthisfull-fledged ZigBee device forexampleviasmartphone byconnectingitatyourWiFi
router.
15.3.StarterKitWirelessLightControl
The starterkitensures asimpleout-of-the boxoperation.It includes everythingneeded for
an easyactivation:afullypre-configured RaspBee Gatewayand twowireless electronic
ballastswithpower PWMoutput, i.e. for drivingLED stripes.
Formoreinformation about all related productsplease refertoourwebpage
www.dresden-elektronik.de
PDFwurde mit pdfFactoryPro-Prüfversion erstellt. www.context-gmbh.de