跳到主要内容
KernelSU 模块

Galaxy Watch NFC Provide

不可变 Release 已同步

Editable device NFC configuration for KernelSU and BakaSU on Wear OS devices.

介绍

Galaxy Watch NFC Provide

English | 简体中文

A KernelSU/BakaSU systemless module for making the device's existing NFC configuration editable. It keeps the device's original files backed up, does not hard-code a UID, and does not replace the NFC service.

The module has been tested successfully on a Galaxy Watch 7 44mm. It is designed for Wear OS devices in general, but other watch models and vendors still require their own compatibility checks.

Module ID:

galaxy_watch_nfc_provide

Install

  1. Download the ZIP for the version you need from the GitHub Releases page. A release asset looks like:

    galaxy_watch_nfc_provide-v1.0.8.zip
    
  2. Install the ZIP in KernelSU or BakaSU.

  3. Disable the older nfc_reader_unlock module if it is installed.

  4. Reboot the device so the module overlays are mounted.

Magic Mount-rs manages the overlays and their removal. This module does not remount firmware partitions or create its own bind mounts.

Configuration Files

The module creates editable copies of the configuration files below when they exist:

/data/adb/modules/galaxy_watch_nfc_provide/system/vendor/etc/libnfc-nxp.conf
/data/adb/modules/galaxy_watch_nfc_provide/system/etc/nfc_rule_configs.xml

Original files are kept under:

/data/adb/galaxy_watch_nfc_provide/config/
/data/adb/galaxy_watch_nfc_provide/routing/

Write changes in place. Do not replace a file with mv or sed -i; Magic Mount-rs binds the existing inode. Upgrades preserve the currently visible configuration.

Apply Configuration Changes

After changing libnfc-nxp.conf or nfc_rule_configs.xml, reinitialize NFC so the running service reads the new values:

su -c 'cmd nfc disable-nfc'
sleep 2
su -c 'cmd nfc enable-nfc'

Installing or upgrading the module still requires a reboot to mount new overlays. Reinitializing NFC does not prove that a physical tag UID or a wallet application will work.

Check the Installation

These commands perform read-only checks of the configuration, mounts, and NFC service:

su -c '/data/adb/modules/galaxy_watch_nfc_provide/verify.sh'
su -c '/data/adb/modules/galaxy_watch_nfc_provide/nfcconf status'

Optional UID Tool

The UID tool is read-only unless you explicitly run a mutating command:

su -c '/data/adb/modules/galaxy_watch_nfc_provide/uidctl probe'
su -c '/data/adb/modules/galaxy_watch_nfc_provide/uidctl get'
su -c '/data/adb/modules/galaxy_watch_nfc_provide/uidctl status'

Experimental commands accept a four-byte hexadecimal UID:

su -c '/data/adb/modules/galaxy_watch_nfc_provide/uidctl set AABBCCDD'
su -c '/data/adb/modules/galaxy_watch_nfc_provide/uidctl persist AABBCCDD'
su -c '/data/adb/modules/galaxy_watch_nfc_provide/uidctl reset'

Do not run these commands during wallet or other NFC activity. The module saves a device-derived baseline and rejects unsafe UID operations when the vendor configuration hash changes. It does not implement MIFARE Classic storage, keys, or authentication.

Build and Test

Local builds require JDK 17, Android SDK Platform 36, and Build Tools 36.0.0:

python tools/build_module.py
python tools/test_core.py
python tools/test_routing.py

Local output is written to dist/: the module ZIP, its SHA-256 file, and build-report.json. These generated files are ignored by Git. Source module scripts live in scripts/; the builder places the required runtime entry points at the module ZIP root.

GitHub Releases

GitHub Actions checks pushes to master, pull requests, and manual runs. The workflow reads the version from module.prop and automatically adds the v prefix:

module.prop: version=1.0.8
Git tag:      v1.0.8

For a non-PR run, the workflow first checks whether Release v1.0.8 already exists. If it does not exist, the workflow builds the module, creates tag v1.0.8 on the current commit, and publishes a GitHub Release. You do not need to create the release tag manually. If the Release already exists, the workflow leaves it unchanged.

The workflow publishes these release assets:

galaxy_watch_nfc_provide-v1.0.8.zip
galaxy_watch_nfc_provide-v1.0.8.zip.sha256
build-report.json

Pull requests only run validation and never create tags or releases. The workflow does not upload GitHub Actions Artifacts. Release files are managed by GitHub and are not committed under releases/ or dist/.

License

Licensed under the GNU General Public License version 3 or later. See LICENSE.

历史版本

透明度

Tag
v1.0.8 不可变 Release
Tag commit
34c8b0fed3cd
内容 commit
34c8b0fed3cd
SHA-256
ca8418092ff7c662d03334017ceafbfc9f3b19485d12e5f207bf50a27eb2a6b0
最近同步到变更

自行复核

KernelSU 模块不对模块签名,也不审计模块代码。SHA-256 只证明下载内容与本索引一致。可使用 GitHub CLI 自行复核:

gh release verify v1.0.8 -R gohj99/galaxy_watch_nfc_provide
gh release verify-asset v1.0.8 galaxy_watch_nfc_provide-v1.0.8.zip -R gohj99/galaxy_watch_nfc_provide