1. USB簡介

USB：Universal Serial Bus（通用串行總線）。是一種常用于電子設備間通訊的通用標準接口。USB 總線作為一種高速串行總線，其極高的傳輸速度可以滿足高速數據傳輸的應用環境要求。

具有供電簡單（可總線供電）、安裝配置便捷（支持即插即用和熱插拔）、 擴展端口簡易（通過集線器最多可擴展127 個外設）、傳輸方式多樣化（4 種傳輸模式），以及兼容良好（產品升級后向下兼容）等優點。

1.1 EASY EAI Orin-Nano USB資源介紹

EASY EAI Orin-Nano有一路直出的USB3.0 HOST接口，還有一路直出的OTG接口。

若不了解【USB HOST】、【USB Device】以及【OTG】的含義，又或者有【必須使下層USB作為HOST】的需求，可參考《USB_HOST與USB_Device》一文。

1.2 USB攝像頭接入方案

注意：雖然USB支持熱插拔，但在沒給底板加裝外殼保護的情況下，很容易觸碰到底板上的器件，甚至板卡附近有金屬零件很容易造成板卡短路。因此也建議在插拔外設時，最好確保電源已經完全切斷。

【建議】USB攝像頭【直接】接入到底板的【上層】USB接口上。

雖然采用多路擴展方案，理論上可擴展127個設備，但在實際接入多個USB攝像頭時需要考慮USB通道的帶寬，USB集線層數，以及要解決設備ID相同的問題，因此非必要【不建議】這么接。

USB的理論最大層數為7層(含RootHub)。

1.3 USB設備的接入管理介紹

在USB攝像頭或者USB Hub進行物理連接后，我們需要知道這些USB設備是否被系統識別出來，則需要通過lsusb命令查看。

lsusb

另外，在文件系統中，USB Device管理目錄為/sys/bus/usb/devices，可在此處查看到從root_hub開始掛載的USB設備以及Hub設備的拓撲關系。

USB設備的設備命名方式規則如下：

1.4 尋找可用的設備節點

rockchip平臺，一個MIPI-CSI接口會對應20多個video節點(設備樹定了就會生成這么多個)，如下圖所示。

而且MIPI-CSI camera對應的節點，會在修改內核設備樹的時候固定下來（即：內核配好了MIPI-CSI Camera個數，無論MIPI-CSI攝像頭是否有接上，它的video節點情況都是不會根據MIPI-CSI Camera的接入情況而【動態】改變）。

而一個USB camera會對應2個video節點，【一般會】排列在MIPI-CSI camera的后面。舉個例子：內核配置了1路MIPI-CSI camera，那USB camera的節點就是/dev/video25和/dev/video26；內核配置了2路MIPI-CSI camera，那USB camera的節點就是/dev/video49和/dev/video50。以此類推。

但是【最準確】的方法，還是要看一下這個video節點的【描述信息】。Linux的v4l2框架會把這些節點的描述信息統一放在/sys/class/video4linux/目錄下，如下圖所示。

隨便進入一個描述，如video22。

通過cat命令，可以用查看這個name的內容是什么。

cat /sys/class/video4linux/video22/name

那么，我們則需要使用以下命令，對【所有video節點】進行掃描與【篩選】。

grep -i "usb" /sys/class/video4linux/video*/name

2. 快速上手

2.1 例程源碼下載

到【百度網盤】上下載相關的單例程序：

鏈接：https://pan.baidu.com/s/1RXHMGpmGSEfFy0rb1VkXSg?pwd=1234

提取碼: 1234

比如在windows環境中，就把單例程序下載到：此電腦D:BaiduNetdisk (無規定，用戶可自主選擇)，如下圖所示。

然后把例程【復制粘貼】到nfs掛載目錄中。（不清楚目錄如何構建的，可以參考《入門指南/開發環境準備/nfs服務搭建與掛載》）

2.2 例程編譯&運行

通過adb shell進入開發板環境，執行下方命令定位到demo目錄，并且執行編譯操作。

cd /home/orin-nano/Desktop/nfs/02_camera/
./build.sh

編譯成功后，相關的demo會生成在Release目錄下。

執行下方命令以運行demo，如下所示。

sudo ./Release/test-usbCam-single 49  ##需要root權限

執行效果如下所示。

然后把/tmp/photo拷貝到當前目錄下的Release內

cp /tmp/photo ./Release/

再通過組合鍵【Ctrl+Shift+T】創建一個新窗口，定位到nfs服務器的對應位置。

最后使用mplayer工具播放圖片，命令如下所示。

mplayer -demuxer rawvideo -rawvideo w=1280:h=720:format=bgr24 ./Release/photo -loop 0

例程默認分辨率為1280x720，故w和h的參數對應填入1280和720。當出現圖片異常時，說明分辨率等不太對應于手頭的攝像頭，所以需要調整usbcamera_init()的分辨率，例如640x480。

3. 測試USB攝像頭API案例

示例代碼路徑為：02_camera/test-usbCam/single-cam.c。USB Camera API的測試案例代碼邏輯流程如下所示：

3.1 源碼說明

int main()
{
    if(1 == argc){
        printf("nerr: Missing parameter!n");
        printf("================= [usage] ==================n");
        printf("example:n");
        printf("t%s n", argv[0]);
        printf("--------------------------------------------n");
        return 0;
    }
    int cameraIndex = atoi(argv[1]);
    
	char *pbuf = NULL;
	int ret = 0;
	int skip = 0;
	FILE *fp = NULL;

	ret = usbcamera_init(CAMERA_INDEX, CAMERA_WIDTH, CAMERA_HEIGHT, 0);
	if (ret) {
		printf("error: %s, %dn", __func__, __LINE__);
		goto exit3;
	}

	pbuf = (char *)malloc(IMAGE_SIZE);
	if (!pbuf) {
		printf("error: %s, %dn", __func__, __LINE__);
		ret = -1;
		goto exit2;
	}

	//跳過前10幀
	skip = 10;
	while(skip--) {
		ret = usbcamera_getframe(CAMERA_INDEX, pbuf);
		if (ret) {
			printf("error: %s, %dn", __func__, __LINE__);
			goto exit1;
		}
	}

	/* tips: 可以在Ubuntu下用mplayer播放錄制圖像
	*	mplayer -demuxer rawvideo -rawvideo w=1280:h=720:format=bgr24 photo -loop 0
	*/
	fp = fopen("/tmp/photo", "w");
	if (!fp) {
		printf("error: %s, %dn", __func__, __LINE__);
		ret = -1;
		goto exit2;
	}
	fwrite(pbuf, 1, IMAGE_SIZE, fp);
	fclose(fp);

exit1:
	free(pbuf);
	pbuf = NULL;
exit2:
	usbcamera_exit(CAMERA_INDEX);
exit3:
    return ret;
}

其中usbcamera_init()，usbcamera_getframe()，usbcamera_exit()是對v4l2接口調用的易用化封裝。具體實現于02_camera/commonApi/usb_camera/usb_camera.c。

審核編輯 黃宇