eFLL (嵌入式模糊逻辑库) 技术文档

1. 安装指南

通用安装方式

步骤 1： 访问 eFLL 官方 GitHub 项目页面。

步骤 2： 使用 Git 克隆项目，或者点击“下载为 zip”按钮下载。

步骤 3： 将克隆或解压缩的文件移动到某个文件夹中，并建议将文件夹重命名为“eFLL”。

步骤 4： 编译并将库链接到您的代码中（参考 Makefile）。

Arduino 安装与导入

简单方法

步骤 1： 打开 Arduino IDE。

步骤 2： 在主菜单中，选择“草图” >> “包含库” >> “管理库”。

步骤 3： 搜索“eFLL”或“Fuzzy”。

步骤 4： 在列表中找到 eFLL，点击“安装”完成。现在您可以在草图（sketches）中包含 eFLL。

旧方法

步骤 1： 访问 eFLL 官方 GitHub 项目页面。

步骤 2： 使用 Git 克隆项目，或者点击“下载为 zip”按钮下载。

步骤 3： 将克隆或解压缩的文件移动到 Arduino 库文件夹中：

• Ubuntu：（/usr/share/arduino/libraries/），如果是通过 apt-get 安装的；
• Windows、Mac 或 Linux：（Arduino IDE 下载位置，库文件夹位于 Arduino IDE 内部）。

完成！库已准备好使用！

如果库安装成功，导入库非常简单：

步骤 4： 打开 Arduino IDE，在顶部菜单中选择“草图” >> “库” >> “导入 eFLL”。

2. 项目使用说明

项目使用 C++/C 语言编写，仅使用标准 C 语言库 "stdlib.h"。eFLL 库不仅适用于 Arduino，还适用于任何使用 C 语言编写的嵌入式系统。

它没有对模糊集、模糊规则、输入或输出的显式限制，这些限制取决于每个微控制器的处理能力和存储空间。

eFLL 使用以下流程进行推理和组合：（MAX-MIN）和（Mamdani 最小），以及（面积中心）进行去模糊化。

已使用 GTest 进行测试。

3. 项目 API 使用文档

以下是一些主要对象的简要说明：

• Fuzzy 对象：包含整个模糊系统，通过它，您可以操作模糊集合、语言规则、输入和输出。
• FuzzyInput 对象：将属于同一域的所有输入模糊集合分组。
• FuzzyOutput 对象：类似于 FuzzyInput，用于分组属于同一域的所有输出模糊集合。
• FuzzySet 对象：是模糊库的主要对象之一，每个集合都可以用来建模所研究的系统。当前库支持三角、梯形和单点隶属度函数，这些函数基于点 A、B、C 和 D 构建而成，它们作为参数传递给构造函数 FuzzySet(float a, float b, float c, float d)。
• FuzzyRule 对象：用于构建 Fuzzy 对象的基本规则，包含一个或多个此类对象。使用 FuzzyRule fr = new FuzzyRule (ID, antecedent, consequent) 实例化。
• FuzzyRuleAntecedent 对象：用于组合 FuzzyRule 对象，负责构建模糊规则的先决条件部分。
• FuzzyRuleConsequent 对象：用于呈现 FuzzyRule 对象，负责构建输出表达式。

以下是一些方法：

• bool setInput(int id, float value); 用于将 crisp 输入值传递给系统，注意第一个参数是 FuzzyInput 对象的 ID，该参数值是预期的。
• bool fuzzify(); 用于启动模糊化过程、组合和推理。
• float defuzzify(int id); 用于去模糊化。

4. 项目安装方式

请参考上述“安装指南”部分进行项目安装。