Changes between Version 1 and Version 2 of SPI

Timestamp:

11/20/2017 08:28:50 PM (7 years ago)

Author:

Ryan Erbstoesser

Comment:

add spidev section back in

SPI

@@ -78 +78 @@
 
 [[Image(spi2388.png,800px)]]
+
+== spidev - Userspace SPI API ==
+
+SPI devices have a limited userspace API, supporting basic half-duplex read() and write() access to SPI slave devices. Using ioctl() requests, full duplex transfers and device I/O configuration are also available.
+{{{
+        #include <fcntl.h>
+        #include <unistd.h>
+        #include <sys/ioctl.h>
+        #include <linux/types.h>
+        #include <linux/spi/spidev.h>
+}}}
+Some reasons you might want to use this programming interface include:
+
+* Prototyping in an environment that's not crash-prone; stray pointers in userspace won't normally bring down any Linux system.
+* Developing simple protocols used to talk to microcontrollers acting as SPI slaves, which you may need to change quite often.
+
+Of course there are drivers that can never be written in userspace, because they need to access kernel interfaces (such as IRQ handlers or other layers of the driver stack) that are not accessible to userspace.
+
+Userspace access to SPI devices is done through the /dev/spidev<bus>.<chip-select> device interface. In order to use this you must have spidev enabled in the kernel (CONFIG_SPI_SPIDEV) and have a spidev node defined under the SPI controller in the device-tree.
+
+For more info see:
+* [https://web.archive.org/web/20170619204541/https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/spi/spidev spidev Kernel Documentation]
+* [https://web.archive.org/web/20170619204541/https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/spi/spidev spidev examples]
+* [https://web.archive.org/web/20170619204541/https://lxr.missinglinkelectronics.com/linux/drivers/spi/spidev.c spidev kernel driver]