R22 GU. Owen Kirby. Copyright 2018, Exegin Technologies Limited

Transcription

1 R22 GU Owen Kirby Copyright 2018, Exegin Technologies Limited

2 ii

3 CONTENTS 1 Quick Start Guide 3 Connecting to the Beaglebone Inside the beaglebone Channel Configuration Running a Test Turing off the beaglebone Installation and Recovery 15 Kit Contents Beaglebone Green Q7x Beaglebone RF Cape Q7x Radio Modules Assembly Instructions Golden Unit Tools Installation Golden Unit Tools Update - Linux and OSX Golden Unit Tools Update - Windows iii

4 CONTENTS 1 Contents:

5 2 CONTENTS

6 CHAPTER ONE QUICK START GUIDE Assemble the hardware as shown, with the 2.4GHz antenna on the inboard RP-SMA connector and the longer 900MHz antenna on the outboard RP-SMA antenna, and then powering the beaglebone platforms with a powered USB hub. Most laptops can provide enough power for the Beaglebone platform, but sometimes the units may exceed the 500mA USB current rating, so a powered hub is advised. 3

7 4 CHAPTER 1. QUICK START GUIDE Connecting to the Beaglebone After powering up the Beaglebone, it will appear as a USB Ethernet device, hosting a DHCP server that will assign an internal IP address to your PC. Once powered up, you can connect to the IP address of the Beaglebone printed on a label on the side of connector P9 using SSH. The default username is debian and the default password is temppwd. Connecting with Linux or OSX On linux the SSH command would be: ssh debian@ x.2 You machine might prompt you to accept the RSA2 fingerprint of the beaglebone. Simply accept the key and you will be prompt to enter the password for the beaglebone. Connecting with Windows An installation of the Beaglebone drivers is first required and can be found: The link provides drivers for both 32 and 64-bit installers. It should be noted that the drivers on the adafruit website doesn t work with Windows 10 systems, but the drivers for it can be found: After installing the Beaglebone drivers we can then connect the Beaglebone to the PC and connect to the device using SSH. We recommend using PuTTY as the SSH client, which can be obtained from: After launching PuTTY the following screen will be shown:

8 CONNECTING TO THE BEAGLEBONE 5 Change the Host Name to match the IP address that s printed to the side of the beaglebone. Then on the left hand pane click on Connection->Data

9 6 CHAPTER 1. QUICK START GUIDE Enter debian in the Auto-login username field. Also make sure that Prompt is selected in the When username is not specified selection group. You can then go back to the Session window using the left hand pane and save the the configuration if desired. After configuring PuTTY, click the Open button and it will open an SSH session to the beaglebone. You might get a security alert screen like:

10 CONNECTING TO THE BEAGLEBONE 7 Just click Yes to add the RSA2 fingerprint of the beaglebone to your Windows machine. After adding the fingerprint, PuTTY will open a new window and you will see a prompt to enter the password for the beaglebone.

11 8 CHAPTER 1. QUICK START GUIDE Inside the beaglebone After connecting to the beaglebone, you should see the prompt display to indicate that you have successfully logged into the beaglebone. The current working directory should be /home/debian which will contain the following: Path Description start Start zbcli and begin writing to a new log file. restart Start zbcli while appending to an existing log file. scripts Directory of ZigBee test script files.

12 CHANNEL CONFIGURATION 9 Channel Configuration Modify the channels scripts to select the desired channel. The location of the script can be found in: File ~/scripts/r22/channels Description Channel configuration commands The contents of the file will look something like this: startup_channellist clear ### 2.4 GHz (Page 0, channels 11 to 26) startup_channellist 0 11 ### GB-868 (Pages 28 to 31) startup_channellist 28 0 ### VPAN (Page 16) startup_channellist 16 0 The two number after startup_channellist represents the page and channel respectively.

13 10 CHAPTER 1. QUICK START GUIDE Running a Test After configuring the desired channel range on which you will be testing, we can begin testing by invoking the zbcli tool and running the ZigBee test scripts. In the scripts/r22/ directory there are sub-directories for each test. Within each test sub-directory, there is a file with a tcnn-nn naming format that can be used as a reference to run the entire test (e.g. scripts/r22/tc11-02/tc11-02). We will take a look at test case 11.2 (TP/NWK/BV-02) for this document. The contents of the file tc11-02 will look something like this: beaglebone$ cat scripts/r22/tc11-02/tc11-02 # 11.2 TP/NWK/BV-02 ZR-ZDO-APL RX Join/Leave # Description # To test that devices are capable of joining and leaving network. # Procedure # Steps On gzc source tc11-02/gzc On dzr1 source tc11-02/dzr1 nwk_leave 0 zcl_tp2 buffer nwk 0x0 10 source tc11-02/dzr1 On gzc nwk_leave 0x On dzr1 zcl_tp2 buffer nwk 0x0 10 This listing demonstrates the commands used for each part of the test setup, and test procedure needed to execute test case 11.2 from the ZigBee PRO test specification. This particular test case requires two devices: gzc and dzr1, we we will need to log into two beaglebones to run this test. Inside the same directory contains the scripts to run a particular device role which matches the naming scheme of the test case. This test begins by forming a network, which is accomplished with the script file at scripts/r22/tc11-02/gzc beaglebone$ cat scripts/r22/tc11-02/gzc echo on # advertize our role so you can tell who we are with multiple windows open prompt gzc # initialize stack and set our EUI-64 as per the test case init 0xaaaaaaaaaaaaaaaa

14 RUNNING A TEST 11 source coord # start the stack startup_form # set PAN ID per test case (usually optional when joining) set_ib nwkpanid 0x1aaa # During testing, set FC cooldown to 10 seconds set_ib nwkframecountercooldown 10 # Enable permit-join indefinitely nwk_pjoin 255 However, before we can begin a test, we first need to set up the desired radio interfaces and channels that we want the devices to use for this test. The channels are adjusted by editing the script file located at scripts/r22/channels. To run this test using a single sub-ghz radio, we would start zbcli and execute the wpan serial /dev/q7x_subghz command. If you want to use a 2.4 GHz radio, execute the wpan serial /dev/q7x_2400 command. host-pc$ ssh debian@ x.2 beaglebone$./start zbcli > wpan serial /dev/q7x_subghz Once the radio has been successfully configured, we can continue by executing the gzc test case script. zbcli > source tc11-02/gzc The second part of the test continues by joining a DUT router to the golden unit, leaving the network, attempting to send traffic to the coordinator and then joining again. Thus we would conduct the DUT side of the test with the following commands. host-pc$ ssh debian@ y.2 beaglebone$./start zbcli > wpan serial /dev/q7x_subghz zbcli > source tc11-02/dzr dzr1 > nwk_leave 0 dzr1 > zcl_tp2 buffer nwk 0x0 10 dzr1 > source tc11-02/dzr1 Thus the following two steps could be executed by entering the commands on gzc and dzr1 respectively: gzc > nwk_leave 0x dzr1 > zcl_tp2 buffer nwk 0x0 10 Once the test has been completed, exit the zbcli tool using the quit command, and the output from the tool will have been saved to a file in the current directory named logfile

15 12 CHAPTER 1. QUICK START GUIDE gzc > quit beaglebone$ ls -l drwxr-xr-x 2 debian debian 4096 Nov 6 15:27 bin -rw-r--r-- 1 debian debian 210 Nov 6 15:46 logfile -rwxr-xr-x 1 debian debian 74 Nov 6 15:39 restart drwxr-xr-x 3 debian debian 4096 Nov scripts -rwxr-xr-x 1 debian debian 116 Nov 6 15:39 start

16 TURING OFF THE BEAGLEBONE 13 Turing off the beaglebone It is important to note that you cannot simply unplug the beaglebone from a power source. This can cause the file system to get corrupted on the device. To safely unplug the beaglebone, just enter the command: sudo shutdown -h and wait for the LEDs on the device to turn off. This command only works if the zbcli tool has been exited.

17 14 CHAPTER 1. QUICK START GUIDE

18 CHAPTER TWO INSTALLATION AND RECOVERY Kit Contents The following steps document the process for installing the Q7x golden unit software onto a beaglebone, or to restore a beaglebone to factory new condition. The Q7x golden unit platform consists of the following hardware: ˆ Beaglebone Green ˆ Q7x Beaglebone RF Cape with programmable RF attenuators. ˆ Two radios expansion modules, which can be any of the following: Q72 Radio board using the AT86RF215 dual-band radio. Q73 Radio board using the ADF7023 sub-ghz FSK radio. Q74 Radio board using the ADF724x 2.4GHz O-QPSK radio. ˆ Two u.fl mini-coaxial jumper cables to connect the radio modules to the cape. ˆ Three USB micro-b cables 15

19 16 CHAPTER 2. INSTALLATION AND RECOVERY Beaglebone Green The Beaglebone Green is an open source Linux computer, the golden unit platform is built on the Green variant from Seeedstudio, which includes gigabit Ethernet, 4GB of onboard emmc flash, and a single USB port. Other beaglebone variants can be used, but since the SPI signals for the programmable RF attenuators are shared with the HDMI controller, the HDMI output must be disabled when used with the Black and White variants of the Beaglebone.

20 Q7X BEAGLEBONE RF CAPE 17 Q7x Beaglebone RF Cape The RF cape provides a mounting solution for the Q7x radio modules onto a beaglebone and integrates an onboard two-port USB hub and two digital programmable RF attenuators inline between the u.fl and RP-SMA antenna connectors. Some variants may also include a battery-backed realtime clock. The cape makes use of the following pins on the Beaglebone header: Pin Signal Revision Description P9-1 Ground P9-2 Ground P V P V P9-7 +5V rev0 USB hub power P9-8 +5V rev0 USB hub power P9-10 NRST rev0 Reset signal to USB hub P9-14 PWM Output rev1 RGB LED (Red channel) P9-16 PWM Output rev1 RGB LED (Green channel) P9-19 I2C SCL Cape ID EEPROM and optional RTC P9-20 I2C SDA Cape ID EEPROM and optional RTC P9-28 SPI CS0 Chip select for first RF attenuator P9-29 PWM Output rev1 RGB LED (Blue channel) P9-30 SPI MOSI SPI data for RF attenuators P9-31 SPI CLK SPI clock for RF attenuators P9-42 SPI CS1 Chip select for second RF attenuator P9-43 Ground P9-44 Ground P9-45 Ground P9-46 Ground

21 18 CHAPTER 2. INSTALLATION AND RECOVERY Q7x Radio Modules The Q7x radio modules combine a small Cortex-M3 CPU and one of several IEEE radio transcievers. Each radio module implements the MAC and PHY layers of the OSI model, and can be controlled via the USB interface.

22 Q7X RADIO MODULES 19 Module Transceiver CPU Description Q72 AT86RF215 AT91SAM3S8B Dual-band IEEE radio module Q73 ADF7023 AT91SAM3S8B Sub-GHz IEEE g FSK radio module Q74 ADF724x AT91SAM3S8B 2.4GHz IEEE O-QPSK radio module

23 20 CHAPTER 2. INSTALLATION AND RECOVERY Assembly Instructions Begin assembly by installing the three 25mm M2 machine screws through the bottom of the cape pointing upwards as shown below, and screw on the three nylon hex standoffs to hold the screws in place. Install the 2.4GHz radio module onto the machine screws as shown below, and install a u.fl coaxial jumper between the 2.4GHz antenna connector and the outboard u.fl connector on the cape (furthest from the USB connector stack). Add the round nylon standoffs ontop of the 2.4GHz radio module. Install the sub-ghz radio module ontop of the machine screws as shown below, and install a u.fl coaxial jumper between the sub-ghz antenna connector and the inbouard u.fl connector on the cape (nearest to the USB connector stack). Fasten the radio modules in place with a M2 hex nut and secure the nut with a drop of loctite.

24 ASSEMBLY INSTRUCTIONS 21

25 22 CHAPTER 2. INSTALLATION AND RECOVERY Golden Unit Tools Installation 1. Change the static IP address of the golden unit to match the address printed on the side of P9 so that each Beaglebone can be uniquely addressed by modifiying USB Ethernet section of the file /etc/network/interfaces as follows: # Ethernet/RNDIS gadget (g_ether) # Used by: /opt/scripts/boot/autoconfigure_usb0.sh iface usb0 inet static address X.2 netmask network X.0 gateway X.1 2. Install the Q7x Golden Unit package by copying the installation tarball to the beaglebone, extracting and executing the install script. host-pc$ scp q7x-golden-installer.tar.gz debian@ x.2:~ host-pc$ ssh debian@ x.2 beaglebone$ tar -mxzf q7x-golden-installer.tar.gz beaglebone$ sudo q7x-golden-installer/install.sh 3. Safely power down the Beaglebone either by pressing the Power button adjacent to the Ethernet jack, or by running the command sudo shutdown -h now from the Beaglebone. Once the blue LEDs are all off it is safe to disconenct the Beaglebone. Failure to safely power down the device can lead to filesystem corruption.

26 GOLDEN UNIT TOOLS UPDATE - LINUX AND OSX 23 Golden Unit Tools Update - Linux and OSX To update the golden unit tools from a Linux or OSX machine, repeat steps 2 and 3 of the previous section with the provided instaler package.

27 24 CHAPTER 2. INSTALLATION AND RECOVERY Golden Unit Tools Update - Windows To update the golden unit tools from a Windows machine, we will need to use an SFTP and SSH client. We recommend the use of PuTTY and WinSCP. Once installed, the GU tools can be updated as follows: 1. Launch WinSCP and configure the sesion to use the SFTP protocol. The host name should match the IP address printed on the side of P9. The port number used by the SFTP protocol is 22, and the default login to the Beaglebone is debian with password temppwd. 2. Click Login to connect to the Beaglebone, and you will be presented with an authentication banner. Click Continue to proceed to the file transfer window.

28 GOLDEN UNIT TOOLS UPDATE - WINDOWS At the file transfer window, navigate the right pane to locate the provided GU installer package, it will be named q7x-golden-installer.tar.gz. And navigate the left pane to the /home/debian directory on the Beaglebone. Then drag and drop the q7x-golden-installer.tar.gz file from the right pane and into the left pane.

29 26 CHAPTER 2. INSTALLATION AND RECOVERY 4. After the file transfer is complete, click the red X to terminate the session and close WinSCP. 5. Launch PuTTY and configure the session to use the SSH protocol. The host name should match the IP address printed on the side of P9. The port number used by the SSH protocol is Click Open to connect to the Beaglebone and you will be prompted for your login credentials. The default login to the Beaglebone is debian with password temppwd.

30 GOLDEN UNIT TOOLS UPDATE - WINDOWS Perform the following commands to remove the previous tools, extract the installation package, and apply the upgrade to the Beaglebone. 8. After the upgrade is complete, we must restart the Beaglebone for the changes to take effect. The shutdown -hr now command can be used to safely power down and restart the Beaglebone.

31 28 CHAPTER 2. INSTALLATION AND RECOVERY