Itron Riva Dev Mini Kit Getting Started Guide

Transcription

1 Itron Riva Dev Mini Kit Getting Started Guide Table of Contents Introduction... 1 Host Computer... 2 Connect and Power-up ROOT... 2 Connect and Power-up NODE... 8 Summary and Next Steps Introduction Welcome to the Itron Riva Dev Mini Kit Getting Started Guide! The purpose of this Guide is to give you a fast path to both understanding and using the Itron Riva Dev Mini Kit. The Itron Riva Dev Mini Kit includes everything you need to begin your prototyping or development for an Itron OpenWay Riva Network. A photo of the kit is shown below, and includes the following: One Itron Riva Dev Edge Board configured as RF mesh ROOT device One Itron Riva Dev Mini Board configured as RF mesh NODE device Two serial-to-usb cables (used for Linux console connection) Two 5VDC power cables Two 900Mhz antennas [Photo of Itron Riva Dev Mini Kit goes here] 1

2 Host Computer You should have a host computer, such as an Ubuntu, Mac, or Window. The instructions shown here are using a Ubuntu system as the host, but similar steps can be performed on Mac or Windows. For reference, the version of Ubuntu used for these instructions is 16.04: $ cat /etc/os-release NAME="Ubuntu" VERSION=" LTS (Xenial Xerus)" ID=ubuntu ID_LIKE=debian PRETTY_NAME="Ubuntu LTS" VERSION_ID="16.04" HOME_URL=" SUPPORT_URL=" BUG_REPORT_URL=" VERSION_CODENAME=xenial UBUNTU_CODENAME=xenial Your host computer will need a terminal emulator to connect to the Itron Riva Dev console. Here we use minicom: $ minicom --version minicom version 2.7 (compiled Feb ) Copyright (C) Miquel van Smoorenburg. Connect and Power-up ROOT Follow these steps to connect and power-up your Itron Riva Dev Mini Kit. Some of these steps in these section apply to both ROOT and NODE, and are hence labeled [BOTH]. Other steps are only for the ROOT, and are hence labeled [ROOT]. Some of the steps are labeled [HOST], which means you perform those steps on your host computer. 2

3 Important: The network performs best with you power up the ROOT device before powering up the NODEs. 1. [BOTH] Connect the antennas to each of the boards. 2. [BOTH] Connect the 5VDC power cords to each of the boards, HOWEVER do not yet power up the boards. 3. [BOTH] Connect the serial-to-usb cable to the 4-pin console connector on each of the boards. This is the white connector on the bottom of the boards. HOWEVER do not yet plug the cable into your Host computer. Play particular attention to getting the color codes connected correctly to the 4-pin connector: Pin 1 Yellow (TX) Pin 2 Orange (RX) Pin 3 Not used Pine 4 Black (GND) NOTE: On the Itron Riva Dev Edge board, the 4-pin white connector is on the bottom of the board. On the Itron Riva Dev Mini board, the 4-pin while connector is on the end of the expansion connector board. [TODO Photo of Power connector on Edge and also photo of power connector on Mini.] 3

4 NOTE: On the Itron Riva Dev Edge board, a memory technique is to remember that the Black (GND) cable connects closest to the 5VDC power connector. 4. [ROOT] One the board labeled as ROOT, plug in the Ethernet cable into the Itron Riva Dev Edge Ethernet connector. Plug plug into a network. The ROOT device requires a connection via Ethernet to obtain the proper time from an NTP (Network Time Protocol) server. 5. [HOST] On your host computer, use the ls command to observe if any /dev/ttyusbn ports are in us. In this example, no ports are currently in use: $ ls /dev/ttyu* ls: cannot access /dev/ttyu* : No such file or directory 4

5 6. [ROOT] Plug the ROOT serial-to-usb connector into your host USB port. Then issue the ls command and you should now see a /dev/ttyusb0 port. $ ls /dev/ttyu* /dev/ttyusb0 7. [HOST] Start up minicom: $ sudo minicom -D /dev/ttyusb0 HOST] In minicom, press Ctrl+a+z, then o, select Serial Port Setup. Make sure you turn of hardware flow control. NOTE: A common error is to forget to turn of hardware flow control. The result is you will see OUTPUT but will not be able to type any input. 8. [ROOT] Power up the ROOT device. You should see output on your minicom screen similar to the following. Do not press any key, but rather watch the system boot. NOTE: Although you do not want to to it now, later if you need to interrupt the default boot process, you have 3 seconds to press any key to stop the auto boot process. 5

6 9. [ROOT] At the end of the boot process you see the the message system sanity achieved. NOTE: The screen shot below is for a ROOT device. The RCV messages are from the on-board DHCP server (which is only on the ROOT). You can also see the utc time, showing that the ROOT is connected to the Internet, and accessing a NTP server. 10. [ROOT] Press ENTER to see the itron-isom login prompt, then enter root. When prompted for the password, enter itron. You will then see the shell prompt of #. 6

7 11. [ROOT] Use the modversion.sh command to confirm the version of firmware running on your ROOT device. For this example, the MUSE version is The DSP version is [ROOT] Use the df command to confirm how much disk filesystem space you have available. In this example, only 20% of the root filesystem is in use. 13. [ROOT] Use the free command to see how much free RAM space you have available. In this example, the system has a total of 112MB of memory in use, and 4MB of RAM free. 7

8 14. [ROOT] Use ngcstatus.sh command to see the sync status of the ROOT. The key item you are looking for is SYCnEt from RPL-Daemon. status. 15. [ROOT] Use the dodag_dump.sh command to see if you have any NODES. Since you have not yet powered up the NODE, you should not have any NODES listed. At this point you have powered up your ROOT device and used several commands to confirm its proper operation. It is now time to power-up your NODE device, following these steps. Connect and Power-up NODE 1. [NODE] Plug the NODE serial-to-usb connector into another USB port on the host. (Keep your ROOT serial-to-usb plugged in to your host so that you 8

9 can view both ROOT and HOST messages in separate windows.) 2. [HOST] Use the ls command and you should now see a 2 nd USB port: $ ls /dev/ttyu* /dev/ttyusb0 /dev/ttyusb1 3. [HOST] Start up minicom: $ sudo minicom -D /dev/ttyusb1 4. [HOST] In minicom, press Ctrl+a+z, then o, select Serial Port Setup. Make sure you turn of hardware flow control. NOTE: A common error is to forget to turn of hardware flow control. The result is you will see OUTPUT but will not be able to type any input. 5. [NODE] Power up the NODE device. You should see output on your minicom screen similar to the following. Do not press any key, but rather watch the system boot. NOTE: Although you do not want to to it now, later if you need to interrupt the default boot process, you have 3 seconds to press any key to stop the auto boot process. 9

10 6. [NODE] At the end of the boot process you see the message system sanity achieved. NOTE: The screen shot below is for a NODE device. The screen shot for a ROOT device is different. 7. [NODE] Press ENTER to see the itron-isom login prompt, then enter root. When prompted for the password, enter itron. You will then see the shell prompt of #. 10

11 8. [NODE] Use the modversion.sh command to confirm the version of firmware running on your ROOT device. For this example, the MUSE version is The DSP version is [NODE] Use the df command to confirm how must disk filesystem space you have available. In this example, 18% of the root filesystem is in use. 10. [NODE] Use the free command to see how much free RAM space you have available. In this example, the system has a total of 109MB of memory in use, and almost 8MB of RAM free. 11

12 [NODE] Use ngcstatus.sh command to see the sync status of the ROOT. The key item you are looking for is SYCnEt from RPL-Daemon. Status. NOTE: Notice Node IPv6 address: fd16:e8ac:e37c:2010:f9c9 12

13 Using ping6 1. [NODE] Use the ifconfig nan0 command to view the NODEs IPv6 address. For this example, the NODE IPV6 address is: fd16:e8ac:e37c:2010::f9c9 2. [NODE] Use the ping6 command to confirm that the node can ping6 the ROOT. NOTE: For these examples, the ROOT will always have a base address of febe. Just take the node address (e.g. fd16:e8ac:e37c:2010::f9c9) and substitute the value of febe (e.g. fd16:e8ac:e37c:2010::febe). 13

14 3. [ROOT] With the NODE up and running, you can return to the ROOT console. Issue the neighbor-dump.sh -m command to see that the NODE is in the list. Note: Observe address f9c9 has a HWType (Hardware Type) of MPD (Mains Powered Device), has a best RF modulation of OFDM_600, and has an RF RSSI (Received Signal Strength Indicator) of [ROOT] Use the ping6 command on the ROOT to ping6 the NODE. Summary and Next Steps In summary, this Guide has shown you how to connect, power-up, and confirm the operation of an Itron Riva Dev Mini Kit. You have used both the ROOT device and the NODE device on a RF mesh network. You next step is to refer to the appropriate documentation that fits you are particular need: Videos Specifications Technical References Tutorials and How To Guides 14