【米尔瑞萨RZ/G2L开发板-创新应用】开启ADB devices功能

本文介绍，如何在开发板上开启ADB功能，方便后期的文件上传，等功能。毕竟，ADB功能较多，调试更为方便。

包括如下步骤：
1）kernel开启ADB相关的CONFIG配置宏
1.1）yocto recipes目录结构


1.2）USB gadget相关配置宏

1. CONFIG_USB_ANNOUNCE_NEW_DEVICES=y
   
2. CONFIG_USB_MON=y
   
3. USB_GADGET_DEBUG=y
   
4. CONFIG_USB_GADGET_DEBUG=y
   
5. CONFIG_USB_GADGET_DEBUG_FILES=y
   
6. CONFIG_USB_GADGET_DEBUG_FS=y
   
7. CONFIG_USB_CONFIGFS=y
   
8. CONFIG_USB_FUNCTIONFS=m
   
9. CONFIG_USB_G_SERIAL=m
   
10. CONFIG_USB_U_ETHER=y
    
11. CONFIG_USB_F_ECM=y
    
12. CONFIG_USB_F_SUBSET=y
    
13. CONFIG_USB_F_RNDIS=y
    
14. CONFIG_USB_F_MASS_STORAGE=y
    
15. CONFIG_USB_CONFIGFS_SERIAL=y
    
16. CONFIG_USB_CONFIGFS_ACM=y
    
17. CONFIG_USB_CONFIGFS_OBEX=y
    
18. CONFIG_USB_CONFIGFS_NCM=y
    
19. CONFIG_USB_CONFIGFS_ECM=y
    
20. CONFIG_USB_CONFIGFS_ECM_SUBSET=y
    
21. CONFIG_USB_CONFIGFS_RNDIS=y
    
22. CONFIG_USB_CONFIGFS_EEM=y
    
23. CONFIG_USB_CONFIGFS_MASS_STORAGE=y
    
24. CONFIG_USB_CONFIGFS_F_LB_SS=y
    
25. CONFIG_USB_CONFIGFS_F_FS=y
    
26. CONFIG_USB_CONFIGFS_F_UAC1=y
    
27. CONFIG_USB_CONFIGFS_F_MIDI=y
    
28. CONFIG_USB_CONFIGFS_F_HID=y
    
29. CONFIG_USB_CONFIGFS_F_UVC=y
    
30. CONFIG_USB_CONFIGFS_F_PRINTER=y

复制代码

2）增加usb gadget相关的recipes文件

2.1）目录结构如下




增加usb-start_1.0.bb文件，用来编译以及打包usb gadget相关的配置。
2.2）由于当前开发板使用systemd管理开机自启服务，因此需要在usb-start_1.0.bb文件当中，也需要使用systemd管理开机自启服务。
2.3）usb-start_1.0.bb文件内容如下。

1. #
   
2. # USB composite device configuration
   
3. #
   
4. 
   
5. SUMMARY = "USB composite device configuration"
   
6. SECTION = "examples"
   
7. LICENSE = "CLOSED"
   
8. 
   
9. SRC_URI = " \
   
10.     file://launch_adbd \
    
11.     file://usb_start.service \
    
12.     file://usb_start.sh \
    
13. "
    
14. 
    
15. S = "${WORKDIR}"
    
16. 
    
17. do_install() {
    
18.     install -m 0755 usb_start.sh -D ${D}${sysconfdir}/init.d/usb_start.sh
    
19.     install -m 0755 launch_adbd  -D ${D}${sysconfdir}/launch_adbd
    
20. 
    
21.     install -m 0644 usb_start.service -D ${D}${systemd_unitdir}/system/usb_start.service
    
22.     if [ ! -d ${D}${systemd_unitdir}/system/multi-user.target.wants  ];then
    
23.         mkdir ${D}${systemd_unitdir}/system/multi-user.target.wants
    
24.     else
    
25.         echo ${D}${systemd_unitdir}/system/multi-user.target.wants exist
    
26.     fi
    
27.     ln -sf ${systemd_unitdir}/system/usb_start.service ${D}${systemd_unitdir}/system/multi-user.target.wants/usb_start.service
    
28. }
    
29. 
    
30. FILES_${PN} += "${systemd_unitdir}/system"
    
31. FILES_${PN} += "${systemd_unitdir}/system/local-fs.target.wants/"

复制代码

2.4）launch_adbd文件内容如下

1. #! /bin/sh
   
2. #
   
3. # Copyright (c) 2017, The Linux Foundation. All rights reserved.
   
4. #
   
5. # Redistribution and use in source and binary forms, with or without
   
6. # modification, are permitted provided that the following conditions are
   
7. # met:
   
8. #   * Redistributions of source code must retain the above copyright
   
9. #     notice, this list of conditions and the following disclaimer.
   
10. #   * Redistributions in binary form must reproduce the above
    
11. #     copyright notice, this list of conditions and the following
    
12. #     disclaimer in the documentation and/or other materials provided
    
13. #     with the distribution.
    
14. #   * Neither the name of The Linux Foundation nor the names of its
    
15. #     contributors may be used to endorse or promote products derived
    
16. #     from this software without specific prior written permission.
    
17. #
    
18. # THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
    
19. # WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
    
20. # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
    
21. # ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
    
22. # BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    
23. # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    
24. # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
    
25. # BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
    
26. # WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
    
27. # OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
    
28. # IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
    
29. 
    
30. export TERM=linux
    
31. DAEMON="adbd"
    
32. PIDFILE="/var/run/$DAEMON.pid"
    
33. 
    
34. if [ -f /etc/default/adbd ]; then
    
35.     echo "/etc/default/adbd" > /dev/kmsg
    
36.     . /etc/default/adbd
    
37. fi
    
38. echo "Launch adb is starting adbd... "
    
39. start-stop-daemon -b -m -S -q -p "$PIDFILE" -x "/usr/bin/adbd"
    
40. 
    
41. # If UDC is not set up set it up.
    
42. if [ -z /sys/kernel/config/usb_gadget/g1/UDC ]; then
    
43.    udcname=`ls -1 /sys/class/udc | head -n 1`
    
44.    echo -n "udcname $udcname" > /dev/kmsg
    
45.    echo $udcname > /sys/kernel/config/usb_gadget/g1/UDC
    
46. fi
    
47. 
    
48. echo -n "Launch adbd. done" > /dev/kmsg
    
49. 
    
50. exit 0
    

复制代码

2.5）usb_start.service文件内容如下

1. [Unit]
   
2. Description=Renesas usb start
   
3. After=auditd.service
   
4. 
   
5. [Service]
   
6. Type=simple
   
7. RemainAfterExit=yes
   
8. #Restart=on-failure
   
9. #RestartSec=5s
   
10. #Nice=-5
    
11. ExecStart=/etc/init.d/usb_start.sh start
    
12. ExecStop=/etc/init.d/usb_start.sh stop
    
13. 
    
14. [Install]
    
15. WantedBy=multi-user.target
    

复制代码

2.6）usb_start.sh文件内容如下

1. #!/bin/sh
   
2. 
   
3. DAEMON="start_usb"
   
4. PIDFILE="/var/run/$DAEMON.pid"
   
5. 
   
6. UpdateLog()
   
7. {
   
8.     echo "${1}" 2>&1 | tee /dev/kmsg
   
9. }
   
10. 
    
11. run_usb_configfs() {
    
12.     usb_vid=0x0BB8
    
13.     usb_pid=0x5300
    
14.     manu_string="Renesas_Manufacturer"
    
15.     prod_string="Renesas_Product"
    
16.     usb_maxpower=500
    
17.     #serialnum=`devmem 0x5c005238`
    
18.     serialnum="123456789"
    
19.     #func_str="ecm.ecm,ffs.adb,gser.0,uac1.uac1,mass_storage.0,ncm.0,rndis.rndis"
    
20.     #func_str="ecm.ecm,ffs.adb,gser.0,uac1.uac1,mass_storage.0,ncm.0"
    
21.     #func_str="gser.0,gser.1,gser.2,gser.3,ffs.adb,uac1.uac1"
    
22.     #func_str="ecm.ecm,gser.0,ffs.adb,uac1.uac1"
    
23.     #func_str="ffs.adb,uac1.uac1"
    
24.     func_str="ffs.adb"
    
25. 
    
26.     UpdateLog "start adb"
    
27.     pkill adbd
    
28.     /etc/launch_adbd start
    
29.     sleep 1
    
30. 
    
31.     cd /sys/kernel/config/usb_gadget/g1
    
32.     echo $usb_vid > idVendor
    
33.     echo $usb_pid > idProduct
    
34.     echo 0xA0 > configs/c.1/bmAttributes
    
35.     echo "UAC_SER_RMNET" > configs/c.1/strings/0x409/configuration
    
36.     echo $manu_string > strings/0x409/manufacturer
    
37.     echo $prod_string > strings/0x409/product
    
38.     echo $serialnum   > strings/0x409/serialnumber
    
39.     echo $usb_maxpower > /sys/kernel/config/usb_gadget/g1/configs/c.1/MaxPower
    
40. 
    
41.     funcs=$(echo $func_str |tr "," "\n")
    
42.     func_index=1
    
43.     for func in $funcs
    
44.     do
    
45.         echo "ln $func $func_index"
    
46.         ln -s functions/$func configs/c.1/f$func_index
    
47.         func_index=$((func_index+1))
    
48.     done
    
49.     UpdateLog "binding UDC with Gadget ...\n" $1
    
50.     echo $1 > UDC
    
51.     cd /
    
52. }
    
53. 
    
54. start() {
    
55.     UpdateLog 'Starting %s: \n' $DAEMON
    
56.     #depmod
    
57.     #modprobe libcomposite
    
58.     #sleep 1
    
59.     #mount -t configfs none /sys/kernel/config
    
60.     if [ -d /sys/kernel/config/usb_gadget ];then
    
61.         UpdateLog "Configuring the USB gadget using ConfigFS"
    
62.         cd /sys/kernel/config/usb_gadget/
    
63.         mkdir g1
    
64.         cd g1
    
65.         mkdir strings/0x409
    
66.         mkdir configs/c.1
    
67.         mkdir configs/c.1/strings/0x409
    
68.         mkdir functions/mass_storage.0
    
69.         mkdir functions/mass_storage.1
    
70.         mkdir functions/ffs.adb
    
71.         mkdir functions/gser.0
    
72.         mkdir functions/gser.1
    
73.         mkdir functions/gser.2
    
74.         mkdir functions/gser.3
    
75.         mkdir functions/ncm.0
    
76.         mkdir functions/uac1.uac1
    
77.         mkdir functions/rndis.rndis
    
78.         mkdir functions/ecm.ecm
    
79. 
    
80.         if [ ! -s "/etc/adb_devid" ]; then
    
81.             #serialnum=`devmem 0x5c005238`
    
82.             serialnum="123456789"
    
83.             echo $serialnum > /etc/adb_devid
    
84.             sync
    
85.         fi
    
86.    
    
87.         udcname=`ls /sys/class/udc`
    
88.         UpdateLog "udcname=$udcname"
    
89.         run_usb_configfs $udcname &
    
90. 
    
91.         cd /
    
92.     fi
    
93. 
    
94.     #mount functionfs
    
95.     mkdir -p /dev/usb-ffs/adb
    
96.     mount -o uid=2000,gid=2000 -t functionfs adb /dev/usb-ffs/adb
    
97.     #mount -o remount,gid=5,mod=620 /dev/pts
    
98. 
    
99.     UpdateLog "usb.service initialized successfully"
    
100. }
     
101. 
     
102. stop() {
     
103.     UpdateLog 'Stopping %s: ' "$DAEMON"
     
104.     if [ -d /sys/kernel/config/usb_gadget ];then
     
105.         UpdateLog "Stop USB Android Gadget"
     
106.         echo none > /sys/kernel/config/usb_gadget/g1/UDC
     
107.         UpdateLog -n "usb.service stopped successfully"
     
108.     fi
     
109. }
     
110. 
     
111. restart() {
     
112.     stop
     
113.     sleep 1
     
114.     start
     
115. }
     
116. 
     
117. case "$1" in
     
118.     start|stop|restart)
     
119.         "$1";;
     
120.     reload)
     
121.         # Restart, since there is no true "reload" feature.
     
122.         restart;;
     
123.     *)
     
124.         echo "Usage: $0 {start|stop|restart|reload}"
     
125.         exit 1
     
126. esac
     

复制代码

3）打包usb-start相关的recipes文件到根文件系统当中

4）USB gadget ADB功能测试

顺便请教一个问题，当前使用123456789作为ADB设备的serialnumber，如果多个开发板同时接入一台host设备，那么就会
因为serialnumber统一，而导致无法区分adb devices。因此，需要使用SOC芯片的 Unique ID作为serialnumber。
我在r01uh0914ej0110-rzg2l-rzg2lc.pdf文件当中，并没有找到Unique ID的寄存器地址，以及读取方法，有知道的，方便告知一下，
万分感谢！！！

找到了这个寄存器，LSI Device ID Register (SYS_DEVID)
设备ID，devmem 0x11020A04
root@myir-yg2lx-1g:/lib/systemd/system# devmem 0x11020A04
0x4841C447

你能上传一下adbd这个执行文件吗？多谢！

lint019 发表于 2024-3-5 23:21
你能上传一下adbd这个执行文件吗？多谢！

我已经编译好了，见附件。哈哈。

结合上面的步骤，可以使用adb了

yocto构建系统当中，增加一个android-tools依赖，即可。