From ebce34f049893af6cbaba9c86ae60ad347c22d92 Mon Sep 17 00:00:00 2001
From: lt <1370582156@qq.com>
Date: Thu, 26 Sep 2024 17:54:29 +0800
Subject: [PATCH] addde the files of nl50 nad nlcs11 sensor

---
 docs/sensors/sensors/rus_04.md                |   4 +-
 .../sensors/temperature_sensor_nl50.md        |  67 ++++++++++++
 .../temperature_sensor_nl50/nl50_example.zip  | Bin 0 -> 1938 bytes
 .../smart_modules/color_recognition_nlcs11.md | 100 ++++++++++++++++++
 .../nlcs11_example.zip                        | Bin 0 -> 2742 bytes
 mkdocs.yml                                    |   2 +
 6 files changed, 171 insertions(+), 2 deletions(-)
 create mode 100644 docs/sensors/sensors/temperature_sensor_nl50.md
 create mode 100644 docs/sensors/sensors/temperature_sensor_nl50/nl50_example.zip
 create mode 100644 docs/sensors/smart_modules/color_recognition_nlcs11.md
 create mode 100644 docs/sensors/smart_modules/color_recognition_nlcs11/nlcs11_example.zip

diff --git a/docs/sensors/sensors/rus_04.md b/docs/sensors/sensors/rus_04.md
index 6235bae..7986e07 100644
--- a/docs/sensors/sensors/rus_04.md
+++ b/docs/sensors/sensors/rus_04.md
@@ -35,10 +35,10 @@
 
 ## 模块结构图
 
-### RUS-04（蓝色款）尺寸图
+### RUS-04（蓝色款）和HC-04（普通款）尺寸图
 
 ​													![RGB](rus_04/rus_04_blue_cad.png) 
-### RUS-04（蓝色款）尺寸图
+### RUS-04（黑色款、蓝色款）尺寸图
 ![RUS-04](rus_04/rus_04_cad.png)
 
 
diff --git a/docs/sensors/sensors/temperature_sensor_nl50.md b/docs/sensors/sensors/temperature_sensor_nl50.md
new file mode 100644
index 0000000..45591a1
--- /dev/null
+++ b/docs/sensors/sensors/temperature_sensor_nl50.md
@@ -0,0 +1,67 @@
+# NL50温度传感器
+
+## 实物图
+
+
+
+
+
+
+
+## 概述
+
+NL50是由我司自主研发的温度传感器，该温度传感器是利用二极管的基本原理来测量已知温度值。随着温度的升高，二极管俩端的电压的已知的速率增加.通过精确放大电压变化，产生与环境温度成正比的电压信号,从而获取相应的温度值。
+
+因此NL50传感器具有精确度高，连接方式简单等优点。
+
+
+
+## 模块参数
+
+| 引脚名称 |         描述         |
+| :------: | :------------------: |
+|    G     |         GND          |
+|    V     |         VCC          |
+|    S     | DATA串行数据，单总线 |
+
+- 供电电压:3v3/5V
+- 连接方式:4PIN防反接杜邦线
+- 模块尺寸:40 x 22.5 mm
+- 安装方式:M4螺钉兼容乐高插孔固定
+
+
+
+## Arduino示例程序
+
+```c
+/**
+ * @example read_temperature.ino
+ */
+
+#include "temperature_sensor_nl50.h"
+
+namespace {
+#if defined(ARDUINO_ARCH_ESP32) || defined(ARDUINO_ARCH_ESP32S3)
+constexpr uint8_t kPin = 34;
+#elif defined(ARDUINO_ARCH_AVR)
+constexpr uint8_t kPin = A0;
+#endif
+
+emakefun::TemperatureSensorNl50 g_nl50(kPin);
+}  // namespace
+
+void setup() {
+  Serial.begin(115200);
+  Serial.println(String(F("temperature sensor NL50 lib version: ")) + emakefun::TemperatureSensorNl50::Version());
+  g_nl50.Initialize();
+  Serial.println(F("setup successful"));
+}
+
+void loop() {
+  Serial.println(String("temperature: ") + g_nl50.Read());
+  delay(100);
+}
+
+```
+
+[点击下载Arduino库以及示例程序](temperature_sensor_nl50/nl50_example.zip)
\ No newline at end of file
diff --git a/docs/sensors/sensors/temperature_sensor_nl50/nl50_example.zip b/docs/sensors/sensors/temperature_sensor_nl50/nl50_example.zip
new file mode 100644
index 0000000000000000000000000000000000000000..a1976b0b119cb2d167cc25627e262c70aaa6283f
GIT binary patch
literal 1938
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
K+5s%Q85jV+)BfQA

literal 0
HcmV?d00001

diff --git a/docs/sensors/smart_modules/color_recognition_nlcs11.md b/docs/sensors/smart_modules/color_recognition_nlcs11.md
new file mode 100644
index 0000000..3c47f0a
--- /dev/null
+++ b/docs/sensors/smart_modules/color_recognition_nlcs11.md
@@ -0,0 +1,100 @@
+# NLCS11颜色识别模块
+
+## 模块图
+
+
+
+
+
+
+
+
+
+## 概述
+
+NLCS11是一款基于颜色的光到数字的转换器，它结合了光电二极管、电流放大器、模拟电路和数字信号处理器。
+
+为了提高精度，让颜色管理更加准确。板载自带一个高亮LED，可以让传感器在低环境光的情况下依然能够正常使用，实现“补光”的功能，可以通过LED Switch开关对它进行打开或关闭。颜色识别传感器模块采用I2C通信，拥有PH2.0防反插接口，使用便利
+
+NLCS11设备可进行色温测量、亮度传感。内部状态机提供了将设备置于色温测量之间的低功率状态的能力，非常低的平均功耗。
+
+此设备可以应用于亮度传感器丶彩色温度传感器、 小笔记本、 穿戴设备、工业及医疗等领域。
+
+
+
+## 模块参数
+
+* 工作电压：3.3-5V
+* 工作电流：65uA
+* 检测距离：3-10mm
+* 时钟频率：0-400KHZ
+* 接 口：IIC接口和2.54间距接口
+* 温度范围：-30℃ ~ +70℃
+* 通信方式:  IIC通信，地址0x43
+* 尺 寸：40 * 22 mm，兼容乐高积木和M4螺丝固定孔
+
+
+
+## 引脚定义
+
+| 引脚名称 | 描述        |
+| -------- | ----------- |
+| G        | GND地线     |
+| V        | 5V电源引脚  |
+| SDA      | I2C数据引脚 |
+| SCL      | I2C时钟引脚 |
+
+
+
+## Arduino读取RGB示例函数
+
+```c
+/**
+ * @example read_rgb.ino
+ */
+
+#include "color_sensor_nlcs11.h"
+
+#define INFINITE_LOOP_ON_FAILURE InfiniteLoopOnFailure(__FUNCTION__, __LINE__)
+
+namespace {
+emakefun::ColorSensorNlcs11 g_color_sensor;
+void InfiniteLoopOnFailure(const char* function, const uint32_t line_number) {
+  Serial.println(String(F("entering an infinite loop due to failure in ")) + function + F(", at line number: ") + line_number);
+  while (true) {
+    yield();
+  }
+}
+
+}  // namespace
+
+void setup() {
+  Serial.begin(115200);
+  Serial.println(F("setup"));
+
+  Wire.begin();
+
+  Serial.println(String(F("color sensor lib version: ")) + emakefun::ColorSensorNlcs11::kVersionMajor + "." +
+                 emakefun::ColorSensorNlcs11::kVersionMinor + "." + emakefun::ColorSensorNlcs11::kVersionPatch);
+
+  const auto ret = g_color_sensor.Initialize();
+
+  if (emakefun::ColorSensorNlcs11::kOK == ret) {
+    Serial.println(F("color sensor initialization successful"));
+  } else {
+    Serial.println(String(F("color sensor device initialization failed: ")) + ret);
+    INFINITE_LOOP_ON_FAILURE;
+  }
+
+  Serial.println(F("setup successful"));
+}
+
+void loop() {
+  const auto color = g_color_sensor.GetColor();
+  Serial.println(String("r: ") + color.r + ", g: " + color.g + ", b: " + color.b);
+  delay(50);
+}
+```
+
+[点击下载Arduino库以及示例程序](color_recognition_nlcs11/nlcs11_example.zip)
+
diff --git a/docs/sensors/smart_modules/color_recognition_nlcs11/nlcs11_example.zip b/docs/sensors/smart_modules/color_recognition_nlcs11/nlcs11_example.zip
new file mode 100644
index 0000000000000000000000000000000000000000..c2493c77cd415acf43f352ef3b8e1fd4036142b0
GIT binary patch
literal 2742
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

literal 0
HcmV?d00001

diff --git a/mkdocs.yml b/mkdocs.yml
index 5dacf13..f32d589 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -66,6 +66,7 @@ nav:
           - 五路循迹传感器v2.0: sensors/sensors/five_way_tracking_sensor_v2.0.md
           - 五路循迹传感器v3.0: sensors/sensors/five_line_tracker_v3/five_line_tracker_v3.md
           - RGB超声波传感器: sensors/sensors/rus_04.md
+          
 
       - 执行器:
           - 有源蜂鸣器模块: sensors/actuators/buzzerModel.md
@@ -108,6 +109,7 @@ nav:
           - 语音合成模块: sensors/smart_modules/text_to_speech_synthesizer.md
           - I2C扩展板模块: sensors/smart_modules/gpio_expansion_board.md
           - RFID-I2C模块: sensors/smart_modules/RFID-I2C.md
+          - NLCS11颜色识别传感器: sensors/smart_modules/NLCS11.md
       - 电源模块:
           - 3.7V升压充电模块: sensors/power_module/3.7v_battery_module.md
           - 7.4V充电电池模块: sensors/power_module/16340_2s_li_battery_module.md