К основному содержанию
скилл CX Codex

riscv-privileged — скилл для Claude Code

Скилл riscv-privileged для разработки ядер и прошивок на RISC-V: работа с привилегированной архитектурой, режимами машины и супервизора, CSR регистрами, обработчиками ловушек, контроллерами PLIC и CLINT, OpenSBI.

MIT 355 установок ★ 298 обновлён 2026-06-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mohitmishra786/low-level-dev-skills --skill riscv-privileged -a claude-code
Открыть на GitHub

Что делает riscv-privileged

Скилл охватывает всю иерархию привилегий RISC-V: M-mode (машина, прошивка), S-mode (ядро ОС), U-mode (приложения). Помогает писать обработчики ловушек, настраивать векторы прерываний через CSR (mtvec, stvec), работать с состоянием (mstatus, sstatus) и кодами причин (mcause, scause).

Включает сценарии для интеграции OpenSBI, установки таблиц страниц Sv39 и Sv48, настройки контроллеров прерываний на платформе virt в QEMU. Содержит примеры прямого управления CLINT (таймер, программное прерывание) и PLIC (внешние устройства), а также шаблоны для сохранения и восстановления контекста при переходе между режимами.

Пригодится при портировании xv6-RISC-V, написании bare-metal прошивки или гипервизора. Скилл активируется на запросы о привилегированной архитектуре, CSR-регистрах, обработчиках ловушек, OpenSBI, PLIC, Sv39 и QEMU virt.

Какие задачи решает

  • написать обработчик ловушек и переключение контекста для S-mode
  • настроить таблицы страниц Sv39 и включить виртуальную память
  • интегрировать OpenSBI и вызывать SBI-функции из ядра
  • сконфигурировать PLIC и CLINT для обработки прерываний
  • отладить ядро на QEMU virt с помощью GDB

Примеры запросов агенту

  • Напиши обработчик ловушек для S-mode с сохранением регистров и разбором scause
  • Помоги настроить таблицы страниц Sv39 и загрузить satp перед переводом в режим с виртуальной памятью
  • Создай обёртку SBI для установки таймера и покажи, как вызывать из C-кода с помощью ecall

Как установить riscv-privileged

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill riscv-privileged -a claude-code

2Вручную: положить файлы

~/.claude/skills/riscv-privileged/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/riscv-privileged/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о riscv-privileged

Как установить riscv-privileged в Claude Code?

Выполни команду npx skills add mohitmishra786/low-level-dev-skills --skill riscv-privileged -a claude-code. Скилл будет доступен в ~/.claude/skills/riscv-privileged/SKILL.md.

Что делает скилл riscv-privileged?

Направляет разработку ядер и прошивок на RISC-V: объясняет привилегированные режимы (M/S/U), работу с CSR-регистрами, обработку ловушек и прерываний, интеграцию OpenSBI, настройку виртуальной памяти через Sv39/Sv48 и тестирование на QEMU virt.

В чём разница между Sv39 и Sv48?

Sv39 использует 3 уровня трансляции адресов и поддерживает 39-битные виртуальные адреса. Sv48 — 4 уровня и 48-битные адреса; это режим по умолчанию на QEMU virt для RV64. Выбор зависит от требуемого адресного пространства и производительности трансляции.

Исходный текст

SKILL.md · MIT
---
name: riscv-privileged
description: RISC-V privileged architecture skill for M/S/U modes and traps. Use when handling CSRs, trap handlers, PLIC/CLINT interrupts, OpenSBI integration, page tables Sv39/Sv48, or QEMU virt testing. Activates on queries about RISC-V privileged, mstatus, mtvec, satp, OpenSBI, PLIC, or Sv39.
---

# RISC-V Privileged Architecture

## Purpose

Guide agents through the RISC-V privileged specification: M/S/U privilege modes, CSR registers, trap handling, PLIC and CLINT interrupt controllers, OpenSBI firmware integration, Sv39/Sv48 page tables, and QEMU `virt` machine testing.

## When to Use

- Writing an OS kernel or hypervisor for RISC-V
- Implementing trap handlers and context switch
- Integrating OpenSBI for S-mode firmware services
- Configuring interrupt controllers on QEMU virt or hardware
- Setting up virtual memory with Sv39 or Sv48
- Porting xv6-RISC-V or bare-metal firmware

## Workflow

### 1. Privilege levels

```
RISC-V privilege stack
├── M-mode (Machine) — firmware, OpenSBI, most privileged
├── S-mode (Supervisor) — OS kernel
└── U-mode (User) — applications

Embedded (no S-mode): M + U only
```

### 2. Key CSRs

| CSR | Mode | Purpose |
|-----|------|---------|
| `mstatus` / `sstatus` | M/S | Interrupt enable, privilege state |
| `mtvec` / `stvec` | M/S | Trap vector base address |
| `mepc` / `sepc` | M/S | Exception PC |
| `mcause` / `scause` | M/S | Trap cause code |
| `mtval` / `stval` | M/S | Faulting address/instruction |
| `satp` | S | Page table root (mode + PPN) |
| ` mie` / `sie` | M/S | Interrupt enable bits |
| `mip` / `sip` | M/S | Interrupt pending bits |

```c
// Read CSR (GCC extended asm)
static inline uint64_t read_csr_satp(void) {
    uint64_t val;
    asm volatile("csrr %0, satp" : "=r"(val));
    return val;
}

// Write CSR
static inline void write_csr_stvec(void *handler) {
    asm volatile("csrw stvec, %0" :: "r"(handler));
}
```

### 3. Trap handling

```
Trap types
├── Synchronous exceptions — ecall, page fault, illegal insn
└── Asynchronous interrupts — timer, external, software
```

```c
// scause encoding (top bit: 1=interrupt, 0=exception)
void handle_trap(uint64_t scause, uint64_t sepc, uint64_t stval) {
    if (scause & (1UL << 63)) {
        // Interrupt
        switch (scause & 0xff) {
        case 5:  // Supervisor timer interrupt
            timer_interrupt();
            break;
        case 9:  // Supervisor external interrupt
            external_interrupt();
            break;
        }
    } else {
        // Exception
        switch (scause) {
        case 8:   // ecall from U-mode
            handle_syscall();
            break;
        case 12:  // Instruction page fault
        case 13:  // Load page fault
        case 15:  // Store page fault
            handle_page_fault(stval, scause);
            break;
        }
    }
}
```

### 4. Trap vector setup

```assembly
# trapvec.S — direct mode (all traps to one handler)
.section .text.trap
.globl trap_entry
.align 4
trap_entry:
    # Save registers to trap frame
    csrrw sp, sscratch, sp   # switch to kernel stack
    # ... save caller-saved ...
    csrr a0, scause
    csrr a1, sepc
    csrr a2, stval
    call handle_trap
    # ... restore ...
    sret
```

```c
write_csr_stvec(trap_entry);
// vectored mode: mtvec[1:0] = 01, base aligned to 4×entries
```

### 5. CLINT and PLIC

```
QEMU virt interrupt map
├── CLINT — timer and software interrupts (per-hart)
│   ├── mtime / mtimecmp — machine timer
│   └── msip — machine software interrupt
└── PLIC — external device interrupts (UART, virtio, etc.)
    ├── priority, pending, enable per source
    └── claim/complete per hart context
```

```c
// Timer via SBI (preferred in S-mode) or direct CLINT in M-mode
// PLIC claim
uint32_t irq = plic_claim(hart_id);
handle_device_irq(irq);
plic_complete(hart_id, irq);
```

### 6. OpenSBI

```bash
# Build OpenSBI with payload (your kernel)
git clone https://github.com/riscv-software-src/opensbi
cd opensbi
make PLATFORM=generic FW_PAYLOAD_PATH=../kernel.elf FW_PAYLOAD_OFFSET=0x80200000
# Output: build/platform/generic/firmware/fw_payload.elf
```

SBI calls from S-mode via `ecall`:

```c
struct sbiret sbi_set_timer(uint64_t stime) {
    return sbi_ecall(0x54494D45, 0, stime, 0, 0, 0, 0, 0);
    // Extension ID 0x54494D45 = TIME
}
```

Common SBI extensions: Base, Timer, IPI, RFENCE, HSM.

### 7. Page tables — Sv39

```
Sv39: 39-bit virtual addresses, 3 levels
VPN[2] → L2 PTE → L1 PTE → L0 PTE → physical page

satp: MODE(4) | ASID(9) | PPN(44)
MODE = 8 for Sv39, 9 for Sv48
```

```c
// PTE flags
#define PTE_V  (1L << 0)  // Valid
#define PTE_R  (1L << 1)  // Read
#define PTE_W  (1L << 2)  // Write
#define PTE_X  (1L << 3)  // Execute
#define PTE_U  (1L << 4)  // User accessible

uint64_t *walk_create(uint64_t *root, uint64_t va, int alloc);
void map_page(uint64_t *root, uint64_t va, uint64_t pa, int perm);
```

Sv48: 4 levels, 48-bit virtual addresses (QEMU virt default on RV64).

### 8. QEMU virt testing

```bash
qemu-system-riscv64 \
  -machine virt \
  -cpu rv64 \
  -m 128M \
  -kernel kernel.elf \
  -bios default \
  -serial mon:stdio \
  -display none \
  -no-reboot

# With OpenSBI payload
qemu-system-riscv64 \
  -machine virt -m 128M \
  -kernel opensbi/build/.../fw_payload.elf \
  -serial stdio -nographic
```

```bash
# GDB debug
qemu-system-riscv64 -s -S ...  # port 1234, wait
riscv64-unknown-elf-gdb kernel.elf
(gdb) target remote :1234
```

### 9. Reference: xv6-RISC-V

```bash
git clone https://github.com/mit-pdos/xv6-riscv
make qemu
# Study: kernel/trap.c, kernel/vm.c, kernel/start.c, kernel/plic.c
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Trap loop on boot | `stvec` misaligned | Align to 4 bytes; check handler |
| Page fault on entry | satp enabled before mapping | Identity-map kernel first |
| Timer not firing | SBI vs CLINT mismatch | Use `sbi_set_timer` in S-mode |
| PLIC no interrupts | Enable bit not set | Set priority, enable, threshold |
| OpenSBI hang | Wrong payload offset | Match `FW_PAYLOAD_OFFSET` to link addr |
| Illegal instruction | Compressed insn not supported | Enable C extension in CPU config |

## Related Skills

- `skills/low-level-programming/assembly-riscv` — RV32/RV64 ISA and psABI
- `skills/kernel/os-dev-scratch` — OS dev concepts (x86 parallel)
- `skills/virtualization/qemu-kvm` — QEMU usage patterns
- `skills/embedded/zephyr` — Zephyr on RISC-V
- `skills/kernel/kernel-internals` — Linux VM and scheduler analogies
- `skills/platform/arm-sve` — other architecture platform skills

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

Похожие скиллы

Все скиллы по теме «Языки программирования» →
esp32c6-lcd147 alexex1993 Помогает писать прошивку для Waveshare ESP32-C6-LCD-1.47. Разбирает настройку проекта, дисплея, SD-карты и отладку платы. CX Codex +1 ★ 29звёзд репо vm-and-bytecode-reverse yaklang Скилл vm-and-bytecode-reverse для Claude Code помогает разбирать самописные виртуальные машины и байткод: находить диспетчер, сопоставлять опкоды и писать дизассемблер. CX Codex +1 4 100установок iam-helper-for-privileged-access-management официальный google Скилл iam-helper-for-privileged-access-management для Claude Code управляет временным доступом: entitlements, grants и согласования. Включается для выдачи доступа на срок. CX Codex +1 3 900установок tilegym-converting-cutile-to-triton TileGym Team Скилл tilegym-converting-cutile-to-triton переводит GPU-ядра cuTile на Triton по фазам: анализ, конвертация, проверка, тесты, бенчмарк. Плюс разбор ошибок при переносе. CX Codex +1 1 500установок debugview microsoft Скилл для работы с Sysinternals DebugView CLI: ловит отладочный вывод приложений и драйверов Windows прямо из командной строки. CX Codex +1 15установок azure-operator-nexus MicrosoftDocs Справочник по платформе Azure Operator Nexus для ИИ-агентов. Помогает настраивать bare-metal серверы, сетевую фабрику, развёртывать кластеры и устранять сбои оборудования. CX Codex +1 169установок

Из того же набора140

Весь набор →
af-xdp Настраивает сокеты AF_XDP и память UMEM для скоростной обработки сетевых пакетов в userspace. Пригодится при написании фильтров трафика и балансировщиков. CX Codex +1 359установок triton-lang Скилл triton-lang учит агента писать GPU-ядра на Triton: @triton.jit, блочные tl.load/tl.store с масками, атомарные операции, автотюнинг и интеграцию в PyTorch. CX Codex +1 358установок containers-internals Скилл containers-internals для Claude Code по устройству Linux-контейнеров: намспейсы, cgroups v2, overlayfs, runc, seccomp и защита от escape. CX Codex +1 358установок rdma-verbs Скилл rdma-verbs для Claude Code — справочник по RDMA-программированию через libibverbs для InfiniBand и RoCE; в нём описаны настройка очередей, односторонняя запись и тесты perftest. CX Codex +1 356установок mpi Помогает писать параллельные программы на MPI: настраивать вызовы процессов, неблокирующие операции, гибрид с OpenMP и запуск через mpirun. CX Codex +1 354установок verilog-basics-for-lowlevel Скилл verilog-basics-for-lowlevel учит читать RTL-код на Verilog: модули, тактирование, reset-логику, шинные протоколы. Нужен разработчикам драйверов и firmware, когда документация неясна, а поведение железа объясняет баги. CX Codex +1 345установок hare-lang Скилл hare-lang обучает агента разработке на системном языке Hare: сборке через hare build, ручной настройке hare.mod, C FFI через @extern и типизированной обработке ошибок. CX Codex +1 330установок carbon-lang Скилл carbon-lang для Claude Code разбирает синтаксис Carbon, его связь с C++ и сборку toolchain. Помогает оценить язык и прототипировать миграцию. CX Codex +1 329установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой