Skip to content

Commit

Permalink
feat: add zero2pro english docs
Browse files Browse the repository at this point in the history
  • Loading branch information
CodeChenL committed Apr 1, 2024
1 parent c4dea78 commit 8445a02
Show file tree
Hide file tree
Showing 44 changed files with 880 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 50
---

# Accessories

Using Accessories with Radxa ZERO

<DocCardList />
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import Content from '../../../common/accessories/\_pd-30w.mdx'

# Radxa Power PD 30W

<Content />
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 30
---

# Application development

Introduces upper-layer application development, such as QT, WiringX, Mraa, etc.

<DocCardList />
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 2
---

# GPIOD Usage

import GPIOD from '../../../common/dev/\_gpiod.mdx';

<GPIOD />
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 25
---

# Application deployment

Introduces the configuration and use of common applications such as Samba, Docker, PVE, OMV, LAMP, Cheese, remote control panel, etc.

<DocCardList />
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
sidebar_position: 1
---

# Docker

Radxa Debian already has Docker-related configuration enabled in the kernel, so you just need to install the Docker application to get started.

1. Install Docker

```
sudo apt-get update
sudo apt-get install docker.io
```

2. After the installation is complete, execute the following two commands

```
sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
sudo reboot
```

3. Run docker test after reboot and check the status.

```
sudo docker run hello-world
sudo systemctl status docker
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
sidebar_position: 2
---

# Samba

Samba is a popular SMB/CIFS tool for Linux. With Samba, you can share files with many different operating systems, including Windows and Android.

1. Install samba

```
sudo apt-get update
sudo apt-get install samba
```

2. Editing the Samba Configuration File `/etc/samba/smb.conf`

```
sudo vim /etc/samba/smb.conf
```

3. Add the following configuration to the end of the file

```
[radxa]
comment = Shared from my Radxa device
path = /media/samba
available = yes
valid users = radxa
public = yes
writable = yes
```

4. Creating a shared folder

```
sudo mkdir /media/samba
sudo chmod 755 /media/samba
```

5. Create Samba user and password

```
sudo smbpasswd -a radxa
```

6. Restart the Samba service to load the updated configuration

```
sudo systemctl restart
```

7. Execute `systemctl status smbd` to check the status of samba

```
radxa@radxa-zero3:~$ systemctl status smbd
● smbd.service - Samba SMB Daemon
Loaded: loaded (/lib/systemd/system/smbd.service; enabled; vendor preset: >
Active: active (running) since Tue 2023-12-19 03:24:00 UTC; 14s ago
Docs: man:smbd(8)
man:samba(7)
man:smb.conf(5)
Process: 1963 ExecStartPre=/usr/share/samba/update-apparmor-samba-profile (>
Main PID: 1964 (smbd)
Status: "smbd: ready to serve connections..."
Tasks: 4 (limit: 9191)
Memory: 6.5M
CPU: 564ms
CGroup: /system.slice/smbd.service
├─1964 /usr/sbin/smbd --foreground --no-process-group
├─1966 /usr/sbin/smbd --foreground --no-process-group
├─1967 /usr/sbin/smbd --foreground --no-process-group
└─1968 /usr/sbin/smbd --foreground --no-process-group
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
sidebar_position: 10
---

# Getting started

<DocCardList />
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
sidebar_position: 4
---

# Instructions for accessory use

This section describes the accessories supported by the Radxa ZERO 2 PRO and how to use them.

## Interface overview

![ZERO 2 PRO Overview](/img/zero/zero2pro/zero2pro-mark.webp)
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
sidebar_position: 5
---

## Resource Download Summary

## Hardware Design

## Brush Tools

- [Zagdig](https://zadig.akeo.ie/):Windows Maskrom Driver.
- [RZ USB Boot Helper](https://dl.radxa.com/zero/tools/windows/RZ_USB_Boot_Helper_V1.0.0.zip):Windows bootloader Load Tool.
- [radxa-zero2-2pro-erase-emmc.bin](https://dl.radxa.com/zero2pro/images/loader/radxa-zero-2pro-erase-emmc.bin):Automatically erases the eMMC and then displays the eMMC as a USB storage device. This is the recommended method for loading a new Linux image.
- [rz-2pro-fastboot-loader.bin](https://dl.radxa.com/zero2pro/images/loader/rz-2pro-fastboot-loader.bin):Enable fastboot mode. It cannot be used to install our official Android system.
- [rz-2pro-udisk-loader.bin](https://dl.radxa.com/zero2pro/images/loader/rz-2pro-udisk-loader.bin): Use the onboard eMMC as a USB mass storage device.
- [u-boot.bin](https://dl.radxa.com/zero2pro/images/loader/u-boot.bin):Mainline U-Boot bootloader for USB booting. Does not work if flashing to eMMC/microSD.
- [u-boot.bin.sd.bin](https://dl.radxa.com/zero2pro/images/loader/u-boot.bin.sd.bin):Mainline U-Boot bootloader for eMMC/microSD booting.

## OS image

- [Radxa ZERO 2 PRO Debian Build 32](https://github.com/radxa-build/radxa-zero-2pro/releases/download/b32/radxa-zero-2pro_debian_bookworm_kde_b32.img.xz)

:::caution
Except for the above images which have been fully tested officially, the other images have not been rigorously tested and may have unknown issues and are for evaluation use only.
:::
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
sidebar_position: 2
---

import Etcher from '../../../common/general/\_etcher.mdx'

# Install OS

## Preparations

- ZERO 2 PRO

- Mass storage device:

- microSD, greater than 8GB, (for booting from SD)

- Card Reader

- microSD card reader (for booting from SD)

- Power supply

- The ZERO 2 PRO is powered by a Type-C connector with an input voltage of 5V, recommended to use a power adapter with a rated maximum current greater than 2A.
- The official [Radxa Power PD 30W](../accessories/pd-30w) is recommended. <img src="/img/accessories/pd-30w.webp" alt="Radxa Power PD 30W" width="300" />

- USB Keyboard and Mouse

- ZERO 2 PRO comes with two Type-C ports for a full-size keyboard and mouse via USB Hub.

- Monitor and HDMI cable

- The ZERO 2 PRO is equipped with a micro HDMI connector. It is recommended to use a monitor that supports HDMI.

- USB to TTL Serial Cable

- ZERO 2 PRO outputs a dedicated serial console for the CPU to access low level debug messages.
- Recommended Radxa USB to TTL Cable <img src="/img/accessories/usb-ttl.webp" alt="USB to TTL Cable" width="300" />.

## Image download

Please go to [Download Summary](./download) to download the corresponding image file.

## Installation system

<Etcher model="zero2pro" />

## Booting the System

- After successfully flashing the microSD card according to the above steps, insert the microSD card into the microSD slot of the ZERO 2 PRO.
- The power supply interface of ZERO 2 PRO is [USB OTG](../hardware-design/hardware-interface), please use a Type-C cable to connect the power port and the adapter.

:::tip
The ZERO 2 PRO power supply supports 5V, recommended to use a power adapter with a rated maximum current greater than 2A. radxa recommends using the [Radxa Power PD30W](../accessories/pd-30w).
:::.

## Reference Documentation

- [Install OS image to eMMC from USB OTG port](../low-level-dev/install-os-on-emmc)
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
sidebar_position: 1
---

## Preparation

## Development preparation

### Power Supply

ZERO 2 PRO is powered by Type-C connector with 5V input voltage, recommended to use a power adapter with a rated maximum current greater than 2A.
We recommend using the official [Radxa Power PD 30W](../accessories/pd-30w). <img src="/img/accessories/pd-30w.webp" alt="Radxa Power PD 30W" width="300" />

### Boot Media

Onboard eMMC or sd-card
If the board doesn't have an onboard eMMC([The eMMC is located on the back of the board](../hardware-design/hardware-interface#interface-overview)) you need to prepare a sd card with at least 8GB.
If you need to install an image with desktop environment, please use a sd card with at least 16GB, 32GB is recommended.

### microSD card reader

For flashing the system image.

### Monitor

The Radxa ZERO 2 PRO has a micro HDMI video output port on board, which requires a micro HDMI to standard HDMI cable to connect to the monitor.
The resolution of the HDMI output depends on the monitor, and the Radxa ZERO 2 PRO will adjust to the optimal display resolution according to the monitor.

### Networking

ZERO 2 PRO has an ap6212/ap6256/aw-cm256sm WiFi/BT module on board.

### Type-C Hub

The Radxa ZERO 2 PRO has an onboard [Type-C USB3.0](../hardware-design/hardware-interface#interface-overview). This interface supports Type-A ports and wired networks via the USB Type-C hub (if the hub supports it), but does not have video out.

### USB Mouse and Keyboard

The Radxa ZERO 2 PRO can be controlled by a keyboard and mouse connected to the USB Hub.

### Reference Documentation

[Supported Accessories](../accessories)
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 35
---

# Hardware Development

Introduces hardware information, such as hardware interfaces, supported accessories, etc.

<DocCardList />
Loading

0 comments on commit 8445a02

Please sign in to comment.