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

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

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

6.1 File manager

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

6.2 Custom files

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

6.3 pySim command line

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

6.4 Raw APDU

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

6.5 Proactive UICC

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

6.5.1 Подписанные события (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.

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

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

6.5.3 Словарь данных 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.

6.5.4 Опрос STATUS

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

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

Сценарий 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