release shielded twisted pair

2026-05-20 10:23:01 -07:00 · 2020-12-04 15:37:11 +08:00
parent b23dbf9176
commit 5536058f45
13 changed files with 420 additions and 17 deletions
@@ -2,6 +2,8 @@

 <el-tag effect="plain">SKU:A088</el-tag>

+<div class="product_pic"><img src="assets/img/product_pics/accessory/24awg_cable/24awg_cable_01.webp"><img src="assets/img/product_pics/accessory/24awg_cable/24awg_cable_02.webp"></div>
+
 ## Description

 **24AWG 4-CORE Shielded Cable** is a STP(shielded twisted pair) cable that is commonly used for data communications. The aluminium foil and woven layer wrapping inside can effectively reduce signal interference and enhance the stability of communication lines. It is suitable for ordinary serial communication, and standard communication bus construction such as RS485, RS232, CAN, etc.
@@ -32,6 +34,11 @@
    - Outer cover: TPE, black, OD: 5.0
    - Wire, plug and mechanical characteristics requirements MAX; contact pull-out force: 50g MIN

+
+## Applications
+
+- Communication Line
+
 ## Specification

 <table>
@@ -57,10 +64,11 @@
   </tr>
 </table>

+<img src="assets/img/product_pics/accessory/24awg_cable/24awg_cable_03.webp">

 <script>

-   var purchase_link = 'https://m5stack.com/collections/m5-accessory/products/4pin-buckled-grove-cable';
+   var purchase_link = 'https://m5stack.com/products/24awg-4-core-shielded-twisted-pair-cable';

   anchor_search(purchase_link);
   scrollFunc();
@@ -0,0 +1,192 @@
+# RTC
+
+```
+typedef struct RTC_Time
+{
+    int8_t Hours;
+    int8_t Minutes;
+    int8_t Seconds;
+    RTC_Time() : Hours(),Minutes(),Seconds(){}
+    RTC_Time(int8_t h,int8_t m,int8_t s) : Hours(h),Minutes(m),Seconds(s){}
+} RTC_TimeTypeDef;
+
+typedef struct RTC_Date
+{
+    int8_t WeekDay;
+    int8_t Month;
+    int8_t Date;
+    int16_t Year;
+    RTC_Date() : WeekDay(),Month(),Date(),Year(){}
+    RTC_Date(int8_t w,int8_t m,int8_t d, int16_t y) : WeekDay(w),Month(m),Date(d),Year(y){}
+} RTC_DateTypeDef;
+```
+
+## SetTime()
+
+**Syntax:**
+
+`void SetTime(RTC_TimeTypeDef* RTC_TimeStruct)`
+
+**Description:**
+
+Set RTC Time Struct
+
+## GetTime()
+
+**Syntax:**
+
+`void GetTime(RTC_TimeTypeDef* RTC_TimeStruct)`
+
+**Description:**
+
+Get RTC Time Struct
+
+## SetDate()
+
+**Syntax:**
+
+`void SetDate(RTC_TimeTypeDef* RTC_DateStruct)`
+
+**Description:**
+
+Set RTC Date Struct
+
+
+## GetDate()
+
+**Syntax:**
+
+`void GetDate(RTC_TimeTypeDef* RTC_DateStruct)`
+
+**Description:**
+
+Get RTC Date Struct
+
+**Example:**
+
+```
+#include <M5Core2.h>
+
+RTC_TimeTypeDef RTCtime;
+RTC_DateTypeDef RTCDate;
+
+char timeStrbuff[64];
+
+void flushTime(){
+    M5.Rtc.GetTime(&RTCtime);
+    M5.Rtc.GetDate(&RTCDate);
+    
+    sprintf(timeStrbuff,"%d/%02d/%02d %02d:%02d:%02d",
+                        RTCDate.Year,RTCDate.Month,RTCDate.Date,
+                        RTCtime.Hours,RTCtime.Minutes,RTCtime.Seconds);
+                                         
+    M5.lcd.setCursor(10,100);
+    M5.Lcd.println(timeStrbuff);
+}
+
+void setupTime(){
+  
+  RTCtime.Hours = 23;
+  RTCtime.Minutes = 33;
+  RTCtime.Seconds = 33;
+  M5.Rtc.SetTime(&RTCtime);
+  
+  RTCDate.Year = 2020;
+  RTCDate.Month = 11;
+  RTCDate.Date = 6;
+  M5.Rtc.SetDate(&RTCDate);
+}
+
+void setup() {
+
+  M5.begin();
+  setupTime();
+}
+
+void loop() {
+  flushTime();
+  delay(1000);
+}
+
+```
+
+## shutdown()
+
+### function overload-1:
+
+Power off and wake up again via PWR button
+
+`void shutdown();`
+
+### function overload-2:
+
+Turn off the power and wake up the device via RTC at the end of the delay based on the number of seconds of incoming delay.
+
+`int shutdown( int seconds );`
+
+### function overload-3:
+
+Turn off the power, pass in the RTC time structure that specifies a certain point in time, and wake up the device via RTC when the `hours`, `minutes`, and `seconds` of that time are met.
+
+`int shutdown( const RTC_TimeTypeDef &RTC_TimeStruct);`
+
+### function overload-4:
+
+Turn off the power, pass in the RTC time structure specified for a certain point in time, and wake up the device by RTC when the `week number`, `day number`, and `time` of that point in time match at the same time.
+
+`int shutdown( const RTC_DateTypeDef &RTC_DateStruct, const RTC_TimeTypeDef &RTC_TimeStruct);`
+
+**Example:**
+
+```
+#include <M5Core2.h>
+
+RTC_TimeTypeDef RTCtime;
+RTC_TimeTypeDef RTCtime_Now;
+
+char timeStrbuff[64];
+
+void setup()
+{
+  M5.begin(true,true,true,true);
+
+  RTCtime.Hours = 10;
+  RTCtime.Minutes = 30;
+  RTCtime.Seconds = 45;
+
+  M5.Lcd.setCursor(0,80);
+  M5.Lcd.println("");
+  M5.Lcd.println("BtnA:  shutdown, use power button to turn back on");
+  M5.Lcd.println("");
+  M5.Lcd.println("BtnB:  shutdown, wake up after 5 seconds");
+  M5.Lcd.println("");
+  M5.Lcd.println("BtnC:  shutdown, wake up at RTC Time 10:30:45");
+}
+
+void loop()
+{
+
+  M5.update();
+
+  if(M5.BtnA.wasPressed())
+  { 
+    M5.shutdown();
+  }
+  if(M5.BtnB.wasPressed())
+  {
+    M5.shutdown(5);
+  }
+  if(M5.BtnC.wasPressed())
+  {
+    M5.shutdown(RTCtime);
+  }
+
+  M5.Lcd.setCursor(0,140);
+  M5.Rtc.GetTime(&RTCtime_Now);
+  sprintf(timeStrbuff,"RTC Time Now is %02d:%02d:%02d",
+         RTCtime_Now.Hours,RTCtime_Now.Minutes,RTCtime_Now.Seconds);
+  M5.Lcd.println(timeStrbuff);
+
+}
+
+```
@@ -127,22 +127,22 @@ Set RTC Time Struct

 Get RTC Time Struct

-## SetData()
+## SetDate()

 **Syntax:**

-`void SetData(RTC_TimeTypeDef* RTC_DateStruct)`
+`void SetDate(RTC_TimeTypeDef* RTC_DateStruct)`

 **Description:**

 Set RTC Date Struct


-## GetData()
+## GetDate()

 **Syntax:**

-`void GetData(RTC_TimeTypeDef* RTC_DateStruct)`
+`void GetDate(RTC_TimeTypeDef* RTC_DateStruct)`

 **Description:**

@@ -162,7 +162,7 @@ char timeStrbuff[64];

 void flushTime(){
    M5.rtc.GetTime(&RTCtime);
-    M5.rtc.GetData(&RTCDate);
+    M5.rtc.GetDate(&RTCDate);
    
    sprintf(timeStrbuff,"%d/%02d/%02d %02d:%02d:%02d",
                        RTCDate.Year,RTCDate.Month,RTCDate.Date,
@@ -182,7 +182,7 @@ void setupTime(){
  RTCDate.Year = 2020;
  RTCDate.Month = 11;
  RTCDate.Date = 6;
-  M5.rtc.SetData(&RTCDate);
+  M5.rtc.SetDate(&RTCDate);
 }

 void setup() {
@@ -66,6 +66,7 @@ const m5core2_api = {
    'AXP192':'#/en/api/axp192_core2',
    'TFT-SCREEN':'#/en/api/lcd',
    'TOUCH':'#/en/api/touch',
+    'RTC':'#/en/api/core2/rtc_api'
  },
  "id":"m5core2_api"
 };
@@ -247,7 +247,8 @@

   const accessory_list = [
      //Accessory
-      {a:"/#/en/accessory/converter/grove_t", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/grove_t_01.webp", p:"Grove-T", sku:"U039" ,kw:"CONNECTOR", category:"Accessory"},
+      {a:"/#/en/accessory/cable/24awg_cable", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/24awg_cable_01.webp", p:"Shielded twisted pair", sku:"A088" ,kw:"cable rs485 can uart", category:"Accessory"},
+      {a:"/#/en/accessory/converter/grove_t", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/grove_t_01.webp", p:"Grove-T", sku:"U039" ,kw:"CONNECTOR"},
      {a:"/#/en/accessory/cable/grove_cable", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/grove_cable_01.webp", p:"Grove Cable", sku:"A034" ,kw:"CABLE"},
      {a:"/#/en/accessory/converter/grove2grove", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/acs_g2g_01.webp", p:"GROVE2GROVE", sku:"A040" ,kw:"CONNECTOR"},
      {a:"/#en/accessory/cable/lego_cable", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/lego_cable.webp", p:"LEGO Cable", sku:"A030" ,kw:"CABLE"},
@@ -247,7 +247,8 @@

   const accessory_list = [
      //Accessory
-      {a:"/#/zh_CN/accessory/converter/grove_t", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/grove_t_01.webp", p:"Grove-T", sku:"U039" ,kw:"CONNECTOR", category:"Accessory"},
+      {a:"/#/zh_CN/accessory/cable/24awg_cable", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/24awg_cable_01.webp", p:"Shielded twisted pair", sku:"A088" ,kw:"cable rs485 can uart", category:"Accessory"},
+      {a:"/#/zh_CN/accessory/converter/grove_t", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/grove_t_01.webp", p:"Grove-T", sku:"U039" ,kw:"CONNECTOR"},
      {a:"/#/zh_CN/accessory/cable/grove_cable", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/grove_cable_01.webp", p:"Grove Cable", sku:"A034" ,kw:"CABLE"},
      {a:"/#/zh_CN/accessory/converter/grove2grove", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/acs_g2g_01.webp", p:"GROVE2GROVE", sku:"A040" ,kw:"CONNECTOR"},
      {a:"/#zh_CN/accessory/cable/lego_cable", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/accessory/lego_cable.webp", p:"LEGO Cable", sku:"A030" ,kw:"CABLE"},
@@ -2,9 +2,11 @@

 <el-tag effect="plain">SKU:A088</el-tag>

+<div class="product_pic"><img src="assets/img/product_pics/accessory/24awg_cable/24awg_cable_01.webp"><img src="assets/img/product_pics/accessory/24awg_cable/24awg_cable_02.webp"></div>
+
 ## 描述

-**24AWG 4-CORE Shielded Cable**是一款对绞线屏蔽线缆，常用于数据通信线路搭建。内部包裹的铝箔与编织层能够有效减少信号干扰，增强通信线路的稳定性。适用于普通串行通信，以及RS485，RS232, CAN等标准的通信总线搭建。
+**24AWG 4-CORE Shielded Cable**是一款双绞线屏蔽线缆，常用于数据通信线路搭建。内部包裹的铝箔与编织层能够有效减少信号干扰，增强通信线路的稳定性。适用于普通串行通信，以及RS485，RS232, CAN等标准的通信总线搭建。

 ## 产品特性

@@ -32,6 +34,10 @@
   - 外被：TPE，黑色，OD：5.0
   - 线材、插头及机械特性的要求 MAX；接触拔出力：50g MIN

+## 应用
+
+- 通信线路搭建
+
 ## 规格参数

 <table>
@@ -57,10 +63,11 @@
   </tr>
 </table>

+<img src="assets/img/product_pics/accessory/24awg_cable/24awg_cable_03.webp">

 <script>

-   var purchase_link = 'https://m5stack.com/collections/m5-accessory/products/4pin-buckled-grove-cable';
+   var purchase_link = 'https://m5stack.com/products/24awg-4-core-shielded-twisted-pair-cable';

   anchor_search(purchase_link);
   scrollFunc();
@@ -0,0 +1,192 @@
+# RTC
+
+```
+typedef struct RTC_Time
+{
+    int8_t Hours;
+    int8_t Minutes;
+    int8_t Seconds;
+    RTC_Time() : Hours(),Minutes(),Seconds(){}
+    RTC_Time(int8_t h,int8_t m,int8_t s) : Hours(h),Minutes(m),Seconds(s){}
+} RTC_TimeTypeDef;
+
+typedef struct RTC_Date
+{
+    int8_t WeekDay;
+    int8_t Month;
+    int8_t Date;
+    int16_t Year;
+    RTC_Date() : WeekDay(),Month(),Date(),Year(){}
+    RTC_Date(int8_t w,int8_t m,int8_t d, int16_t y) : WeekDay(w),Month(m),Date(d),Year(y){}
+} RTC_DateTypeDef;
+```
+
+## SetTime()
+
+**函数原型:**
+
+`void SetTime(RTC_TimeTypeDef* RTC_TimeStruct)`
+
+**函数参数:**
+
+设置结构体变量时间
+
+## GetTime()
+
+**函数原型:**
+
+`void GetTime(RTC_TimeTypeDef* RTC_TimeStruct)`
+
+**函数参数:**
+
+获取结构体时间
+
+## SetDate()
+
+**函数原型:**
+
+`void SetDate(RTC_TimeTypeDef* RTC_DateStruct)`
+
+**函数参数:**
+
+设置结构体变量日期
+
+## GetDate()
+
+**函数原型:**
+
+`void GetDate(RTC_TimeTypeDef* RTC_DateStruct)`
+
+**函数参数:**
+
+获取结构体变量日期
+
+**使用示例:**
+
+```
+#include <M5Core2.h>
+
+RTC_TimeTypeDef RTCtime;
+RTC_DateTypeDef RTCDate;
+
+char timeStrbuff[64];
+
+void flushTime(){
+    M5.Rtc.GetTime(&RTCtime);
+    M5.Rtc.GetDate(&RTCDate);
+    
+    sprintf(timeStrbuff,"%d/%02d/%02d %02d:%02d:%02d",
+                        RTCDate.Year,RTCDate.Month,RTCDate.Date,
+                        RTCtime.Hours,RTCtime.Minutes,RTCtime.Seconds);
+                                         
+    M5.lcd.setCursor(10,100);
+    M5.Lcd.println(timeStrbuff);
+}
+
+void setupTime(){
+  
+  RTCtime.Hours = 23;
+  RTCtime.Minutes = 33;
+  RTCtime.Seconds = 33;
+  M5.Rtc.SetTime(&RTCtime);
+  
+  RTCDate.Year = 2020;
+  RTCDate.Month = 11;
+  RTCDate.Date = 6;
+  M5.Rtc.SetDate(&RTCDate);
+}
+
+void setup() {
+
+  M5.begin();
+  setupTime();
+}
+
+void loop() {
+  flushTime();
+  delay(1000);
+}
+```
+
+
+## shutdown()
+
+### 函数重载1:
+
+关闭电源，再次启动需要通过PWR按键唤醒
+
+`void shutdown();`
+
+### 函数重载2:
+
+关闭电源，根据传入的延时秒数，在延时结束后通过RTC唤醒设备。
+
+`int shutdown( int seconds );`
+
+### 函数重载3:
+
+关闭电源，传入指定了某个时间点的RTC时间结构体，当符合该时间的`时`,`分`,`秒`的时候通过RTC唤醒设备。
+
+`int shutdown( const RTC_TimeTypeDef &RTC_TimeStruct);`
+
+### 函数重载4:
+
+关闭电源，传入指定了某个时间点的RTC时间结构体，当同时符合该时间点的`周数`,`天数`,`时间`的时通过RTC唤醒设备。
+
+`int shutdown( const RTC_DateTypeDef &RTC_DateStruct, const RTC_TimeTypeDef &RTC_TimeStruct);`
+
+
+**使用示例:**
+
+```
+#include <M5Core2.h>
+
+RTC_TimeTypeDef RTCtime;
+RTC_TimeTypeDef RTCtime_Now;
+
+char timeStrbuff[64];
+
+void setup()
+{
+  M5.begin(true,true,true,true);
+
+  RTCtime.Hours = 10;
+  RTCtime.Minutes = 30;
+  RTCtime.Seconds = 45;
+
+  M5.Lcd.setCursor(0,80);
+  M5.Lcd.println("");
+  M5.Lcd.println("BtnA:  shutdown, use power button to turn back on");
+  M5.Lcd.println("");
+  M5.Lcd.println("BtnB:  shutdown, wake up after 5 seconds");
+  M5.Lcd.println("");
+  M5.Lcd.println("BtnC:  shutdown, wake up at RTC Time 10:30:45");
+}
+
+void loop()
+{
+
+  M5.update();
+
+  if(M5.BtnA.wasPressed())
+  { 
+    M5.shutdown();
+  }
+  if(M5.BtnB.wasPressed())
+  {
+    M5.shutdown(5);
+  }
+  if(M5.BtnC.wasPressed())
+  {
+    M5.shutdown(RTCtime);
+  }
+
+  M5.Lcd.setCursor(0,140);
+  M5.Rtc.GetTime(&RTCtime_Now);
+  sprintf(timeStrbuff,"RTC Time Now is %02d:%02d:%02d",
+         RTCtime_Now.Hours,RTCtime_Now.Minutes,RTCtime_Now.Seconds);
+  M5.Lcd.println(timeStrbuff);
+
+}
+
+```
@@ -129,22 +129,22 @@ typedef struct RTC_Date
 获取结构体时间


-## SetData()
+## SetDate()

 **函数原型:**

-`void SetData(RTC_TimeTypeDef* RTC_DateStruct)`
+`void SetDate(RTC_TimeTypeDef* RTC_DateStruct)`

 **函数参数:**

 设置结构体变量日期


-## GetData()
+## GetDate()

 **函数原型:**

-`void GetData(RTC_TimeTypeDef* RTC_DateStruct)`
+`void GetDate(RTC_TimeTypeDef* RTC_DateStruct)`

 **函数参数:**

@@ -164,7 +164,7 @@ char timeStrbuff[64];

 void flushTime(){
    M5.rtc.GetTime(&RTCtime);
-    M5.rtc.GetData(&RTCDate);
+    M5.rtc.GetDate(&RTCDate);
    
    sprintf(timeStrbuff,"%d/%02d/%02d %02d:%02d:%02d",
                        RTCDate.Year,RTCDate.Month,RTCDate.Date,
@@ -184,7 +184,7 @@ void setupTime(){
  RTCDate.Year = 2020;
  RTCDate.Month = 11;
  RTCDate.Date = 6;
-  M5.rtc.SetData(&RTCDate);
+  M5.rtc.SetDate(&RTCDate);
 }

 void setup() {
@@ -65,6 +65,7 @@ const m5core2_api = {
    'AXP192':'#/zh_CN/api/axp192_core2',
    'TFT-SCREEN':'#/zh_CN/api/lcd',
    'TOUCH':'#/zh_CN/api/touch',
+    'RTC':'#/zh_CN/api/core2/rtc_api'
  },
  "id":"m5core2_api"
 };