[WIP] Trouble Shooting

lscvdma: disagrees about version of symbol module_layout

If you see the message "lscvdma: disagrees about version of symbol module_layout" in the output of sudo dmesg, it means that the kernel headers on your host were upgraded, either manually or automatically. In this case, please run sudo ./00_install_es3.sh again to rebuild the driver.

(ubuntu unattended upgrade)

Clarify the condition

// check if the NPL54 is recognized 
test@test-Nuvo-9000-Series:~/Desktop$ sudo lspci | grep -i lattice
01:00.0 Signal processing controller: Lattice Semiconductor Corporation Device 0001 (rev 01)

// check if the application is running
sudo systemctl status npl54.service 
// If the application goes well, you would find NPL54Capture, NPL54Retry is running 

// check if kernel driver is running
sudo dmesg v4l2 lscvdma

// check if the video node is existed 
ls /dev/video* 

If we could not find NPL54Capture, NPL54Retry running in the npl54.service

// Please restart the npl54.service first, to check if the situation gets better
sudo systemctl stop npl54.service
sudo systemctl start npl54.service

If the video node is lost, which means the driver goes wrong

// Please gently kill the process
sudo /usr/bin/pkill -SIGINT NPL54Capture

// Re-install the lscvdma driver
cd NPL54_ES3/lib
sudo rmmod lscvdma
sudo insmod /usr/lib/modules/lscvdma.ko 
make

// Re-install the v4l2 driver
cd NPL54_ES3/v4l2loopback
sudo modprobe -r v4l2loopback
make

// update the driver
cd NPL54_ES3
sudo ./00_install_es3.sh

How to use v4l2 to check the video streaming status

✅ 1. Check Video Capabilities

// Sensing ISX031c
test@test-Nuvo-9000-Series:~/Desktop$ v4l2-ctl --device=/dev/video100 --all
Driver Info:
        Driver name      : v4l2 loopback
        Card type        : Dummy video device (0x0064)
        Bus info         : platform:v4l2loopback-100
        Driver version   : 6.8.12
        Capabilities     : 0x85200003
                Video Capture
                Video Output
                Read/Write
                Streaming
                Extended Pix Format
                Device Capabilities
        Device Caps      : 0x05200003
                Video Capture
                Video Output
                Read/Write
                Streaming
                Extended Pix Format
Priority: 2
Video input : 0 (loopback: ok)
Video output: 0 (loopback in)
Format Video Capture:
        Width/Height      : 1920/1536
        Pixel Format      : 'UYVY' (UYVY 4:2:2)
        Field             : None
        Bytes per Line    : 3840
        Size Image        : 5898240
        Colorspace        : sRGB
        Transfer Function : Default (maps to sRGB)
        YCbCr/HSV Encoding: Default (maps to ITU-R 601)
        Quantization      : Default (maps to Limited Range)
        Flags             : 
Format Video Output:
        Width/Height      : 1920/1536
        Pixel Format      : 'UYVY' (UYVY 4:2:2)
        Field             : None
        Bytes per Line    : 3840
        Size Image        : 5898240
        Colorspace        : sRGB
        Transfer Function : Default (maps to sRGB)
        YCbCr/HSV Encoding: Default (maps to ITU-R 601)
        Quantization      : Default (maps to Limited Range)
        Flags             : 
Streaming Parameters Video Capture:
        Frames per second: 30.000 (30/1)
        Read buffers     : 16
Streaming Parameters Video Output:
        Frames per second: 30.000 (30/1)
        Write buffers    : 16

User Controls

                    keep_format 0x0098f900 (bool)   : default=0 value=0
              sustain_framerate 0x0098f901 (bool)   : default=0 value=0
                        timeout 0x0098f902 (int)    : min=0 max=100000 step=1 default=0 value=0
               timeout_image_io 0x0098f903 (button) : value=0 flags=write-only, execute-on-write

✅ 2. List Supported Formats

// Some code
test@test-Nuvo-9000-Series:~/Desktop$ v4l2-ctl --device=/dev/video100 --list-formats-ext
ioctl: VIDIOC_ENUM_FMT
        Type: Video Capture

        [0]: 'UYVY' (UYVY 4:2:2)
                Size: Discrete 1920x1536
                        Interval: Discrete 0.033s (30.000 fps)

✅ 3. Stream Test and Show Live FPS

// Some code
test@test-Nuvo-9000-Series:~/Desktop$ v4l2-ctl --device=/dev/video100 --stream-mmap --stream-count=100 --stream-to=/dev/null --verbose
VIDIOC_QUERYCAP: ok
                VIDIOC_REQBUFS returned 0 (Success)
                VIDIOC_QUERYBUF returned 0 (Success)
                VIDIOC_QUERYBUF returned 0 (Success)
                VIDIOC_QUERYBUF returned 0 (Success)
                VIDIOC_QUERYBUF returned 0 (Success)
                VIDIOC_QBUF returned 0 (Success)
                VIDIOC_QBUF returned 0 (Success)
                VIDIOC_QBUF returned 0 (Success)
                VIDIOC_QBUF returned 0 (Success)
                VIDIOC_STREAMON returned 0 (Success)
cap dqbuf: 0 seq:      0 bytesused: 5898240 ts: 219.923916 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4189 bytesused: 5898240 ts: 219.936792 delta: 12.876 ms dropped: 4188 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4190 bytesused: 5898240 ts: 219.986620 delta: 49.828 ms (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4191 bytesused: 5898240 ts: 220.057592 delta: 70.972 ms (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4192 bytesused: 5898240 ts: 220.107598 delta: 50.006 ms fps: 22822.05 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4193 bytesused: 5898240 ts: 220.157506 delta: 49.908 ms fps: 17950.25 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4194 bytesused: 5898240 ts: 220.186691 delta: 29.185 ms fps: 15960.42 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4195 bytesused: 5898240 ts: 220.257780 delta: 71.089 ms fps: 12565.00 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4196 bytesused: 5898240 ts: 220.287018 delta: 29.238 ms fps: 11555.98 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4197 bytesused: 5898240 ts: 220.336923 delta: 49.905 ms fps: 10162.06 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4198 bytesused: 5898240 ts: 220.386935 delta: 50.012 ms fps: 9066.58 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4199 bytesused: 5898240 ts: 220.436904 delta: 49.969 ms fps: 8185.38 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4200 bytesused: 5898240 ts: 220.487172 delta: 50.268 ms fps: 7456.64 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4201 bytesused: 5898240 ts: 220.536977 delta: 49.805 ms fps: 6852.50 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4202 bytesused: 5898240 ts: 220.587142 delta: 50.165 ms fps: 6335.70 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4203 bytesused: 5898240 ts: 220.637094 delta: 49.952 ms fps: 5893.34 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4204 bytesused: 5898240 ts: 220.707660 delta: 70.566 ms fps: 5364.00 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4205 bytesused: 5898240 ts: 220.736752 delta: 29.092 ms fps: 5173.25 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4206 bytesused: 5898240 ts: 220.807859 delta: 71.107 ms fps: 4758.23 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4207 bytesused: 5898240 ts: 220.836875 delta: 29.016 ms fps: 4608.09 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4208 bytesused: 5898240 ts: 220.886785 delta: 49.910 ms fps: 4370.27 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4209 bytesused: 5898240 ts: 220.936307 delta: 49.522 ms fps: 4157.48 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4210 bytesused: 5898240 ts: 220.986695 delta: 50.388 ms fps: 3961.31 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4211 bytesused: 5898240 ts: 221.036602 delta: 49.907 ms fps: 3784.54 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4212 bytesused: 5898240 ts: 221.107717 delta: 71.115 ms fps: 3558.03 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4213 bytesused: 5898240 ts: 221.136992 delta: 29.275 ms fps: 3472.99 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4214 bytesused: 5898240 ts: 221.186947 delta: 49.955 ms fps: 3336.42 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4215 bytesused: 5898240 ts: 221.236924 delta: 49.977 ms fps: 3210.19 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4216 bytesused: 5898240 ts: 221.286626 delta: 49.702 ms fps: 3093.84 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4217 bytesused: 5898240 ts: 221.336717 delta: 50.091 ms fps: 2984.85 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4218 bytesused: 5898240 ts: 221.386947 delta: 50.230 ms fps: 2883.06 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4219 bytesused: 5898240 ts: 221.436956 delta: 50.009 ms fps: 2788.43 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4220 bytesused: 5898240 ts: 221.486722 delta: 49.766 ms fps: 2700.27 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4221 bytesused: 5898240 ts: 221.557738 delta: 71.016 ms fps: 2583.51 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4222 bytesused: 5898240 ts: 221.586967 delta: 29.229 ms fps: 2538.71 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4223 bytesused: 5898240 ts: 221.657790 delta: 70.823 ms fps: 2435.59 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4224 bytesused: 5898240 ts: 221.686820 delta: 29.030 ms fps: 2396.05 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4225 bytesused: 5898240 ts: 221.736606 delta: 49.786 ms fps: 2330.79 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4226 bytesused: 5898240 ts: 221.807521 delta: 70.915 ms fps: 2243.57 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4227 bytesused: 5898240 ts: 221.836934 delta: 29.413 ms fps: 2209.60 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4228 bytesused: 5898240 ts: 221.886745 delta: 49.811 ms fps: 2154.03 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4229 bytesused: 5898240 ts: 221.957452 delta: 70.707 ms fps: 2079.63 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4230 bytesused: 5898240 ts: 221.986546 delta: 29.094 ms fps: 2050.78 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4231 bytesused: 5898240 ts: 222.057364 delta: 70.818 ms fps: 1983.17 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4232 bytesused: 5898240 ts: 222.086613 delta: 29.249 ms fps: 1956.82 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4233 bytesused: 5898240 ts: 222.157543 delta: 70.930 ms fps: 1895.12 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4234 bytesused: 5898240 ts: 222.186534 delta: 28.991 ms fps: 1871.28 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4235 bytesused: 5898240 ts: 222.236624 delta: 50.090 ms fps: 1831.19 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4236 bytesused: 5898240 ts: 222.307371 delta: 70.747 ms fps: 1777.25 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4237 bytesused: 5898240 ts: 222.357379 delta: 50.008 ms fps: 1741.14 (ts-monotonic, ts-src-eof)
cap dqbuf: 0 seq:   4238 bytesused: 5898240 ts: 222.407368 delta: 49.989 ms fps: 1706.50 (ts-monotonic, ts-src-eof)

🧠 Summary Table:

Field	Meaning
seq	Frame number (increments per frame)
bytesused	Number of bytes in the buffer (frame size)
ts	Timestamp of when the frame was dequeued (monotonic time)
delta	Time difference between this and previous frame
fps	Approximate FPS based on delta
ts-monotonic	Clock source is monotonic (stable system clock)
ts-src-eof	Timestamp taken at frame end (closer to real capture time)