diff --git a/README.md b/README.md new file mode 100644 index 0000000..2448103 --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +This is the kernel object portion of Intrepid Control Systems' SocketCAN support. For SocketCAN to work with Intrepid devices you will need to have this kernel object loaded on your system. Once the module is built and loaded run [icsscand](https://github.com/intrepidcs/icsscand) to turn on SocketCAN support. + +First, build the KO. + +``` +$ sudo make +``` + +The resulting file will be ```intrepid.ko```. This module depends on ```can```, ```can_dev```, and ```can_raw``` (which should already be a part of your system). Before you can load the module, make sure these modules are loaded, then ```insmod``` can be used to load it. + +``` +$ sudo modprobe can +$ sudo modprobe can_raw +$ sudo modprobe can_dev +$ sudo insmod intrepid.ko +``` + +```lsmod``` can confirm the module is loaded. If you wish you have the module auto-load on boot run ```make install``` once the module is built. + +``` +$ sudo make install +``` + +Follow your distro-specific method to auto-load modules. For example, on Ubuntu, edit your ```/etc/modules``` file to look something like this: + +``` +# /etc/modules: kernel modules to load at boot time. +# +# This file contains the names of kernel modules that should be loaded +# at boot time, one per line. Lines beginning with "#" are ignored. +can +can_raw +can_dev +intrepid +```