Innomen/KeyMission360Tools

# KeyMission 360 工具集 [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) 一套用于 **Nikon KeyMission 360** 相机的综合工具集，提供直接的 USB/PTP 通信、SD 卡格式化、通过 gphoto2 控制相机以及完整的设备配置功能。 ## 🎯 用途 Nikon KeyMission 360 的物理控制极其有限（仅有 2 个按钮），当 SD 卡损坏或需要更改高级设置时，管理起来非常困难。此工具集提供： - **SD 卡格式化** - 通过直接 PTP 格式化命令绕过相机菜单 - **日期/时间同步** - 修正照片上的错误时间戳 - **完整的相机控制** - 通过 gphoto2 访问所有 80 多项相机设置 - **文件管理** - 下载/上传/删除文件 - **WiFi 配置** - 更改相机的 WiFi 密码和 IP 设置 - **原始 PTP 命令** - 完整的低级相机访问权限 ## 📁 仓库内容 | 文件 | 描述 | |------|-------------| | `km360_formatter.py` | 通过原始 PTP 命令格式化 SD 卡 | | `km360_set_time.py` | **将相机时间同步到系统时间**（修复 2016 年时间戳问题） | | `km360_info.py` | 显示相机信息和 PTP 端点 | | `manual_format.sh` | 手动格式化 SD 卡（无需相机） | | `GPHOTO2_COMMANDS.md` | 完整的 gphoto2 命令参考 | | `RESEARCH.md` | 技术 PTP 协议文档 | ## 🚀 快速开始 ### 前置条件 ``` # 安装 Python dependencies pip install -r requirements.txt # 安装 gphoto2 (用于高级功能) # Ubuntu/Debian: sudo apt-get install gphoto2 # Fedora: sudo dnf install gphoto2 # macOS: brew install gphoto2 ``` ### USB 权限 (Linux) 为非 root 用户访问创建 udev 规则： ``` sudo tee /etc/udev/rules.d/99-keymission360.rules << 'EOF' # Nikon KeyMission 360 SUBSYSTEM=="usb", ATTR{idVendor}=="04b0", ATTR{idProduct}=="019f", MODE="0666", GROUP="plugdev" EOF sudo udevadm control --reload-rules sudo udevadm trigger sudo usermod -a -G plugdev $USER # Log out and back in for changes to take effect ``` ## 📖 使用说明 ### 1. 修复日期/时间（最重要！） **KeyMission 360 没有 RTC 电池！** 当电池耗尽或被取出时，相机会忘记日期/时间并恢复到 2016 年。这会导致您所有照片的时间戳错误。 ``` # 将相机时间同步至电脑时间 python3 km360_set_time.py # 检查当前相机时间但不更改 python3 km360_set_time.py --check # 静默模式 (最少输出) python3 km360_set_time.py --quiet ``` **在以下情况下运行此命令：** - 装入新电池 - 看到带有 2015/2016 年时间戳的照片 - 很长一段时间未使用相机 ### 2. 格式化 SD 卡（Python 工具） 当相机界面无法操作时，这是最可靠的格式化方法： ``` # 自动检测并格式化 python3 km360_formatter.py # 仅列出存储设备 python3 km360_formatter.py --list # Format without confirmation (DANGEROUS) python3 km360_formatter.py --force ``` ### 3. 相机信息 ``` python3 km360_info.py ``` ### 3. gphoto2 命令 相机通过 gphoto2 公开了 80 多项设置。完整参考请参见 [GPHOTO2_COMMANDS.md](GPHOTO2_COMMANDS.md)。 #### 快速示例： ``` # FIX DATE/TIME FIRST (camera has no RTC battery!) python3 km360_set_time.py # OR gphoto2 --set-config datetime=now # 开始/停止视频录制 gphoto2 --set-config movie=1 # Start gphoto2 --set-config movie=0 # Stop # 更改 WiFi 密码 gphoto2 --set-config /main/other/d340=MyNewPassword # 更改相机名称 (SSID) gphoto2 --set-config /main/other/d338=MyCamera360 # 在照片中设置版权信息 gphoto2 --set-config /main/other/501f="© 2026 Your Name" # 下载所有照片 gphoto2 --get-all-files # 拍摄照片 gphoto2 --capture-image # 列出所有文件 gphoto2 --list-files ``` ## 🔧 所有可用设置 ### 操作（触发器） - `bulb` - 长曝光模式 - `autofocusdrive` - 触发自动对焦 - `movie` - 开始/停止视频录制 - `viewfinder` - 启用实时取景 - `opcode` - 发送原始 PTP 命令 ### 设置（读/写） - `datetime` - 相机日期/时间（使用 `now` 代表当前时间） - `capturetarget` - 保存到 `Internal RAM`（内存）或 `Memory card`（存储卡） - `autofocus` - 开/关 - `whitebalance` - 自动、日光、荧光灯、钨丝灯 - `movielengthlength` - 5、10、30、60 秒 - `liveviewafmode` - 人脸优先 AF 或宽区域 AF - `thumbsize` - 普通或大 - `fastfs` - 快速文件系统切换 ### 图像设置（只读） - `iso` - ISO 100-25600 - `exposurecompensation` - -2 至 +2 档 - `expprogram` - M、P、A、S、自动模式 - `shutterspeed2` - 30s 至 1/32000 ### 状态（只读） - `batterylevel` - 电池百分比 - `availableshots` - 剩余可拍摄照片数 - `serialnumber` - 相机序列号 - `deviceversion` - 固件版本 ### Nikon 供应商扩展（可写！） - `d304` - 视频拍摄模式 (0-3) - `d0a0` - 视频屏幕尺寸 (10, 20, 40, 80, 90) - `d0aa` - 风噪抑制 (0/1) - `d338` - 相机名称/SSID (文本) - `d340` - WiFi 密码 (文本！) - `d341` - WiFi 通道 (1-11) - `d342` - IP 地址 (文本) - `d343` - 子网掩码 (文本) - `d323` - 视频循环时长 (50, 100, 300, 600) - `501f` - 版权信息 (文本) ## 🛠️ 替代方案：手动 SD 卡格式化 如果您希望在没有相机的情况下格式化 SD 卡： ``` # 查找您的 SD 卡 (请小心!) lsblk # 示例: /dev/sdc DEVICE="/dev/sdc" # 卸载 sudo umount ${DEVICE}* 2>/dev/null # 创建分区表和 FAT32 分区 sudo parted -s $DEVICE mklabel msdos sudo parted -s $DEVICE mkpart primary fat32 1MiB 100% sudo partprobe $DEVICE # 使用视频最佳设置进行格式化 sudo mkfs.vfat -F 32 -s 64 -n "KM360" ${DEVICE}1 ``` 或使用包含的脚本： ``` ./manual_format.sh ``` ## ⚠️ 安全提示 - **格式化会擦除所有数据** - 格式化器有确认提示 - **仅快速格式化** - 数据可能可以通过专用工具恢复 - **电池电量** - 格式化前确保相机有电 - **WiFi 密码** - 更改 `d340` 会影响 SnapBridge 应用连接 ## 📊 相机规格 | 属性 | 值 | |----------|-------| | USB 供应商标识 | 0x04B0 (Nikon Corp.) | | USB 产品标识 | 0x019F | | 固件 | KeyMission 360 Ver.1.3 | | PTP 标准 | PIMA 15740 | | 存储标识 | 0x00000001 (内部), 0x00010001 (SD 卡) | | 视频分辨率 | 4K/24fps, 1080p/60fps 等 | | 照片分辨率 | 7744 × 3872 (30 MP) | ## 🔬 技术细节 相机支持： - **文件下载、删除、上传** - **通用图像捕获** - **Nikon Capture 3** - **实时取景** - **视频录制** 原始 PTP 格式化器使用： - `0x1002` - OpenSession - `0x1004` - GetStorageIDs - `0x100F` - FormatStore（魔术命令） 完整协议文档请参见 [RESEARCH.md](RESEARCH.md)。 ## 🐛 故障排除 ### "Camera not found"（找不到相机） - 确保相机通过 USB 连接 - 确保相机已开机（按拍照或视频按钮） - 尝试拔下并重新连接 USB - 检查 USB 权限（udev 规则） ### "Could not claim interface"（无法声明接口） - 可能另一个程序正在使用相机 - 终止冲突进程：`killall gphoto2 gvfs-gphoto2-volume-monitor` ### "Invalid Storage ID"（无效存储 ID） - 使用 `--list` 查看当前存储 ID - 尝试拔下并重新连接 ### 日期/时间恢复到 2016 年 - 相机没有 RTC 电池 - **使用时间同步工具：** `python3 km360_set_time.py` - 或手动执行：`gphoto2 --set-config datetime=now` ## 📚 延伸阅读 - [GPHOTO2_COMMANDS.md](GPHOTO2_COMMANDS.md) - 完整命令参考 - [RESEARCH.md](RESEARCH.md) - PTP 协议逆向工程 - [PTP Specification](http://www.ntfs.com/img/15740-3.pdf) - PIMA 15740 规范 - [libgphoto2](https://github.com/gphoto/libgphoto2) - gphoto2 源代码 ## 📄 许可证 MIT 许可证 - 参见 [LICENSE](LICENSE) 文件 ## 🙏 致谢 - [libgphoto2](https://github.com/gphoto/libgphoto2) 团队提供的 PTP 支持 - Nikon 提供的已文档化 PTP 协议 - KeyMission 360 社区的测试 **免责声明**：此工具与 Nikon Corporation 无关，也未受其认可。使用风险自负。

标签：gphoto2, IoT 工具, Linux 工具, PTP 协议, Python, SD 卡格式化, USB 通信, WiFi 管理, 云资产清单, 图片传输协议, 尼康 KeyMission 360, 嵌入式设备, 开源硬件, 无后门, 时间同步, 相机控制, 硬件黑客, 设备配置, 逆向工具, 逆向工程