> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/ru/hacking-tools/enumeration/ruview-wifi-sensing.md).

# RuView WiFi Sensing

[RuView](https://github.com/ruvnet/RuView) — это экспериментальная платформа Wi‑Fi-сенсинга. Вместо камеры она изучает, как меняются сигналы Wi‑Fi, когда кто-то движется, сидит, дышит или проходит через комнату.

<figure><img src="https://raw.githubusercontent.com/ruvnet/RuView/main/assets/v2-screen.png" alt="RuView WiFi DensePose observatory showing a room sensing demo with vital signs and presence panels"><figcaption><p>Демо RuView Observatory из официального репозитория.</p></figcaption></figure>

{% hint style="info" %}
Используйте RuView только в разрешённых лабораториях или помещениях, где люди знают, что за ними ведётся наблюдение. Рассматривайте выходы по присутствию, позе, падению и жизненным показателям как исследовательские сигналы, если вы не проверили их самостоятельно.
{% endhint %}

## Визуальные демо и видео

Используйте эти визуальные материалы, чтобы понять проект, прежде чем переходить к оборудованию. Начните с демо, затем сравните то, что показывает интерфейс, с вашими собственными контролируемыми экспериментами.

<figure><img src="https://raw.githubusercontent.com/ruvnet/RuView/main/assets/ruview-seed.png" alt="RuView overview graphic from the official repository"><figcaption><p>Официальный визуальный обзор RuView.</p></figcaption></figure>

### Онлайн Observatory

Официальное браузерное демо поочерёдно показывает такие сценарии, как пустая комната, жизненные показатели, отслеживание нескольких людей, обнаружение падения, мониторинг сна, обнаружение вторжения, а также поиск и спасение.

{% embed url="<https://ruvnet.github.io/RuView/>" %}

### Демо Pose Fusion

Это демо полезно для понимания разницы между визуальными данными о позе и интерпретацией Wi‑Fi CSI. Используйте его как концептуальный обзор, а не как доказательство того, что каждая комната будет работать одинаково.

{% embed url="<https://ruvnet.github.io/RuView/pose-fusion.html>" %}

### Демо облака точек

Демо облака точек помогает объяснить идею преобразования входных данных сенсинга в пространственное представление.

{% embed url="<https://ruvnet.github.io/RuView/pointcloud/>" %}

### Фоновое видео

Это видео не специфично для RuView, но даёт простое высокоуровневое объяснение академической идеи DensePose по Wi‑Fi.

{% embed url="<https://www.youtube.com/watch?v=OhrQ0T6Yl9k>" %}

| Визуал                   | На что обратить внимание                                                                         |
| ------------------------ | ------------------------------------------------------------------------------------------------ |
| демо Observatory         | Присутствие, движение, уверенность, симулированные жизненные показатели, переключение сценариев. |
| Pose Fusion              | Как визуализируется выход, похожий на позу, и почему важна проверка.                             |
| Облако точек             | Как сенсинг может стать пространственным представлением.                                         |
| видео DensePose по Wi‑Fi | Исследовательский контекст, лежащий в основе оценки тела на базе Wi‑Fi.                          |

## Что это делает

RuView пытается превратить изменения сигнала Wi‑Fi в полезную информацию на уровне комнаты:

| Сценарий использования   | Простой смысл                                                                                     |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
| Обнаружение присутствия  | Есть ли кто-то в комнате?                                                                         |
| Обнаружение движения     | Кто-то идёт, сидит или двигается?                                                                 |
| Жизненные показатели     | Оценивать тенденции дыхания или частоты сердечных сокращений по небольшим изменениям сигнала.     |
| Распознавание активности | Выявлять повторяющиеся шаблоны, такие как жесты, сон, активность в комнате или возможные падения. |
| События умного дома      | Передавать состояния присутствия или активности в системы вроде Home Assistant.                   |
| Исследовательские демо   | Визуализировать позу на базе Wi‑Fi, облака точек и сценарии сенсинга.                             |

## Как это работает

Wi‑Fi уже отражается внутри помещений. Человек немного меняет эти радиотрассы. RuView считывает эти изменения как **Информация о состоянии канала** (CSI), очищает сигнал и отправляет его в модели или простые правила, которые оценивают, что может происходить.

Простая схема:

```
Сигнал Wi‑Fi
  -> ESP32 или оборудование с поддержкой CSI
  -> поток CSI
  -> обработка RuView
  -> присутствие, движение, жизненные показатели или визуализация демо
```

Проще говоря: камера видит пиксели; RuView видит небольшие изменения в отражениях радиосигнала. Это делает систему полезной для исследований, но также чувствительной к планировке комнаты, мебели, стенам, количеству людей, положению антенны и калибровке.

## Что вам нужно

| Цель                           | Рекомендуемая конфигурация                              |
| ------------------------------ | ------------------------------------------------------- |
| Быстро опробовать интерфейс    | Docker-демо с симулированными данными.                  |
| Изучить Python-пакет           | `pip install ruview`  или `pip install wifi-densepose`. |
| Проверить захват реального CSI | Плата ESP32-S3 или ESP32-C6 с прошивкой RuView.         |
| Лучшее покрытие комнаты        | Несколько узлов ESP32 или небольшая mesh-сеть.          |
| Эксперименты с моделями        | Набор моделей на Hugging Face и локальные датасеты.     |

## Быстрое Docker-демо

Это самый простой первый тест, потому что не требует оборудования.

```bash
docker pull ruvnet/wifi-densepose:latest
docker run -p 3000:3000 ruvnet/wifi-densepose:latest
```

Откройте:

```
http://localhost:3000
```

Используйте этот режим, чтобы изучить панель, сценарии и ожидаемые результаты до покупки или прошивки оборудования.

## Python-пакет

Установите Python-пакет:

```bash
pip install ruview
```

Альтернативное имя пакета:

```bash
pip install wifi-densepose
```

Установите дополнительную поддержку клиента для рабочих процессов WebSocket и MQTT:

```bash
pip install "ruview[client]"
```

Базовая проверка импорта:

```python
from ruview import BreathingExtractor, HeartRateExtractor
```

## Предобученная модель

RuView публикует предобученные веса для Wi‑Fi-сенсинга на Hugging Face. Скачайте их локально:

```bash
pip install huggingface_hub
huggingface-cli download ruvnet/wifi-densepose-pretrained --local-dir models/wifi-densepose-pretrained
```

Используйте эти файлы для обучения, изучения и экспериментов. Для рабочих развёртываний проверьте актуальные заметки репозитория, потому что форматы моделей и поддержка серверов могут измениться.

## Настройка оборудования ESP32

Для реального CSI-сенсинга используйте оборудование ESP32, которое может предоставлять информацию о канале Wi‑Fi. В README указаны ESP32-S3 и ESP32-C6 как практичные варианты.

Типичный высокоуровневый процесс:

1. Соберите или скачайте прошивку узла ESP32 CSI.
2. Прошейте плату этой прошивкой.
3. Настройте учётные данные Wi‑Fi и IP целевого сервера.
4. Запустите сервер сенсинга RuView или мост.
5. Откройте панель и проведите небольшой эксперимент в комнате.

Пример формы прошивки из README проекта:

```bash
python -m esptool --chip esp32s3 --port COM9 --baud 460800 \\
  write_flash 0x0 bootloader.bin 0x8000 partition-table.bin \\
  0xf000 ota_data_initial.bin 0x20000 esp32-csi-node.bin
```

Настройка Wi‑Fi:

```bash
python firmware/esp32-csi-node/provision.py --port COM9 \\
  --ssid "YourWiFi" --password "secret" --target-ip 192.168.1.20
```

## Первые эксперименты

Начните с простых экспериментов, прежде чем пробовать позу или жизненные показатели:

| Эксперимент                    | Что записывать                                  |
| ------------------------------ | ----------------------------------------------- |
| Пустая комната                 | Базовый сигнал, когда никого нет.               |
| Входит один человек            | Изменение присутствия и уверенности.            |
| Пройти через комнату           | Сигнал движения и время.                        |
| Сидеть неподвижно              | Ложные срабатывания и стабильность.             |
| Дверь открывается без человека | Проверка на шумы среды.                         |
| Входят два человека            | Становятся ли нестабильными подсчёт и движение. |

Хорошие заметки делают результат более полезным:

* Планировка комнаты.
* Положение датчиков.
* Канал Wi‑Fi.
* Количество людей.
* Стены или мебель между узлами.
* Повторяющиеся положительные и отрицательные тесты.

## Полезные команды

Запустите симулированное демо:

```bash
docker run -p 3000:3000 ruvnet/wifi-densepose:latest
```

Скачайте файлы модели:

```bash
huggingface-cli download ruvnet/wifi-densepose-pretrained --local-dir models/wifi-densepose-pretrained
```

Соберите прошивку ESP32-C6 из папки firmware проекта:

```bash
cd firmware/esp32-csi-node
idf.py set-target esp32c6
idf.py build
idf.py -p COM6 flash
```

Запустите живое RF-сканирование комнаты с помощью скриптов репозитория:

```bash
node scripts/rf-scan.js --port 5006
```

## Когда использовать

RuView хорошо подходит для:

* Исследований в области беспроводных технологий и IoT.
* Проверок конфиденциальности для сенсинга без камеры.
* Экспериментов по присутствию в умном доме.
* Понимания того, как Wi‑Fi может стать датчиком.
* Лабораторных демонстраций CSI, движения и RF-отпечатков.

Он не заменяет:

* Сертифицированное медицинское устройство.
* Надёжную систему аварийной сигнализации сам по себе.
* Систему идентификации или определения позы уровня камеры.
* Надлежащую проверку физической безопасности.

## Контрольный список проверки

Прежде чем доверять любому результату:

1. Убедитесь, что демо или сервер запускаются.
2. Убедитесь, что оборудование выдаёт CSI, а не только RSSI.
3. Запишите базовый уровень для пустой комнаты.
4. Повторите каждый тест несколько раз.
5. Запустите отрицательные тесты, которые не должны вызывать обнаружение.
6. Сравните жизненные показатели или события безопасности с независимым эталоном.
7. Документируйте сбои, а не только успешные снимки экрана.

## Ссылки

* [Официальный репозиторий RuView](https://github.com/ruvnet/RuView)
* [Руководство пользователя RuView](https://github.com/ruvnet/RuView/blob/main/docs/user-guide.md)
* [Онлайн-демо RuView Observatory](https://ruvnet.github.io/RuView/)
* [Предобученная модель RuView на Hugging Face](https://huggingface.co/ruvnet/wifi-densepose-pretrained)
* [Руководство по захвату движения RuView](https://ruview.blog/ruview-motion-capture/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hacking-notes.jord4n.pro/ru/hacking-tools/enumeration/ruview-wifi-sensing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.