qFlipper
qflipper 是一款桌面应用,用于更新 flipper zero 的固件和数据库、管理 microsd 卡上的文件,以及修复损坏的固件。qflipper 支持 windows、macos 和 linux。 本页将概要介绍这款应用,并说明如何把它安装到你的电脑上。你还会学到如何更新和控制 flipper zero,以及如何反馈 qflipper 的问题。 安装 qflipper 要在电脑上安装 qflipper 应用,请执行以下操作: 下载适用于你操作系统的 qflipper 安装文件。 你也可以从 flipper zero 固件更新 https //flipper net/pages/downloads 页面下载 qflipper。 运行下载好的文件,并按你操作系统对应的说明操作。 在 windows 上,qflipper 应用 仅兼容 windows 10 和 11 。 qflipper 应用兼容 macos 10 14 及更高版本 ,并针对 apple silicon 机型做了优化 。 在 linux 上,qflipper 以 appimage 格式 下载。在 linux 上运行该应用之前,你需要先给它添加可执行权限: 使用图形界面 在文件管理器中,右键点击下载好的文件。 转到 properties > permissions 。 如果你用的是基于 nautilus 的文件管理器(files、nemo、caja),请勾选 allow executing file as program ;如果你用的是 dolphin,请勾选 is executable ;如果你用的是 pcmanfm,请把 execute 下拉列表改为 anyone 。 关闭该对话框。 双击 appimage 文件即可运行。 使用终端 打开终端。 切换到存放 appimage 文件的目录。 给 appimage 添加可执行权限: chmod +x filename appimage 。 运行 appimage: /filename appimage 。 设置 udev 规则 通过图形界面或终端给应用添加可执行权限后,你还需要设置 udev 规则,才能以普通用户身份使用 qflipper: /qflipper x86 64 appimage rules install \[/optional/path/to/rules/dir] qflipper:概览 在电脑上安装好 qflipper 应用之后,请 用 usb 线把 flipper zero(已插入 microsd 卡)连接到电脑 。 在 device information 标签页中,你可以查看 flipper zero 硬件和已安装固件的主要信息、 更新固件 https //docs flipper net/zero/zh/qflipper#qflipper flipper zero ,以及 远程控制 flipper zero https //docs flipper net/zero/zh/qflipper#qflipper flipper zero 1 。 在 advanced controls 标签页中,你可以备份、恢复和重置 flipper zero,也可以选择要安装到设备上的固件。与 device information 标签页一样,你也可以在这里控制 flipper zero 并启动更新流程。要了解备份和恢复流程的更多信息,请参阅 内部存储修复 https //docs flipper net/zero/zh/basics/firmware update/storage repair 。 在 file manager 标签页中,你可以删除、重命名文件,以及把文件上传到 flipper zero。你可以用键盘方向键方便地浏览文件。 如何使用 qflipper 上传文件 要把文件上传到 flipper zero,请在 file manager 标签页中,把文件拖放到目标文件夹,或者右键点击目标文件夹并点击 upload here 。 只用键盘就可以在 file manager 标签页中方便地操作: 操作 %windows%windows 和 %linux%linux 上的按键 %mac%macos 上的按键 进入 return return 返回 backspace backspace 上传 ctrl+l command+l 下载 ctrl+d command+d 删除 delete fn+backspace 立即删除 shift+delete shift+fn+backspace 新建文件夹 ctrl+n command+n 重命名 ctrl+e command+e 刷新视图 ctrl+g command+g 通过 qflipper 更新 flipper zero 固件 qflipper 应用有三个固件更新通道: \<font color="#ff4500"> development (dev): \</font> 开发工作会随着每次新提交持续构建新版本固件,通常每天多次。该 development 版本包含所有最新功能,但可能不稳定,会导致卡死、数据损坏,甚至完全无法工作。 \<font color="#8a2be2"> release candidate (rc): \</font> 提交给 qa 部门做验证测试的版本。如果测试阶段发现问题,该版本会被修订,并发布新的 release candidate。一旦某个 release candidate 通过全部测试,它就会成为 release 版本。 \<font color="#32cd32"> release: \</font> 固件的稳定版本,经过充分测试以确保可靠性,因此推荐一般用户使用。 要通过 qflipper 应用更新 flipper zero,请执行以下操作: 用 usb 线把 flipper zero 连接到电脑。 在电脑上运行 qflipper 应用。 在 qflipper 应用中,切换到 advanced controls 标签页。 点击 update channel ,从下拉列表中选择固件版本( 推荐选择 release )。 点击 update 开始更新流程。 通过 qflipper 控制 flipper zero 你也可以按以下步骤,通过 qflipper 应用远程控制 flipper zero: 在 device information 标签页中,点击 flipper zero 的图像。 点击屏幕上的按钮 或者 用键盘远程控制 flipper zero。点击 ℹ️ 可了解键盘操作的更多信息。 此外,你还可以点击 save screenshot 按钮,从 flipper zero 截取屏幕截图并直接保存到电脑上。 反馈 qflipper 问题 如果更新过程中出现错误,请详细描述该问题,这对我们很重要。由于我们不会从你的电脑收集任何使用数据和统计信息,你需要自己在论坛上反馈问题: 在 forum flipperzero one https //forum flipperzero one/ https //forum flipperzero one/ 网站上,进入 firmware update / qflipper 板块。 浏览已有帖子,看看该问题是否在之前的帖子中已经处理过。 如果此前没有人提到过,请点击 new topic 按钮创建新帖。 在新帖中描述你的问题,以及导致该问题的操作步骤。 附上 txt 格式的 qflipper 日志,然后点击 create topic 按钮。 要获取本次会话的 qflipper 日志,请执行以下操作: 在 qflipper 应用中,点击 logs 。 点击 open full log ,把打开的文件以 txt 格式保存到电脑上。 qflipper 会在你的电脑上保存最近 100 次会话的日志,方便你查阅过往的问题记录。要获取上一次会话的 qflipper 日志,请执行以下操作: 在 qflipper 应用中,点击 logs 。 在显示当前会话日志的区域上点击右键。 在打开的右键菜单中,点击 browse all logs 。 在打开的文件夹中,注意文件名中的时间戳,选择你需要的日志文件。 qflipper 在 windows 上出现问题?请查看下面的页面: windows 驱动故障排查 https //docs flipper net/zero/zh/qflipper/windows debug