Wiki

This version (29 Jul 2020 01:47) was approved by Robin Getz.The Previously approved version (11 Apr 2017 22:05) is available.Diff

Mac OS X Drivers

HoRNDIS is required for Remote Network Driver Interface Specification (RNDIS) which is a USB protocol to provides a virtual Ethernet link. If you don't want to access your device over network - don't install HoRNDIS. It is optional.

Make sure the following drivers are installed:

  • HoRNDIS, HoRNDIS (pronounce: “horrendous”) is a driver for Mac OS X that allows you to use your RNDIS to get network access to Pluto. It is known to work with Mac OS X versions 10.6.8 (Snow Leopard) through 10.12 (Yosemite). Although you should be careful with all drivers that you install on your computer, HoRNDIS has been tested at least well enough for the author (and many others) to run full time on their own personal computers. It would be great if Apple decided to support this natively - since RNDIS is a Microsoft specification, it's unlikely.

The drivers and files should be compatible with:

  • macOS El Capitan 10.11
  • macOS Yosemite 10.10

A reboot is required after installing the HoRNDIS.

Serial

adi-mm:tests analogdevices$ ls -l /dev/tty.* 
crw-rw-rw-  1 root  wheel   17,   0 Nov  7 15:13 /dev/tty.Bluetooth-Incoming-Port
crw-rw-rw-  1 root  wheel   17,   2 Nov  7 15:28 /dev/tty.usbmodem1414
adi-mm:tests analogdevices$ screen /dev/tty.usbmodem1414 115200

Welcome to Pluto
pluto login: root
Password: analog
# uname -a
Linux pluto 4.6.0-08511-gc1315e6-dirty #247 SMP PREEMPT Mon Oct 24 16:46:25 CEST 2016 armv7l GNU/Linux
# 
CNTRL-A CNTRL-\
Really quit and kill all your windows [y/n] y
[screen is terminating]
adi-mm:tests analogdevices$ 

Mass Storage

adi-mm:tests analogdevices$ mount | grep Pluto
/dev/disk1s1 on /Volumes/PlutoSDR (msdos, local, nodev, nosuid, noowners)

Ethernet

Ethernet Warning

Like most of the network settings on Pluto or the M2k - things are meant to be easy to use. This also means things are inherently insecure.

For example - the root password of Pluto is analog. We post it on the Internet. Think about that for a moment. This could allow anyone with an IP connection to take over the device and use it for malicious purposes.

Never set up a bridge between the Internet and a network connected Pluto with the default images.

Unfortunately - nothing on your host understands the what the IP address of the usb device is. You, the human behind the keyboard need to understand this before any sort of networking will work. There are two main ways to do this:

Once the HoRNDIS driver is installed, you should see something like this when you goto → System Preferences → Network.

You may need to reboot without the PlutoSDR plugged in, and then attach the PlutoSDR to get HoRNDIS to load properly

To check things out, it should look something like this in dmesg:

adi-mm:build analogdevices$ sudo dmesg
HoRNDIS: init: HoRNDIS tethering driver for Mac OS X, by Joshua Wise (rel8 final)
HoRNDIS: probe: probe: came in with a score of 60000
HoRNDIS: message: unknown message type e000401f
HoRNDIS: message: unknown message type e0000230
HoRNDIS: probe: probe: looks like we're good (2/2/255)
USBMSC Identifier (non-unique): 100000235523730700230012090216da47 0x456 0xb673 0x406, 2
HoRNDIS: message: kIOMessageServiceIsAttemptingOpen
HoRNDIS: openInterfaces: data interface: okay, I got one, and it was a 0x0a/0x00/0x00
HoRNDIS: message: kIOMessageServiceIsAttemptingOpen
HoRNDIS: rndisInit: their MTU 1486
HoRNDIS: setMaxTransferUnit: Excuse me, but I said you could have an MTU of 1486, and you just tried to set an MTU of 1500.  Good try, buddy.
HoRNDIS: init: starting up with MTU 1486
en4: attached with 4 suspended link-layer multicast membership(s)
HoRNDIS: message: kIOMessageServiceIsAttemptingOpen
HoRNDIS: message: kIOMessageServiceIsRequestingClose
HoRNDIS: message: kIOMessageServiceIsAttemptingOpen
HoRNDIS: message: kIOMessageServiceIsRequestingClose
en4: failed to restore 4 suspended link-layer multicast membership(s) (err=102)

adi-mm:tests analogdevices$ ifconfig  | grep -B 3 -A 3 192
en4: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1486
	ether 00:e0:22:6d:b2:d8 
	inet6 fe80::2e0:22ff:fe6d:b2d8%en4 prefixlen 64 scopeid 0xa 
	inet 192.168.2.10 netmask 0xffffff00 broadcast 192.168.2.255
	nd6 options=1<PERFORMNUD>
	media: autoselect
	status: active

ssh config

Adding a quick/short ssh config file, which describes the USB device can be helpful. It's maintained in github, and it's a simple matter of grabbing the raw text file. You shouldn't do the exact below unless you have no ~/.ssh/config file. Otherwise, click on this link and copy/paste it into the system wide /etc/ssh/ssh_config file, or the user specific ~/.ssh/config file.

analog@imhotep:~$ wget https://raw.githubusercontent.com/analogdevicesinc/plutosdr_scripts/master/ssh_config -O ~/.ssh/config
--2017-01-26 19:47:51--  https://raw.githubusercontent.com/analogdevicesinc/plutosdr_scripts/master/ssh_config
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 151.101.116.133
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|151.101.116.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 366 [text/plain]
Saving to: ‘~/.ssh/config’

~/.ssh/config         100%[===============>]     366  --.-KB/s    in 0s      

2017-01-26 19:47:51 (6.49 MB/s) - ‘~/.ssh/config’ saved [366/366]

Since the ssh key on the pluto changes every boot, we want to be able to never store the key (so we store it to /dev/null. This does make it easier to use (don't need to continually edit the known_hosts file), but does make things susceptible to man in the middle attacks.

adi-mm:tests analogdevices$ ssh plutosdr
Warning: Permanently added 'pluto' (ECDSA) to the list of known hosts.
root@pluto's password: analog
# uname -a
Linux pluto 4.6.0-08511-gc1315e6-dirty #247 SMP PREEMPT Mon Oct 24 16:46:25 CEST 2016 armv7l GNU/Linux
# exit
Connection to 192.168.2.1 closed.
adi-mm:tests analogdevices$ 

if you have sshpass installed, you can use that so you dont need to type in a password:

analog@imhotep:~/pluto$ sshpass -panalog ssh plutosdr
Warning: Permanently added 'pluto' (ECDSA) to the list of known hosts.
Welcome to:
______ _       _        _________________
| ___ \ |     | |      /  ___|  _  \ ___ \
| |_/ / |_   _| |_ ___ \ `--.| | | | |_/ /
|  __/| | | | | __/ _ \ `--. \ | | |    /
| |   | | |_| | || (_) /\__/ / |/ /| |\ \
\_|   |_|\__,_|\__\___/\____/|___/ \_| \_|

http://wiki.analog.com/university/tools/pluto
# 

university/tools/pluto/drivers/osx.txt · Last modified: 29 Jul 2020 01:47 by Robin Getz