$ 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()

# GPIO ヘッダーの 5V OTG ピンを切り替え
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")

# バックアップ .tar ファイルから Flipper を復元
flipper.update.restore(bak_tar_file="/ext/backup.tar")

# インストール済みアプリの一覧
apps = flipper.loader.list()

# アプリを起動
flipper.loader.open(app_name="Clock")

# フリッパーの日付を取得（datetime オブジェクト）
date = flipper.date.datetime()

# フリッパーのタイムスタンプを取得
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 = 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()

# 汎用 LED を設定（r, b, g, bl）
flipper.led.set(led='r', value=255)

# 青 LED をオフ
flipper.led.blue(value=0)

# 緑 LED の値を設定
flipper.led.green(value=175)

# バックライトをオン
flipper.led.backlight_on()

# バックライトをオフ
flipper.led.backlight_off()

# LED をすべてオフ
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` ヘルプから動的に読み取り）
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