Add USB to Serial Drivers

Author: jetsonhacks

README.md

@@ -1,20 +1,50 @@
 # installACMModule
 MIT License
 
-Copyright (c) 2017 Jetsonhacks
+Copyright (c) 2017-2018 Jetsonhacks
 
+There are scripts in this repository which install USB kernel modules which are not in the L4T 28.1 build. The modules:
+
+<ul><li>cdc-acm</li>
+<li>cp210x</li>
+<li>ch341</li>
+</ul>
+
+<h2>cdc-acm kernel module</h2>
 Install the CDC ACM Module for the Jetson TX1 or Jetson TX2 Development Kit
 
-On the NVIDIA Jetson TX2 and Jetson TX1 Development Kits running L4T 28.1, this script adds a module for USB Host functions to support Communication Device Class (CDC) Abstract Control Module (ACM) USB Devices.
+This script adds a module for USB Host functions to support Communication Device Class (CDC) Abstract Control Module (ACM) USB Devices.
 
 Typically these USB devices report as ttyACM* (where * is an integer). ACM devices have a lineage that goes back to modems and other network types of devices. However, many USB devices (such as an Arduino) are implemented using this simple USB protocol. The stock L4T 28.1 kernel does not have a CDC ACM module built in to the kernel, or as a separate module. This script adds cdc-acm.ko as a module so that such devices can be accessed through ttyACM*.
 
 To install:
 
 $ sudo ./installCDCACM.sh
 
-The script checks the version magic of the module and compares it to the kernel version running on the machine. If the two do not match, the user is asked if they still want to continue the installation. If the two match, the module is installed.
+<h2>cp210x USB to serial converter</h2>
+This script install the CP210x USB to serial converter module. There are several different types of USB to serial converters (FTDI is built into the L4T 28.1 kernel), the CP210x is used by devices such as the RP-LIDAR products
+
+<h2>ch341</h2>
+This script install the CH-341 USB to serial converter module. There are several different types of USB to serial converters (FTDI is built into the L4T 28.1 kernel), this is the CH-341 which is used by many Arduino clones.
+
+
+<h2>Notes</h2>
+These scripts expect a stock kernel, kernel version 4.4.38-tegra
+
+More than likely, you will need to replug the USB device for it to be detected properly after installing the kernel module.
+
+These scripts check the version magic of the module and compares it to the kernel version running on the machine. If the two do not match, the user is asked if they still want to continue the installation. If the two match, the module is installed.
 
 Note that on a version mismatch, the user can still install the module. However, some extra steps may be needed after the installation to get the module installed fully. The steps are not covered here, but should be readily available elsewhere.
 
+These scripts are for L4T 28.1. L4T version 28.2 includes cp210x and cdc-acm modules.
+
+<h2>Release Notes</h2>
+<em>February, 2018</em>
+Add cp210x and ch341 modules and install scripts
+
+<em>November, 2017</em>
+Initial Release
+
+
 

ch341.ko

@@ -0,0 +1,36 @@
+#!/bin/bash
+# Install the CH341 module
+# First, does the module version magic match the current kernel version?
+
+MAGICVERSION=$(modinfo ch341.ko | grep vermagic)
+MODULEVERSION=$(echo $MAGICVERSION | cut -d " " -f 2)
+KERNELVERSION=$(uname -r)
+if [ "$MODULEVERSION" == "$KERNELVERSION" ]
+then
+  echo "Kernel and Module Versions Match; Installing ..."
+else 
+  echo "The Kernel version does not match the Module Version"
+  echo "Kernel Version: " $KERNELVERSION
+  echo "Module Version: " $MODULEVERSION
+  while true; do
+  read -p "Would you still like to install the module? [Y/n] " response
+  case $response in
+    [Yy]* ) break ;;
+    [Nn]* ) exit;;
+    * ) echo "Please answer Yes or no. " ;;
+  esac
+  done
+  # The module version did not match the kernel version, but user selected to install anyway
+  echo "You may have to force the module to be inserted, i.e.  "
+  echo "$ sudo modprobe -f cp210x"
+fi
+# Install the ch341 module
+# Make sure that the drivers/usb/serial directory exists
+INSTALLDIRECTORY=/lib/modules/$(uname -r)/kernel/drivers/usb/serial
+sudo mkdir -p "$INSTALLDIRECTORY" 
+# Then copy over the module file
+sudo cp -v ch341.ko $INSTALLDIRECTORY
+sudo depmod -a
+echo "Installed ch341 Module"
+
+

cp210x.ko

@@ -0,0 +1,36 @@
+#!/bin/bash
+# Install the CP210x module
+# First, does the module version magic match the current kernel version?
+
+MAGICVERSION=$(modinfo cp210x.ko | grep vermagic)
+MODULEVERSION=$(echo $MAGICVERSION | cut -d " " -f 2)
+KERNELVERSION=$(uname -r)
+if [ "$MODULEVERSION" == "$KERNELVERSION" ]
+then
+  echo "Kernel and Module Versions Match; Installing ..."
+else 
+  echo "The Kernel version does not match the Module Version"
+  echo "Kernel Version: " $KERNELVERSION
+  echo "Module Version: " $MODULEVERSION
+  while true; do
+  read -p "Would you still like to install the module? [Y/n] " response
+  case $response in
+    [Yy]* ) break ;;
+    [Nn]* ) exit;;
+    * ) echo "Please answer Yes or no. " ;;
+  esac
+  done
+  # The module version did not match the kernel version, but user selected to install anyway
+  echo "You may have to force the module to be inserted, i.e.  "
+  echo "$ sudo modprobe -f cp210x"
+fi
+# Install the cp210x module
+# Make sure that the drivers/usb/serial directory exists
+INSTALLDIRECTORY=/lib/modules/$(uname -r)/kernel/drivers/usb/serial
+sudo mkdir -p "$INSTALLDIRECTORY" 
+# Then copy over the module file
+sudo cp -v cp210x.ko $INSTALLDIRECTORY
+sudo depmod -a
+echo "Installed cp210x Module"
+
+