Zero/dev/usb-mass-storage - Revision history

Marcone: fix typo

2022-05-27T04:44:16Z

fix typo

RadxaYuntian at 02:57, 2 December 2021

2021-12-02T02:57:35Z

Stephen: /* Operations on Ubuntu PC */

2021-10-28T10:15:40Z

‎Operations on Ubuntu PC

Stephen: /* Operations on Radxa Zero */

2021-10-28T10:10:36Z

‎Operations on Radxa Zero

Stephen at 08:59, 28 October 2021

2021-10-28T08:59:46Z

Stephen at 08:58, 28 October 2021

2021-10-28T08:58:37Z

Stephen: Created page with "{{Zero_header}} {{Languages|zero/devusb-mass-storage}} Radxa Zero > Development > USB Mass Storage === Description..."

2021-10-28T08:55:36Z

Created page with "{{Zero_header}} {{Languages|zero/devusb-mass-storage}} Radxa Zero > Development > USB Mass Storage === Description..."

New page

{{Zero_header}}
{{Languages|zero/devusb-mass-storage}}

[[Zero | Radxa Zero]] > [[zero/dev | Development]] > [[zero/dev/usb-mass-storage | USB Mass Storage]]

=== Description ===
This guide describes how to setup USB Mass Storage on Radxa Zero.

=== Requirement ===
* Radxa Zero
* Host PC with Ubuntu
* USB Male A to C or USB C to C cable
** The USB cable is used for powering the Radxa Zero as well as data transmission from your host PC to the Zero. Depends on the USB port on host PC, you may need USB A to C(host PC is USB A) or USB C to C(host PC is USB C) cable.
* Mouse, monitor and HDMI Cable
** To access Radxa Zero
* USB to TTL serial cable
** To access Radxa Zero

=== Support ===
Support hardware platform:
* All Radxa Zero

You'd better follow the installation steps.

=== Operations on Radxa Zero ===

Step 1: Make sure that kernel version is at least version 5.10.69-6-amlogic. Otherwise, do the following steps to upgrade kernel.

rock@zero:~$ sudo apt update
rock@zero:~$ sudo apt install -y linux-headers-5.10.69-6-amlogic-g775a46783ad8
rock@zero:~$ sudo apt install -y inux-image-5.10.69-6-amlogic-g775a46783ad8

Step 2: Reboot the device.
rock@zero:~$ sudo reboot

Step 3: Create a file to be a shared space and make it FAT32 type.
rock@zero:~$ sudo dd if=/dev/zero of=/home/rock/share bs=1M count=512 status=progress
rock@zero:~$ sudo apt-get install dosfstools
rock@zero:~$ sudo mkfs.fat /home/rock/share -F 32 -I

Step 4: Enable usb mass storage with the file and create test.txt file.
rock@zero:~$ sudo modprobe g_mass_storage file=/home/rock/share stall=0 removable=1
rock@zero:~$ sudo mount /home/rock/share /mnt/
rock@zero:~$ sudo touch /mnt/test.txt
rock@zero:~$ echo "hello radxa" | sudo tee /mnt/test.txt
hello radxa
rock@zero:~$ cat /mnt/test.txt
hello radxa

=== Operations on Ubuntu PC ===

After executing command ''sudo modprobe g_mass_storage file=/home/rock/share stall=0 removable=1" on Radxa Zero,
we would see that one device is mounted. That one is Radxa Zero share space.

$ lsblk
...
sdd 8:48 1 512M 0 disk /media/radxa/5A81-B2F
...

Here we have to remount the share space.

radxa@focal:~$ sudo umount /media/radxa/5A81-B2F
radxa@focal:~$ sudo mount /dev/sdd /mnt/
radxa@focal:~$ cd /mnt/
radxa@focal-:/mnt$ ls
test.txt
radxa@focal:/mnt$ cat test.txt
hello radxa

=== Troubleshooting ===

* If you have issue with USB Mass Storage, start a new post on the forum. https://forum.radxa.com/c/zero.

@@ Line 23: / Line 23: @@
   rock@zero:~$ sudo apt update
   rock@zero:~$ sudo apt install -y linux-headers-5.10.69-6-amlogic-g775a46783ad8
-  rock@zero:~$ sudo apt install -y inux-image-5.10.69-6-amlogic-g775a46783ad8
+  rock@zero:~$ sudo apt install -y linux-image-5.10.69-6-amlogic-g775a46783ad8
 Step 1: Disable amlogic-adbd service. It will interfere with USB mass storage mode:

@@ Line 17: / Line 17: @@
 ** To access Radxa Zero
-=== Support ===
+=== Enable USB mass storage on Radxa Zero ===
-Support hardware platform:
-* All Radxa Zero
-You'd better follow the installation steps.
+Step 0: Make sure that kernel version is at least version 5.10.69-6-amlogic. Otherwise, you can upgrade the kernel with the following commands:
-−
-=== Operations on Radxa Zero ===
-−
-Step 1: Make sure that kernel version is at least version 5.10.69-6-amlogic. Otherwise, do the following steps to upgrade kernel.
   rock@zero:~$ sudo apt update
@@ Line 31: / Line 25: @@
   rock@zero:~$ sudo apt install -y inux-image-5.10.69-6-amlogic-g775a46783ad8
-Disable amlogic-adbd service.
+Step 1: Disable amlogic-adbd service. It will interfere with USB mass storage mode:
   rock@zero:~$ sudo systemctl disable amlogic-adbd
-Step 2: Reboot the device.
+Step 2: Reboot the device:
   rock@zero:~$ sudo reboot
-Step 3: Create a file to be a shared space and make it FAT32 type.
+Step 3: Create a file backing for mass storage, and format it in FAT32:
   rock@zero:~$ sudo dd if=/dev/zero of=/home/rock/share bs=1M count=512 status=progress
-  rock@zero:~$ sudo apt-get install dosfstools
+  rock@zero:~$ sudo dd if=/dev/zero of=/home/rock/share bs=1M count=512 status=progress # Create a 512M file as /home/rock/share
   rock@zero:~$ sudo mkfs.fat /home/rock/share -F 32 -I
-Step 4: Enable usb mass storage with the file and create test.txt file.
+Step 4: Enable USB mass storage on our backing file and create test.txt file:
   rock@zero:~$ sudo modprobe g_mass_storage file=/home/rock/share stall=0 removable=1
   rock@zero:~$ sudo mount /home/rock/share /mnt/
@@ Line 52: / Line 49: @@
   hello radxa
-=== Operations on Ubuntu PC ===
+=== Accessing storage device from Ubuntu PC ===
-After executing command ''sudo modprobe g_mass_storage file=/home/rock/share stall=0 removable=1" on Radxa Zero,
+After executing command <code>sudo modprobe g_mass_storage file=/home/rock/share stall=0 removable=1</code> on Radxa Zero, a new USB storage device will be detected on your host computer:
-we would see that one device is mounted. That one is Radxa Zero share space.
-  $ lsblk
+  radxa@x86-64:~$ lsblk
   ...
   sdd           8:48   1   512M  0 disk /media/radxa/5A81-B2F
   ...
-Here we have to remount the share space.
+Here we have to remount the share space:
   radxa@x86-64:~$ sudo umount /media/radxa/5A81-B2F
@@ Line 71: / Line 67: @@
   radxa@x86-64:/mnt$ cat test.txt
   hello radxa

@@ Line 64: / Line 64: @@
 Here we have to remount the share space.
-  radxa@focal:~$ sudo umount /media/radxa/5A81-B2F
+  radxa@x86-64:~$ sudo umount /media/radxa/5A81-B2F
-  radxa@focal:~$ sudo mount /dev/sdd /mnt/
+  radxa@x86-64:~$ sudo mount /dev/sdd /mnt/
-  radxa@focal:~$ cd /mnt/
+  radxa@x86-64:~$ cd /mnt/
-  radxa@focal-:/mnt$ ls
+  radxa@x86-64:/mnt$ ls
   test.txt
-  radxa@focal:/mnt$ cat test.txt
+  radxa@x86-64:/mnt$ cat test.txt
   hello radxa

@@ Line 2: / Line 2: @@
 {{Languages|zero/devusb-mass-storage}}
-    [[Zero | Radxa Zero]] > [[zero/dev | Development]] > [[zero/dev/usb-mass-storage | USB Mass Storage]]
+ [[Zero | Radxa Zero]] > [[zero/dev | Development]] > [[zero/dev/usb-mass-storage | USB Mass Storage]]
 === Description ===