Skip to content

kkbesp/fz-tmn

Repository files navigation

fz-tmn

Status Data License

База дампов ключей домофонов, шлагбаумов и других систем контроля доступа в городе Тюмени. Поддерживает Flipper Zero и совместимые устройства.


⚠️ Правовой статус

Все данные предназначены исключительно для законного использования: резервное копирование собственных ключей, анализ, тестирование и исследования. Несанкционированный доступ запрещён.


📚 Оглавление


1. Что хранится в базе

Поддерживаемые типы дампов:

  • .nfc — NFC
  • .rfid — RFID брелки / карты
  • .ibutton — iButton / OneWire
  • .sub — Sub-GHz сигналы (радиобрелки, шлагбаумы)

База содержит:

  • дампы подъездов;
  • шлагбаумы и парковочные барьеры;
  • служебные точки доступа;
  • структуру по улицам и домам.

2. Быстрый старт (как использовать базу)

  1. Найдите нужную улицу (латиница, нижний регистр, через _).
  2. Откройте папку конкретного дома.
  3. Ознакомьтесь с дампами подъездов — они лежат в корне папки дома.
  4. Посмотрите шлагбаумы в каталоге gate.
  5. Проверьте служебные точки доступа в каталоге service.
  6. Используйте данные для анализа, исследований, проверки систем доступа.

3. Импорт данных с Flipper Zero

  1. Подключите Flipper Zero через USB-C или вставьте microSD в кардридер.

  2. Откройте накопитель Flipper.

  3. Найдите папки:

    • nfc
    • lfrfid
    • ibutton
    • subghz
  4. Скопируйте нужные дампы.

  5. Переименуйте и разместите согласно структуре.


4. Установка Git

Windows:

  1. Скачать Git: https://git-scm.com/download/win
  2. Установить, открыть Git Bash.

macOS:

brew install git

Linux:

sudo apt install git    # Debian/Ubuntu
sudo pacman -S git      # Arch

5. Клонирование репозитория

git clone https://github.com/kkbesp/fz-tmn.git

Каталог fz-tmn/ появится в текущей директории.


6. Обновление репозитория

Чтобы получить последние изменения:

  1. Перейдите в директорию репозитория:
cd fz-tmn

(Если репозиторий находится в другом месте — перейдите именно туда.)

  1. Выполните обновление:
git pull

7. Добавление новых данных (мейнтейнеры / внешние участники)

Для всех пользователей (рекомендуемый способ через GitHub)

Любой пользователь может добавить свои дампы прямо в репозиторий без установки Git и без форков.

Добавление файлов, если улица или дом уже существуют

  1. Перейдите к нужной улице и дому.
  2. Нажмите Add file → Upload files.
  3. Загрузите файлы (.nfc, .rfid, .ibutton, .sub).
  4. Убедитесь, что имена соответствуют правилам.
  5. Нажмите Propose changes — создастся Pull Request.
  6. Мейнтейнер проверит и примет изменения.

Добавление файлов, если улицы или дома ещё нет

GitHub позволяет создавать новые папки прямо при добавлении файла.

Способ 1 — Upload files:

  1. Перейдите в корень репозитория.
  2. Нажмите Add file → Upload files.
  3. В поле имени файла вручную укажите путь к новому адресу, например:
melnichnaya/12/1.rfid
  1. GitHub автоматически создаст папки melnichnaya и 12.
  2. Нажмите Propose changes для создания Pull Request.

Способ 2 — Create new file:

  1. Перейдите в корень репозитория.
  2. Нажмите Add file → Create new file.
  3. В поле имени сразу пропишите путь:
novaya_ulica/5/1.nfc
  1. Вставьте пустое содержимое или комментарий.
  2. Нажмите Propose changes.

Мейнтейнер проверит структуру, исправит названия при необходимости и примет данные.


8. Стандарты проекта (мейнтейнеры / внешние участники)

Для всех пользователей (рекомендуемый способ через GitHub)

Любой пользователь может добавить свои дампы прямо в репозиторий без установки Git и без форков.

  1. Откройте репозиторий: https://github.com/kkbesp/fz-tmn
  2. Перейдите к нужной улице и дому.
  3. Нажмите Add file → Upload files.
  4. Загрузите свои файлы (.nfc, .rfid, .ibutton, .sub).
  5. Убедитесь, что имена соблюдают правила структуры.
  6. Нажмите Propose changes.
  7. GitHub автоматически создаст Pull Request.
  8. Мейнтейнер проверит, при необходимости поправит имена/структуру и примет изменения.

8. Стандарты проекта. Стандарты проекта

  • строгая структура каталогов;
  • единая транслитерация;
  • только латиница;
  • дампы подъездов — только в корне дома;
  • шлагбаумы — только в gate/;
  • служебные точки — только в service/;
  • однозначные файлы и имена.

9. Структура репозитория

fz-tmn/
└── <ulica>/
    └── <dom>/
        ├── <porch>.nfc/.rfid/.sub/.ibutton
        ├── gate/
        └── service/

10. Пример структуры дома

ulica/dom/
├── 1.rfid
├── 2.nfc
├── 3.sub
├── gate/
│   ├── shlagbaum_v_zdanie.sub
│   └── shlagbaum_na_parking.sub
└── service/
    ├── sluzhebnaya_dver.ibutton
    └── tech_pom_1.rfid

11. Правила транслитерации

  • латиница;
  • _ между словами;
  • нижний регистр;
  • ё → e, й → y;
  • без спецсимволов.

Примеры:

  • Ванцетти → vancetti
  • Анатолия Клиндюка → anatoliya_klinduka

12. Правила именования файлов

Подъезды

<porch>.<ext>

Примеры:

  • 1.rfid
  • 2.nfc
  • 4.ibutton

Для нескольких дампов:

  • 1_1.rfid
  • 1_2.rfid

Gate / Service

gate/shlagbaum_v_zdanie.sub
service/sluzhebnaya_dver.rfid

13. Хорошие и плохие примеры имён

Тип Правильно Неправильно
Подъезд 1.rfid подъезд1.nfc
Несколько 1_2.sub 1-final(sub).sub
Gate shlagbaum_v_zdanie.sub шлагбаум в здание.sub
Gate vyezd_iz_dvora.sub gate_file_final_v3.sub
Service sluzhebnaya_dver.rfid служебка.rfid
Service tech_pom_1.ibutton техпомещение_1.ibutton
Подъезд 3.nfc 3й_подъезд.nfc
Любые 2.sub 2 (копия) — исправленный.sub

About

База дампов ключей систем контроля доступа в городе Тюмени. Поддерживает Flipper Zero и совместимые устройства.

Resources

License

Stars

Watchers

Forks

Contributors