# 小樱nfc鸟头杖_总repo

**Repository Path**: TiX233/sakura_nfc_repo

## Basic Information

- **Project Name**: 小樱nfc鸟头杖_总repo
- **Description**: 小樱nfc鸟头杖_总repo
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-03-17
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小樱 nfc 鸟头杖总 repo

目录：

- [小樱 nfc 鸟头杖总 repo](#小樱-nfc-鸟头杖总-repo)
  - [〇、仓库说明](#〇仓库说明)
    - [1、repo 介绍](#1repo-介绍)
    - [2、本项目使用方法](#2本项目使用方法)
    - [3、不想使用 repo？](#3不想使用-repo)
  - [一、项目介绍](#一项目介绍)
  - [二、项目原理](#二项目原理)

## 〇、仓库说明

这里是本项目的主仓库，采用 repo 管理，存放除硬件外的一切  
硬件开源连接：[【立创】小樱nfc鸟头杖](https://oshwhub.com/realtix/sakura_nfc)

### 1、repo 介绍

[【CSDN】repo 简单搭建学习记录](https://blog.csdn.net/realTiX/article/details/142501192)  
[【CSDN】windows 下 repo 安装](https://blog.csdn.net/weixin_42107504/article/details/140709590)

### 2、本项目使用方法

**repo 初始化**  

```shell
repo init -u https://gitee.com/TiX233/sakura_nfc_repo -b master -m manifest.xml
```

**repo 同步**  

```shell
repo sync
```

### 3、不想使用 repo？

那么逐个手动克隆下列仓库即可：  

* [小樱 nfc 鸟头杖总 repo](https://gitee.com/TiX233/sakura_nfc_repo.git)
* [小樱 nfc 鸟头杖 stm32 程序](https://gitee.com/TiX233/sakura_nfc_stm32.git)
* [小樱 nfc 鸟头杖 控制器 程序](https://gitee.com/TiX233/sakura_nfc_ctrl.git)

## 一、项目介绍

鸟头杖靠近对应卡牌后即会播放对应语音并遥控对应设备。

## 二、项目原理

仅需通过在卡牌第二扇区第零个块中写入如下信息即可让法杖控制对应设备：  

```c
/* 卡片存储数据格式，第二扇区第零块
0:      0x25
1:      库洛牌 ID
2:      0x68
3:      0x25
4~5:    受控设备 mesh 地址，2 Byte，大端
6:      发送给受控设备的自定义数据，1 Byte
7:      指定音频文件夹，1 Byte
8:      指定音频序号，1 Byte
9:      0x68
*/
```

以上内容可以使用法杖通过 `/card` 命令进行配置，法杖在检测到符合格式的卡牌后，便会根据卡牌中指定的消息接收对象和控制信息将内容转发到指定的控制器，增加受控设备无需对法杖进行重新编程，只需在新添加的卡牌中写入相关信息即可。  

法杖语音：仅需使用 Type-c 线将法杖连接到电脑后，会识别出来一个 U盘设备，将音频复制到其中即可。  

控制器：一般只根据卡牌 ID 来决定所要执行的操作，如果需要自定义新的受控设备，可以仿照控制器仓库里的程序复制出一个新的工程，修改 maddr 等等信息，使之与新自定义的卡牌存储的信息对应。