$ pip install pyflipper

from pyflipper import PyFlipper

# Локальный последовательный порт
flipper = PyFlipper(com="/dev/ttyACM0")

# ИЛИ

# Удалённый сервер serial2websocket
flipper = PyFlipper(ws="ws://192.168.1.5:1337")

# TCP
flipper = PyFlipper(tcp='192.168.89.222:22170')

# Информация (на текущей прошивке под капотом читает `info power`)
info = flipper.power.info()

# Выключение
flipper.power.off()

# Перезагрузка
flipper.power.reboot()

# Перезагрузка в режиме DFU
flipper.power.reboot2dfu()

# Включение/выключение вывода 5V OTG на пине GPIO
flipper.power.otg_on()
flipper.power.otg_off()

# Установка обновления из файла .fuf
flipper.update.install(fuf_file="/ext/update.fuf")

# Резервное копирование Flipper в файл .tar
flipper.update.backup(dest_tar_file="/ext/backup.tar")

# Восстановление Flipper из резервного .tar файла
flipper.update.restore(bak_tar_file="/ext/backup.tar")

# Список установленных приложений
apps = flipper.loader.list()

# Открыть приложение
flipper.loader.open(app_name="Clock")

# Получить дату Flipper (объект datetime)
date = flipper.date.datetime()

# Получить метку времени Flipper
timestamp = flipper.date.timestamp()

# Получить словарь информации об устройстве (текущая прошивка `info device`, ключи через точку)
device_info = flipper.info.device_info()

# Получить словарь информации о питании (текущая прошивка `info power`)
power_info = flipper.info.power_info()

# Расширенная отладочная информация о питании/датчике
power_debug = flipper.info.power_debug_info()

# Устаревшая команда `device_info` (ключи с подчёркиваниями, всё ещё поддерживается)
legacy_info = flipper.device_info.info()

# Получить словарь информации о куче
heap = flipper.free.info()

# Получить строку free_blocks
free_blocks = flipper.free.blocks()

# Получить информацию Bluetooth
bt_info = flipper.bt.info()

# Получить информацию о файловой системе хранилища
ext_info = flipper.storage.info(fs="/ext")

# Получить словарь содержимого /ext
ext_list = flipper.storage.list(path="/ext")

# Получить дерево каталогов /ext
ext_tree = flipper.storage.tree(path="/ext")

# Получить информацию о файле
file_info = flipper.storage.stat(file="/ext/foo/bar.txt")

# Создать каталог
flipper.storage.mkdir(new_dir="/ext/foo")

# Прочитать файл
plain_text = flipper.storage.read(file="/ext/foo/bar.txt")

# Удалить файл
flipper.storage.remove(file="/ext/foo/bar.txt")

# Скопировать файл
flipper.storage.copy(src="/ext/foo/source.txt", dest="/ext/bar/destination.txt")

# Переименовать файл
flipper.storage.rename(file="/ext/foo/bar.txt", new_file="/ext/foo/rab.txt")

# MD5-хеш файла
md5_hash = flipper.storage.md5(file="/ext/foo/bar.txt")

# Записать файл одним блоком
file = "/ext/bar.txt"

text = """There are many variations of passages of Lorem Ipsum available, 
but the majority have suffered alteration in some form, by injected humour, 
or randomised words which don't look even slightly believable. 
If you are going to use a passage of Lorem Ipsum, 
you need to be sure there isn't anything embarrassing hidden in the middle of text. 
"""

flipper.storage.write.file(path=file, text=text)

# Записать файл с помощью слушателя
file = "/ext/foo.txt"

text_one = """There are many variations of passages of Lorem Ipsum available, 
but the majority have suffered alteration in some form, by injected humour, 
or randomised words which don't look even slightly believable. 
If you are going to use a passage of Lorem Ipsum, 
you need to be sure there isn't anything embarrassing hidden in the middle of text. 
"""

flipper.storage.write.start(file)

time.sleep(2)

flipper.storage.write.send(text_one)

text_two = """All the Lorem Ipsum generators on the Internet tend to repeat predefined chunks as 
necessary, making this the first true generator on the Internet.
 It uses a dictionary of over 200 Latin words, combined with a handful of 
 model sentence structures, to generate Lorem Ipsum which looks reasonable. 
The generated Lorem Ipsum is therefore always free from repetition, injected humour, or non-characteristic words etc.
"""
flipper.storage.write.send(text_two)

time.sleep(3)

# Не забудьте остановить
flipper.storage.write.stop()

# Установить общий светодиод (r,b,g,bl)
flipper.led.set(led='r', value=255)

# Выключить синий светодиод
flipper.led.blue(value=0)

# Установить значение зелёного светодиода
flipper.led.green(value=175)

# Включить подсветку
flipper.led.backlight_on()

# Выключить подсветку
flipper.led.backlight_off()

# Выключить все светодиоды
flipper.led.off()

# Включить/выключить вибро (True или False)
flipper.vibro.set(True)

# Включить вибро
flipper.vibro.on()

# Выключить вибро
flipper.vibro.off()

# Установить режим GPIO: 0 - вход, 1 - выход
flipper.gpio.mode(pin_name=PIN_NAME, value=1)

# Установить значение пина GPIO: 0 - выкл, 1 - вкл
flipper.gpio.set(pin_name=PIN_NAME, value=1)

# Прочитать значение пина GPIO
flipper.gpio.read(pin_name=PIN_NAME)

# Воспроизвести песню в формате RTTTL
rttl_song = "Littleroot Town - Pokemon:d=4,o=5,b=100:8c5,8f5,8g5,4a5,8p,8g5,8a5,8g5,8a5,8a#5,8p,4c6,8d6,8a5,8g5,8a5,8c#6,4d6,4e6,4d6,8a5,8g5,8f5,8e5,8f5,8a5,4d6,8d5,8e5,2f5,8c6,8a#5,8a#5,8a5,2f5,8d6,8a5,8a5,8g5,2f5,8p,8f5,8d5,8f5,8e5,4e5,8f5,8g5"

# Воспроизвести в цикле
flipper.music_player.play(rtttl_code=rttl_song)

# Остановить цикл
flipper.music_player.stop()

# Воспроизвести 20 секунд
flipper.music_player.play(rtttl_code=rttl_song, duration=20)

# Пикнуть
flipper.music_player.beep()

# Пикнуть 5 секунд
flipper.music_player.beep(duration=5)

# Определить тип метки -> {'protocols': ['Mifare Classic'], 'raw': '...'} или None
tag = flipper.nfc.scan(timeout=5)

# Включить поле NFC на несколько секунд
flipper.nfc.field(timeout=3)

# Отправить APDU (ISO14443-4 / ISO15693-3); протокол определяется автоматически, если опущен
resp = flipper.nfc.apdu(["00A4 04 00", "A0 00"], protocol="14_4a")

# Отправить сырые байты с добавлением CRC
flipper.nfc.raw("93 20", protocol="14a", crc=True)

# Утилиты для Mifare Ultralight
info = flipper.nfc.mfu_info()
block4 = flipper.nfc.mfu_read_block(4)
flipper.nfc.mfu_write_block(4, "00 01 02 03")

# Эмулировать сохранённый .nfc файл
flipper.nfc.emulate(file="/ext/nfc/mycard.nfc", timeout=10)

# Загрузить ключи из родного .nfc дампа в кэш ключей для данного UID
uid, cache_path = flipper.nfc.import_nfc_keys("/path/to/card.nfc")

# Теперь CLI dump может прочитать карту (токены протоколов: mfc, mfu, 14_4a, ...)
flipper.nfc.dump(protocol="mfc", file="/ext/nfc/card_dump.nfc")

# Синхронно, таймаут по умолчанию 5 секунд

# Чтение RFID
rfid = flipper.rfid.read()

# Эмуляция RFID
emulated = flipper.rfid.emulate(key_type="EM4100", key_data="5500824806")

# Запись RFID
written = flipper.rfid.write(key_type="EM4100", key_data="5500824806")

# Передать hex_key N раз (по умолчанию count=10, device=0 -> CC1101_INT, 1 -> CC1101_EXT)
flipper.subghz.tx(hex_key="DEADBEEF", frequency=433920000, count=5, device=0)

# Приём (по умолчанию frequency=433920000 device=0 raw=False timeout=5 секунд)
received = flipper.subghz.rx(frequency=433920000, device=0, raw=True, timeout=10)

# Повтор записанной передачи
flipper.subghz.tx_from_file("/ext/subghz/foo.sub")

# Декодировать сырой .sub файл
decoded = flipper.subghz.decode_raw(sub_file="/ext/subghz/foo.sub")

# Список протоколов, поддерживаемых подключённой прошивкой (читается в реальном времени из `ir help`)
protocols = flipper.ir.protocols()

# Передать hex_address и hex_command с выбором протокола
flipper.ir.tx(protocol="Samsung32", hex_address="C000FFEE", hex_command="DEADBEEF")

# NECext теперь поддерживается (список протоколов читается из прошивки, не захардкожен)
flipper.ir.tx(protocol="NECext", hex_address="EF00", hex_command="FD02")

# Примеры сырой передачи
flipper.ir.tx_raw(frequency=38000, duty_cycle=0.33, samples=[1337, 8888, 3000, 5555])

# Синхронно, таймаут по умолчанию 5 секунд
# Приём сигнала
r = flipper.ir.rx(timeout=10)

# Чтение (таймаут по умолчанию 5 секунд)
ikey = flipper.ikey.read()

# Запись (таймаут по умолчанию 5 секунд)
flipper.ikey.write(key_type="Dallas", key_data="DEADBEEFCOOOFFEE")

# Эмуляция (таймаут по умолчанию 5 секунд)
flipper.ikey.emulate(key_type="Dallas", key_data="DEADBEEFCOOOFFEE")

# Подключить регистратор событий (таймаут по умолчанию 10 секунд)
logs = flipper.log.attach()

# Включить режим отладки (выполняет `sysctl debug 1` на текущей прошивке)
flipper.debug.on()

# Выключить режим отладки
flipper.debug.off()

# Поиск
response = flipper.onewire.search()

# Получить
response = flipper.i2c.get()

# Дампинг ввода
dump = flipper.input.dump()

# Отправить ввод
flipper.input.send("up", "press")

# Всё (тесты с оборудованием пропускаются сами, если Flipper не подключён)
python -m unittest discover -s tests -p "test_*.py" -v

# Только тесты без оборудования
python -m unittest tests.test_serial_wrapper tests.test_commands -v