Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update Linux installation instructions #9

Merged
merged 1 commit into from
Apr 7, 2022
Merged

Update Linux installation instructions #9

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 39 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,15 +44,45 @@ Once you connect ollie to a Windows machine, you should be able to see 4 COM por

#### Linux
On Linux you should see four devices created, typically /dev/ttyXRUSB[0-3]. If you see /dev/ttyACM[0-3], there is a chance the UART might not behave correctly in this case you need to install drivers by following these steps:
1. \# git clone https://github.com/brendanhoran/xr_usb_serial_common
2. \# make *(on raspberry pi make sure you have the [kernel headers](https://www.raspberrypi.org/documentation/linux/kernel/headers.md) installed)*
3. \# cp -a ../xr_usb_serial_common-1a /usr/src/
4. \# dkms add -m xr_usb_serial_common -v 1a
5. \# dkms build -m xr_usb_serial_common -v 1a
6. \# dkms install -m xr_usb_serial_common -v 1a
7. \# echo blacklist cdc-acm > /etc/modprobe.d/blacklist-cdc-acm.conf
Copy link
Contributor Author

@milesfrain milesfrain Mar 12, 2022 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to blacklist, which is problematic if we ever plug in other ACM devices.

8. \# update-initramfs -u
9. Now plug in ollie.

_Optional_ Raspberry PI kernel headers setup:

Check for correct kernel headers:
```
ls /lib/modules/$(uname -r)/build
```

If not, install the kernel
```
sudo apt install raspberrypi-kernel-headers
```

You may also need to bump to the latest kernel version
```
sudo apt upgrade
sudo reboot
```

Main installation:

```
sudo apt install dkms
git clone https://github.com/brendanhoran/xr_usb_serial_common xr_usb_serial_common-1a
cd xr_usb_serial_common-1a
make

sudo -s
cp udev_rules/ollie.rules /etc/udev/rules.d/
cp udev_rules/ollie-plug.sh /usr/local/bin/
cp -a ../xr_usb_serial_common-1a /usr/src/
dkms add -m xr_usb_serial_common -v 1a
dkms build -m xr_usb_serial_common -v 1a
dkms install -m xr_usb_serial_common -v 1a
update-initramfs -u
exit

sudo reboot
```

#### Note: RS485 is connected to Ch C and RS232 is connected to Ch D. RS485 Bias(220R) and Termination resister(120R) can be enables using the dip switch. Refer to [pinout](#pinout)

Expand Down