Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 25 additions & 8 deletions docs/installation/licheervnano.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,12 @@ title: Deploy on LicheeRV Nano

This document walks you through deploying PicoClaw on the Sipeed LicheeRV Nano development board.

![rvnano](/img/rvnano/rvnano.webp)

LicheeRV Nano is an ultra-compact development board (only 22.86 × 35.56 mm) powered by the Sophgo SG2002 processor (featuring a 1 GHz selectable RISC-V/ARM main core and a 700 MHz RISC-V secondary core). It includes 256 MB DDR3 memory and an NPU with 1 TOPS of computing power. The board also provides rich interfaces, including MIPI-CSI, MIPI-DSI, SDIO, ETH, USB, SPI, UART, and I2C, making it suitable for a wide range of expansion scenarios. Its pin-header and castellated-hole compatible design also makes later mass-production SMT integration easier.

For more details about the LicheeRV Nano, please refer to the [Sipeed official documentation](https://wiki.sipeed.com/hardware/en/lichee/RV_Nano/1_intro.html).

## Prerequisites

- **System and network**: Your LicheeRV Nano should already be flashed and connected to the network. We recommend using the official Sipeed [system image](https://github.com/sipeed/LicheeRV-Nano-Build/releases/latest). You can write the image to an SD card using tools such as Win32DiskImager or balenaEtcher.
Expand Down Expand Up @@ -43,14 +47,6 @@ cp /root/picoclaw/picoclaw* /usr/bin
rm -rf /root/picoclaw /root/picoclaw_Linux_riscv64.tar.gz
```

## Start the TUI

After installation, run the following command to open PicoClaw's TUI (terminal user interface) for configuration and management:

```bash
picoclaw-launcher-tui
```

## Start the Web UI

If you prefer a graphical interface, run the following command in the terminal to start the web service:
Expand All @@ -66,3 +62,24 @@ http://<device-ip>:18800
```

> **Tip**: Replace `<device-ip>` with the actual LAN IP address assigned to your LicheeRV Nano.

## RV Claw

![rvclaw](/img/rvnano/rvclaw.jpeg)

RV Claw is based on the LicheeRV Nano development board, equipped with a function expansion board designed specifically for PicoClaw interactive applications. Targeting voice interaction and local display scenarios, it integrates a display, buttons, indicator LEDs, battery management, and audio peripheral interfaces, making it easy to quickly build a complete human-machine interaction terminal.

### Custom Image

Sipeed provides an out-of-the-box custom image for RV Claw.

RV Claw custom image download:
[Download link](https://github.com/sipeed/rvclaw/releases/latest)

File: picoclaw-rv-nano-YYYYMMDD.img.xz

- Flashing: You can use balenaEtcher to flash the image directly to an SD card; or decompress the `.xz` file first and use the `dd` command to flash it.

- The expansion board function code in the image is based on Python, located at `/opt/app_picoclaw` ([source code](https://github.com/sipeed/rvclaw)), making it easy to customize and develop further as needed.

For more details about RV Claw, please refer to the [Sipeed official documentation](https://wiki.sipeed.com/hardware/en/lichee/RV_Nano/7_picoclaw_board.html).
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,12 @@ title: Implantar no LicheeRV Nano

Este documento guia você pela implantação do PicoClaw na placa de desenvolvimento Sipeed LicheeRV Nano.

![rvnano](/img/rvnano/rvnano.webp)

A LicheeRV Nano é uma placa de desenvolvimento ultracompacta (apenas 22,86 × 35,56 mm), equipada com o processador Sophgo SG2002 (que conta com um núcleo principal RISC-V/ARM selecionável de 1 GHz e um núcleo secundário RISC-V de 700 MHz). Ela inclui 256 MB de memória DDR3 e uma NPU com 1 TOPS de poder computacional. A placa também oferece interfaces variadas, como MIPI-CSI, MIPI-DSI, SDIO, ETH, USB, SPI, UART e I2C, o que a torna adequada para uma ampla gama de cenários de expansão. Seu design compatível com barras de pinos e furos castelados também facilita a integração posterior via SMT em produção em massa.

Para mais detalhes sobre a LicheeRV Nano, consulte a [documentação oficial da Sipeed](https://wiki.sipeed.com/hardware/en/lichee/RV_Nano/1_intro.html).

## Pré-requisitos

- **Sistema e rede**: sua LicheeRV Nano já deve estar com o firmware gravado e conectada à rede. Recomendamos usar a [imagem oficial do sistema](https://github.com/sipeed/LicheeRV-Nano-Build/releases/latest) da Sipeed. Você pode gravar a imagem em um cartão SD usando ferramentas como Win32DiskImager ou balenaEtcher.
Expand Down Expand Up @@ -43,14 +47,6 @@ cp /root/picoclaw/picoclaw* /usr/bin
rm -rf /root/picoclaw /root/picoclaw_Linux_riscv64.tar.gz
```

## Inicie a TUI

Após a instalação, execute o comando a seguir para abrir a TUI (interface de usuário em terminal) do PicoClaw para configuração e gerenciamento:

```bash
picoclaw-launcher-tui
```

## Inicie a Web UI

Se preferir uma interface gráfica, execute o comando a seguir no terminal para iniciar o serviço web:
Expand All @@ -66,3 +62,24 @@ http://<device-ip>:18800
```

> **Dica**: substitua `<device-ip>` pelo endereço IP real atribuído à sua LicheeRV Nano na LAN.

## RV Claw

![rvclaw](/img/rvnano/rvclaw.jpeg)

O RV Claw é baseado na placa de desenvolvimento LicheeRV Nano, equipado com uma placa de expansão projetada especificamente para aplicações interativas do PicoClaw. Voltado para cenários de interação por voz e exibição local, integra display, botões, LEDs indicadores, gerenciamento de bateria e interfaces de periféricos de áudio, facilitando a montagem rápida de um terminal completo de interação humano-máquina.

### Imagem Personalizada

A Sipeed fornece uma imagem personalizada pronta para uso para o RV Claw.

Download da imagem personalizada do RV Claw:
[Link de download](https://github.com/sipeed/rvclaw/releases/latest)

Arquivo: picoclaw-rv-nano-YYYYMMDD.img.xz

- Gravação: você pode usar o balenaEtcher para gravar a imagem diretamente no cartão SD; ou primeiro descompactar o arquivo `.xz` e usar o comando `dd` para gravar.

- O código de funções da placa de expansão na imagem é baseado em Python, localizado em `/opt/app_picoclaw` ([código-fonte](https://github.com/sipeed/rvclaw)), facilitando a personalização e o desenvolvimento conforme necessário.

Para mais detalhes sobre o RV Claw, consulte a [documentação oficial da Sipeed](https://wiki.sipeed.com/hardware/en/lichee/RV_Nano/7_picoclaw_board.html).
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ title: 在 LicheeRV Nano 上部署

本文档将指导您在 Sipeed LicheeRV Nano 开发板上部署 PicoClaw。

![rvnano](/img/rvnano/rvnano.webp)

LicheeRV Nano 是一款超微型开发板(尺寸仅为 22.86 × 35.56 mm),搭载算能 SG2002 处理器(包含 1 GHz 可选 RISC-V/ARM 大核与 700 MHz RISC-V 小核),并内置 256MB DDR3 内存与 1 TOPS 算力的 NPU。此外,它板载了 MIPI-CSI、MIPI-DSI、SDIO、ETH、USB、SPI、UART 及 I2C 等丰富接口,能够满足多样化的应用扩展需求。其直插与半孔兼容设计,也非常便于后期的量产贴片。

LicheeRV Nano 的更多详细信息,请参考 [Sipeed 官方文档](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/1_intro.html)。
Expand Down Expand Up @@ -45,14 +47,6 @@ cp /root/picoclaw/picoclaw* /usr/bin
rm -rf /root/picoclaw /root/picoclaw_Linux_riscv64.tar.gz
```

## 启动 TUI

安装完成后,您可以直接运行以下命令,使用 PicoClaw 的 TUI(终端用户界面)进行配置和管理:

```bash
picoclaw-launcher-tui
```

## 启动 Web UI

如果您希望使用更直观的图形化界面进行操作,请在终端中运行以下命令以启动 Web 服务:
Expand All @@ -68,3 +62,24 @@ http://<设备IP>:18800
```

> **提示**:请将 `<设备IP>` 替换为您 LicheeRV Nano 实际分配到的局域网 IP 地址。

## RV Claw

![rvclaw](/img/rvnano/rvclaw.jpeg)

RV Claw 基于 LicheeRV Nano 开发板,搭载了专为 PicoClaw 交互应用打造的功能扩展板,面向语音交互与本地显示场景,集成显示、按键、指示灯、电池管理与音频外设接口,便于快速搭建完整的人机交互终端。

### 定制镜像

Sipeed 为 RV Claw 提供了开箱即用的定制镜像。

RV Claw 定制镜像下载:
[下载地址](https://github.com/sipeed/rvclaw/releases/latest)

文件:picoclaw-rv-nano-YYYYMMDD.img.xz

- 烧录方式:可使用 balenaEtcher 直接将镜像烧录进 SD 卡;也可先解压 `.xz` 文件后,使用 `dd` 命令进行烧录。

- 镜像内扩展板功能代码基于 Python,位于 `/opt/app_picoclaw`([源码](https://github.com/sipeed/rvclaw)),便于按需二次开发和自定义。

RV Claw 的更多详细信息,请参考 [Sipeed 官方文档](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/7_picoclaw_board.html)。
Binary file added static/img/rvnano/rvclaw.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/rvnano/rvnano.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading