How to Integrate the Driver in the Kernel build operation
...
...
@@ -75,7 +77,9 @@ You should have followed the steps described in the prerequisite section already
Enter the Robopeak USB Displayer linux kernel driver folder (i.e. rpusbdisp/drivers/linux-driver), using the following command:
```shell
$ make KERNEL_SOURCE_DIR=~/workspace/linux-kernel
```
You should find the build result under the current folder: rp_usbdisplay.ko
...
...
@@ -87,7 +91,9 @@ You should have followed the steps described in the prerequisite section already
Let's also assume the target platform is ARMv7. We need to use the cross-compiler : arm-linux-gnueabihf-gcc.
Enter the following command to build the kernel driver for the target:
```shell
make CROSS_COMPILE=arm-linux-gnueabihf- ARCH=arm KERNEL_SOURCE_DIR=~/workspace/target-linux-kernel
```
You should find the build result under the current folder: rp_usbdisplay.ko
...
...
@@ -95,7 +101,7 @@ You should find the build result under the current folder: rp_usbdisplay.ko
How to Use the Kernel Driver
============================
I.deploy the dependencies modules
I. Deploy the dependencies modules
---------------------------------
If you had re-configed and recompiled the Linux kernel as required by the building process, you need to deploy the new kernel and all the kernel modules to the target system.
...
...
@@ -106,7 +112,7 @@ To be specific, you need to deploy AT LEAST the following kernel module to the
* sysimgblt.ko
* fb_sys_fops.ko
II. deploy the compiled kernel driver
II. Deploy the compiled kernel driver
-------------------------------------
Reboot the target system to using the new kernel. Copy the compiled usb display driver (rp_usbdisplay.ko) to the following location:
...
...
@@ -117,7 +123,7 @@ Enter the above folder and execute the following command:
depmod -a
III. load the kernel driver
III. Load the kernel driver
---------------------------
Once you had deployed the kernel driver and all of its dependencies, you can ask the kernel to load the driver using :
...
...
@@ -135,45 +141,53 @@ If you want to let the kernel load the driver automatically each time when the s
(i.e. cat rp_usbdisplay >> /etc/modules)
IV. verify the driver
IV. Verify the driver
---------------------
Using the lsmod command to check whether the driver has been loaded correctlly. You should get the output similar to the following text:
# lsmod
Module Size Used by
rp_usbdisplay 12171 0 [permanent]
fb_sys_fops 1412 1 rp_usbdisplay
sysimgblt 2199 1 rp_usbdisplay
sysfillrect 3295 1 rp_usbdisplay
syscopyarea 3112 1 rp_usbdisplay
```shell
# lsmod
Module Size Used by
rp_usbdisplay 12171 0 [permanent]
fb_sys_fops 1412 1 rp_usbdisplay
sysimgblt 2199 1 rp_usbdisplay
sysfillrect 3295 1 rp_usbdisplay
syscopyarea 3112 1 rp_usbdisplay
```
Also, you should find the following message in the dmesg log:
[ 7.535799] input: RoboPeakUSBDisplayTS as /devices/virtual/input/input0
[ 7.548115] usbcore: registered new interface driver rp-usbdisp
```log
[ 7.535799] input: RoboPeakUSBDisplayTS as /devices/virtual/input/input0
[ 7.548115] usbcore: registered new interface driver rp-usbdisp
```
To verify the driver work with the RoboPeak USB Display, connect the display to the target system via the USB cable. The display should display RoboPea Logo and turn to black (or something else) for about 3 second.
If the display keeps showing the white noise animation and the message : Waiting for signal, you should check the dmesg to see what happens. Normally, the driver will prompt the following message when the display has been pluged in :
[ 1814.173232] rp-usbdisp 4-1:1.0: RP USB Display found (#1), Firmware Version: X.XX, S/N: XXXXXXXXXXXX
```log
[ 1814.173232] rp-usbdisp 4-1:1.0: RP USB Display found (#1), Firmware Version: X.XX, S/N: XXXXXXXXXXXX
```
Once the driver recognizes the display, a framebuffer device will be created. (e.g. /dev/fb0)
Use the following command to see whether framebuffer device is belonged to the USB display:
# cat /proc/fb
2 rpusbdisp-fb <
```bash
# cat /proc/fb
2 rpusbdisp-fb <
```
In the above example, /dev/fb2 is the related framebuffer device. To test whether the framebuffer device works, you may using the following command:
# cat /dev/urandom > /dev/fb2
```bash
# cat /dev/urandom > /dev/fb2
```
You should see the display screen is filled with random color dots.
V. make X11 output to the USB display
V. Make X11 output to the USB display
-------------------------------------
There is a sample X11 config file under the source folder: rpusbdisp/drivers/linux-driver/xserver_conf/10-disp.conf. You can use this sample file as the template to make X11 on your target system to output to the USB display.
...
...
@@ -189,6 +203,13 @@ STEP4: restart the X11 server
The X11 desktop should appear on the USB display.
User Mode SDK
=============
Besides the Linux kernel driver, we also provide a user mode sdk which is available on Windows, OS X, and Linux.
You can find the SDK in the [drivers/usermode-sdk](https://github.com/cnwzhjs/rpusbdisp/tree/master/drivers/usermode-sdk) subdirectory.
