Wiki

This version (11 Oct 2019 21:01) was approved by rgetz.The Previously approved version (17 Aug 2019 02:04) is available.Diff

Customizing the Pluto configuration

If you are already on a 192.168.2.* network

In RFC 1918 the Internet Engineering Task Force has directed the Internet Assigned Numbers Authority to reserve the IPv4 address range the 192.168.*.* (and others) for private networks. Analog Devices picked the 192.168.2.* subnet for it's private network for host to PlutoSDR devices, but there isn't anything stopping other people (including yourself) to be running a real network on the 192.168.2.* subnet.

It's a quick update to change the PlutoSDR network settings, which is described below.

Multiple devices

When using multiple PlutoSDR devices on the same host, there are a few options:

  • usb mode via libiio, no changes are required, and things will work out of the box
  • network mode, where changes to the network settings are required (more below).

In network mode, the default configuration is to have an IP address for the host (192.168.2.10), and the actual PlutoSDR device (192.168.2.1). As one can expect - IP addresses are expected to be unique, and the default configuration works well when you have one device, but not as well when you have multiple.

In order to use multiple devices, you must change their IP address. This is managed by updating the config.txt file on the PlutoSDR mass storage device.

# Device Configuration File
# Edit, Save and then Eject the USB Drive

[NETWORK]
hostname = pluto
ipaddr = 192.168.2.1
ipaddr_host = 192.168.2.10
netmask = 255.255.255.0

It's a simple matter of updating the [NETWORK] settings of the PlutoSDR ipaddr (default is 192.168.2.1), and your host PC settings ipaddr_host (default of 192.168.2.10). ip_addr and ipaddr_host must be unique, and must be on the same subnet. Separate Plutos on the same machine must be assigned different subnets. It's not recommended to use the real internet subnet. After saving the file back to the PlutoSDR mass storage device, simply eject (not unplug) the PlutoSDR mass storage device from your host.

Zeroconf

There is a Avahi deamon running on the PlutoSDR. Avahi is a free Zero-configuration networking (zeroconf) implementation, including a system for multicast DNS/DNS-SD service discovery. If your hostname is unique and your host is zeroconf enabled, you can simply connect to your PlutoSDR using hostname.local.

michael@mhenneri-D04:~$ iio_info -n pluto.local
Library version: 0.9 (git tag: f7cde8f)
Compiled with backends: local xml ip usb
IIO context created with network backend.
Backend version: 0.9 (git tag: v0.9   )
Backend description string: 192.168.2.1 Linux (none) 4.6.0-25369-g51ebbb9 #120 SMP PREEMPT Thu Apr 6 09:04:26 CEST 2017 armv7l
IIO context has 2 attributes:
	local,kernel: 4.6.0-25369-g51ebbb9
	ip,ip-addr: 192.168.2.1
IIO context has 5 devices:

[--snip--]

Host issues

The Zeroconf implementation for Linux Avahi, implements IPv4LL, mDNS and DNS-SD. It is part of most Linux distributions, and is installed by default on some. If you end up with weird errors, it's a simple matter of making sure it is installed:

rgetz@brain:~$ sudo apt-get install avahi-daemon avahi-utils

If you are on Windows, it's a little trickier. The Windows default implementation of zeroconf implements the Link-Local Multicast Name Resolution (LLMNR) standard/protocol. However, LLMNR isn't supported by the Linux Avahi running on the PlutoSDR, so you may need to install something that supports the protocols supported by Avahi. A few popular applications slip it in for their own needs, including Skype, Apple’s iTunes and Adobe Photoshop CS3 or later. So you might not need to add anything at all, or you might need to install one of those applications. There are some great instructions at AdaFruit for those needed this.

Once everything is installed, you should be able to use pluto.local as the hostname.

rgetz@brain:~/github/libiio$ ping pluto.local
PING pluto.local (192.168.2.1) 56(84) bytes of data.
64 bytes from 192.168.2.1 (192.168.2.1): icmp_seq=1 ttl=64 time=0.208 ms
64 bytes from 192.168.2.1 (192.168.2.1): icmp_seq=2 ttl=64 time=0.387 ms
^C
--- pluto.local ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1001ms
rtt min/avg/max/mdev = 0.208/0.297/0.387/0.091 ms

Changing the hostname in the config file:

# Device Configuration File
# Edit, Save and then Eject the USB Drive

[NETWORK]
hostname = fm_radio_antenna

will allow you to use fm_radio_antenna.local as the hostname:

rgetz@brain:~/github/libiio$ iio_attr -u ip:fm_radio_antenna.local -C
IIO context with 5 attributes:
hw_model: Analog Devices PlutoSDR Rev.A (Z7010-AD9363)
hw_serial: 1000002355237309001600070902169101
ad9361-phy,xo_correction: 40000000
local,kernel: 4.6.0-08871-g6297a9e
ip,ip-addr: 192.168.2.1

To find the IP number, if you know the name, try:

analog@imhotep:~$ avahi-resolve --name pluto.local
pluto.local	192.168.2.1

If you have multiple radios on the your network, and you want to find out the IP address of them, the pluto devices advertise an ssh and sftp-ssh servers :

analog@imhotep:~$ avahi-browse -d local _ssh._tcp --resolve -t
+   wlo1 IPv4 pluto                                         SSH Remote Terminal  local
=   wlo1 IPv4 pluto                                         SSH Remote Terminal  local
   hostname = [pluto.local]
   address = [192.168.1.149]
   port = [22]
   txt = []
analog@imhotep:~$ avahi-browse -d local _sftp-ssh._tcp --resolve -t
+   wlo1 IPv4 pluto                                         SFTP File Transfer   local
=   wlo1 IPv4 pluto                                         SFTP File Transfer   local
   hostname = [pluto.local]
   address = [192.168.1.149]
   port = [22]
   txt = []

Config File ACTIONS

[ACTIONS]
diagnostic_report = 0
dfu = 0
reset = 0

This section allows the user to perform certain [ACTIONS] The procedure is always the same. The config.txt file is edited using your favorite editor. Then the file is saved, finally the drive is ejected. (Not unplugged) After 2-3 seconds the drive reappears and may have some new file indicating some status.

Diagnostic Report

Setting this to 1 will generate a file called diagnostic_report, which contains various status information about the system and the Hardware.

The information contained in this report can be used to asses and debug system problems or failures. In order to guarantee fast and precise support it is recommended to always include a diagnostic when reporting a problem.

DFU

Setting this to 1 will put the system into DFU mode. Device Firmware Upgrade (DFU) is a vendor- and device-independent mechanism for upgrading the firmware of USB devices.

Reset

Setting this to 1 simply resets and reboots the device.

Updating to the AD9364

RF Transceiver LO tuning range Bandwidth
AD9363 (Default ADALM-PLUTO) 325 - 3800 MHz 20 MHz
AD9364 70 - 6000 MHz 56 MHz

There were some early PlutoSDR devices which use the AD9364, which is nearly identical to the AD9363 used the production builds. If you have one of the AD9364 based PlutoSDR devices, it's a quick matter of using the U-Boot's fw_printenv and fw_setenv commands to get that device's larger tuning range (70-6000 MHz) and larger bandwidth (56MHz).

From your favorite serial application, just open a serial connection (or ssh to 192.168.2.1) to the PlutoSDR. The username is root and the password is analog.

This will be the default (based on the AD9363):

# fw_printenv attr_name
## Error: "attr_name" not defined
# fw_printenv attr_val
## Error: "attr_val" not defined
#

To change things to the AD9364 configuration:

# fw_setenv attr_name compatible
# fw_setenv attr_val ad9364
# reboot

To learn more about resetting, check out the developer documentation.

After rebooting the device, this is what the AD9364 configuration looks like:

Welcome to Pluto
pluto login: root
Password:
# fw_printenv attr_name
attr_name=compatible
# fw_printenv attr_val
attr_val=ad9364
#

university/tools/pluto/users/customizing.txt · Last modified: 11 Oct 2019 21:01 by rgetz