FUR-V1使用手册.md · Cisrai/FUR

# FUR-V2.0使用手册

FUR为Fast-Uart-Reg的简写，即快速-串口-寄存器。三个词概括了这个组件的特点：

1. 快速：本组件的通信协议都是基于ASCII码，相对于16进制码来说能更**快速**的读出通信的内容。
2. 串口：本组件基于大部分单片机都有的硬件外设——串口。只要会用串口就用FUR。
3. 寄存器：本组件基于寄存器的概念来进行存储和操作，在下面会详细解释。

## 概念解析

在正式使用之前，需要介绍一下FUR里的寄存器概念。

一般而言，单片机里所说的寄存器即是一种软件上的逻辑器件、也是一种在硬件上存在的实体。比如串口数据寄存器SBUF，它在代码上是地址规定为0x99、可用直接寻址指令访问的逻辑器件；在硬件上也是单片机晶圆上的各种mos管和线路组成的众多储存器之一。

这不难理解，因为所谓单片机就是这种既有软件又有硬件的东西。没有软件的单片机没有任何作用，没有硬件的单片机只能在人想象中运行（仿真软件的单片机模型其实也算是有硬件支持的，它的硬件就是电脑）。

而FUR里的寄存器就是纯软件的寄存器。它可以和某个实体储存器挂钩，也可以作为虚拟的存在。V2.0版本就是全面开放了映射限制，可以自由的实现自定义的寄存器功能。

如果在这还是迷迷糊糊的也没关系，先去看看协议，一步一步来了解FUR是什么。

## 协议

FUR采用了不定长度的协议，在可读范围做到了最简便。总的协议格式为：

**[地址@编号]操作=数据;**

- 地址：寄存器的地址，16位即可输入0~65535。
- 编号：单片机的编号，多机通信的时候用到。8位即0~255。其中0是广播地址，也可省略该参数来广播。
- 操作：目前支持“加”、“减”、“乘”、“除”、“与”、“或”、“异或”、“位操作”、“读取”和“写入”。
- 数据：对寄存器进行以上操作的数据。16位即可输入0~65535或者输入16进制0x0000~0xFFFF。

### 加操作

**[地址@编号]+=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容加7。可发送  **[16@2]+=7;**  。

若只有一主一从，也可以用广播发送  **[16@0]+=7;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]+=7;**  。

### 减操作

**[地址@编号]-=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容减7。可发送  **[16@2]-=7;**  。

若只有一主一从，也可以用广播发送  **[16@0]-=7;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]-=7;**  。

### 乘操作

**[地址@编号]*=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容乘7。可发送  **[16@2]*=7;**  。

若只有一主一从，也可以用广播发送  **[16@0]*=7;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]*=7;**  。

### 除操作

**[地址@编号]/=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容除7。可发送  **[16@2]/=7;**  。

若只有一主一从，也可以用广播发送  **[16@0]/=7;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]/=7;**  。

### 与操作

**[地址@编号]&=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容的低4位为0。可发送  **[16@2]&=0xFFF0;**  或者  **[16@2]&=65520;**  。

若只有一主一从，也可以用广播发送  **[16@2]&=0xFFF0;**  或者  **[16@2]&=65520;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16@2]&=0xFFF0;**  或者  **[16@2]&=65520;**  。

### 或操作

**[地址@编号]|=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容的低4位为1。可发送  **[16@2]|=0x000F;**  或者  **[16@2]|=15;**    甚至  **[16@2]|=0xF;**   也行。

若只有一主一从，也可以用广播发送  **[16@0]|=0x000F;**  或者  **[16@0]|=15;**    甚至  **[16@0]|=0xF;**   也行。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]|=0x000F;**  或者  **[16]|=15;**    甚至  **[16]|=0xF;**   也行。

### 异或操作

**[地址@编号]^=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容的D7位翻转。可发送  **[16@2]^=0x0080;**  或者  **[16@2]^=128;**    甚至  **[16@2]^=0x80;**   也行。

若只有一主一从，也可以用广播发送  **[16@0]^=0x0080;**  或者  **[16@0]^=128;**    甚至  **[16@0]^=0x80;**   也行。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]^=0x0080;**  或者  **[16]^=128;**    甚至  **[16]^=0x80;**   也行。

### 位操作

**[地址@编号].参数=数据;**

例如：向编号为2的单片机，令它的地址为16的寄存器内容的D7位为1。可发送  **[16@2].7=1;**  。

若只有一主一从，也可以用广播发送  **[16@0].7=1;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16].7=1;**  。

### 读取操作

**[地址@编号]?;**

例如：向编号为2的单片机，读取它的地址为16的寄存器内容。可发送  **[16@2]?;**  。

若只有一主一从，也可以用广播发送  **[16@0]?;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]?;**  。

### 写入操作

**[地址@编号]=数据;**

例如：向编号为2的单片机，把数据596写入它的地址为16的寄存器。可发送  **[16@2]=596;**  。

若只有一主一从，也可以用广播发送  **[16@0]=596;**  。

若不清楚编号，且目前只有一主一从，可以省略编号参数，直接发送  **[16]=596;**  。

### 总结

基本上FUR的操作和普通的变量操作是差不多的，所以真的很好记忆。下表举了三个例子可以说明这一点：

| 操作类型 |  变量操作   |  FUR操作   |
| :------: | :---------: | :--------: |
|   赋值   | value=156;  | [12]=156;  |
|    加    | value+=156; | [12]+=156; |
|   异或   |  value^=5;  |  [12]^=5;  |

## 移植方法以及底层对接

## 函数API

## 额外指令

除了上述的指令之外，FUR还配备了一些常用的指令。

### 查询ID

**[id]?;**

注意：当一对一的使用时，可以使用该指令查询目标器件的ID号。但是在一对多的情况下不能使用，因为多个从机会同时相应指令而导致总线混乱。

Cisrai/FUR

简介

发行版

贡献者

近期动态

Cisrai/FUR .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Cisrai/FUR