OTAMan Документация

5. Вкладка Card reader (pySim)

Подключение к локальному pysim-otaman-server для работы с картой. Подвкладки: File manager, Custom files, Profiler, pySim command line, Raw APDU и Proactive UICC.

5.1 File manager

• Read — чтение файла (автоопределение transparent/record)
• Edit — изменить hex-данные, Save для записи
• Raw / Decoded — переключение между hex-дампом и декодированным JSON

5.2 Custom files

Добавление файлов, не покрытых моделью pySim. Сохраняется в localStorage; экспорт/импорт JSON.

5.3 pySim command line

Выполнение любых команд pySim-shell с подсказками (300 мс) и автодополнением.

5.4 Raw APDU

Отправка произвольного APDU и просмотр ответа.

5.5 Proactive UICC

Работа с сессией Card Application Toolkit: меню STK, подписанные события, журнал проактивных команд, словарь данных PROVIDE LOCAL INFORMATION и опрос STATUS.

5.5.1 Меню STK

Если карта выдала команду SET UP MENU, вверху этого представления появляется блок «STK menu» с изумрудной кнопкой STK: <название>, открывающей оверлей меню (браузер STK-меню карты). Если карта не задала меню, вместо кнопки показывается «No menu set by the card». Состояние меню обновляется при каждом открытии представления.

5.5.2 Подписанные события (SET UP EVENT LIST)

События, которые отслеживает карта. У каждого события есть кнопка Send, открывающая форму, специфичную для типа события:

• События без данных (User Activity, Idle Screen, Data Available, …) — уведомление в один клик
• Location Status — выпадающий список: Normal / Limited / No service (тег 9B)
• Access Technology Change — 13 типов RAT (тег BF)
• Network Rejection — полная адаптивная форма: тип регистрации (LU / GPRS / EPS / 5GS), поля местоположения (MCC, MNC, LAC, RAC, TAC), технология доступа и единый выпадающий список из 53 кодов причин (EMM, GMM, 5GMM и LU)

Отправка события использует ENVELOPE(Event Download) по TS 102 223 / TS 131 111.

5.5.3 Журнал проактивных команд

Хронологический список извлечённых проактивных команд. Каждая строка показывает время, код типа, имя и декодированный квалификатор (для команд, у которых он есть). Для команд с данными ответа показывается строка Response: с байтами TERMINAL RESPONSE (без служебных TLV); ответы PROVIDE LOCAL INFORMATION декодируются через словарь данных PLI.

5.5.4 Словарь данных PROVIDE LOCAL INFORMATION

Редактируемые hex-значения для всех 22 квалификаторов PLI (TS 102 223 §8.6 + TS 131 111). У десяти квалификаторов есть встроенные формы декодирования/кодирования:

• 00 Location Info (MCC, MNC, LAC/TAC, Cell ID)
• 01 IMEI · 03 Дата/время/TZ · 04 Язык · 05 Timing Advance
• 06 Access Technology · 08 IMEISV · 09 Search Mode
• 0A Battery · 0E Multiple Access Technologies

Значения хранятся на сервере до перезапуска. Когда карта выдаёт PLI, сервер вставляет значения словаря в TERMINAL RESPONSE.

5.5.5 Опрос STATUS

Кнопка Send STATUS отправляет STATUS (F2) вручную. Переключатель Polling включает фоновый опрос: после настраиваемого интервала бездействия (аргумент сервера --poll-interval, 1–255 с, по умолчанию 30 с) сервер отправляет STATUS и обрабатывает любую ожидающую проактивную команду. При извлечении карты опрос останавливается, а состояние карты сбрасывается.

5.6 Profiler

Проверяет соответствие карты именованному профилю — упорядоченному набору правил, описывающих ожидаемую файловую систему и (опционально) содержимое файлов. Профили хранятся в localStorage.

Список профилей

• New profile — создаёт пустой набор правил, запросив имя.
• Profile from card — сканирует подключённую карту и создаёт по одному правилу на каждый существующий файл (см. ниже), затем открывает редактор.
• Import profile — загружает набор правил из JSON-файла (имя хранится внутри JSON).
• В каждой строке профиля показаны имя и время создания, а также действия Edit, Check, Export (скачать JSON) и Delete.

Правила файловой системы

Правила выполняются последовательно. Правило файловой системы задаётся:

• Путь — начинается с MF (например, MF/7F10/6F3A) или с AID ADF (например, A0000000871002/6F07).
• Атрибуты файла — тип файла, размер, длина записи и число записей из FCI-шаблона (любой можно оставить незаданным).
• Содержимое (опционально) — Exact (точное совпадение hex) или Mask, где ? — шаблон на один полубайт (маска без ? — совпадение префикса, например 0891 для MCC/MNC из IMSI). Для record-файлов хранится список по записям.

Check выполняет каждое правило на подключённой карте и показывает строку прогресса и отчёт прохождения (существование, каждый атрибут FCI и совпадение содержимого).

Опции сканирования «Profile from card»

Диалог сканирования запрашивает имя профиля и предлагает список «Ignore contents of» (все отмечены по умолчанию) часто перезаписываемых файлов, содержимое которых пропускается: EF.LOCI, EF.PSLOCI, EF.EPSLOCI, EF.5GS3GPPLOCI, EF.Keys, EF.KeysPS, EF.SMS, EF.Kc, EF.KcGPRS, EF.LOCIGPRS, EF.CBMID, EF.SMSS. Правила создаются только для файлов, которые реально существуют на карте (возвращён FCI-шаблон); отсутствующие файлы пропускаются. Пользовательские файлы из подвкладки Custom files включаются с той же проверкой существования.

5.7 Сценарии использования

Сценарий A — Работа с файлами, не входящими в модель pySim (Custom files)

1. Получите FID целевого файла (документация вендора или анализ ATR/файловой системы; такие файлы часто отсутствуют в открытых спецификациях).
2. Откройте вкладку Card reader → подвкладку Custom files.
3. Введите полный путь (например, 3F00/7F20/6F46) и псевдоним (например, EF.SPN).
4. Нажмите Add — файл появится в дереве курсивом (непроверенный).
5. Кликните по файлу для проверки существования; при успехе (9000) он работает как обычный файл.
6. Читайте, редактируйте и сохраняйте hex-данные; переключайте Raw/Decoded.
7. Экспортируйте список пользовательских файлов в JSON для переноса на другие машины.

Сценарий B — Симуляция реальной сетевой среды для тестирования SIM

B.1 Ответы на PROVIDE LOCAL INFORMATION (PLI)

1. Откройте Proactive UICC → PROVIDE LOCAL INFORMATION response data.
2. Используйте формы декодирования/кодирования для IMEI (01), Location Info (00), Access Technology (06) и т.д.
3. Нажмите Save — значения сохранятся на сервере.
4. Включите Polling (интервал 30 с), чтобы карта периодически выдавала PLI.
5. Сервер вставляет значения словаря в каждый TERMINAL RESPONSE.
6. Проверьте в журнале проактивных команд: запись PLI покажет декодированный ответ.

B.2 Симуляция сетевых действий через ENVELOPE (event download)

1. Проверьте список подписанных событий (из SET UP EVENT LIST).
2. Нажмите Send на событии (например, Location Status) и заполните форму; будет отправлен ENVELOPE(Event Download).
3. Для Network Rejection выберите тип регистрации → поля местоположения → технологию доступа → причину отклонения.
4. Карта может ответить проактивной командой, которую обработчик цепочки зарегистрирует и обработает автоматически.

B.3 Проверка симулированной среды

• Журнал проактивных команд показывает полный цикл (команда + байты TERMINAL RESPONSE).
• Кнопка STATUS / автопросмотр поддерживают сессию CAT (цикл дренажа).

git clone https://github.com/anttro/otaman.git
cd otaman
chmod +x setup.sh start.sh
./setup.sh          # создаёт .venv, устанавливает pysim + сервер (однократно)
./start.sh          # запускает сервер (PWA + API, автоопределение ридера)

git clone https://github.com/anttro/otaman.git
cd otaman
setup.bat           # создаёт .venv, устанавливает pysim + сервер (однократно)
start.bat           # запускает сервер (PWA + API)

# Создать и активировать venv
python3 -m venv .venv
source .venv/bin/activate   # Linux/macOS
# .venv\Scripts\activate    # Windows

# Установить pysim
pip install git+https://github.com/osmocom/pysim.git

# Установить pysim-otaman-server (editable — раздаёт встроенный PWA)
pip install -e .

# Запустить сервер (PWA + API)
pysim-otaman-server --http-port 8080