doc: 更新示例

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Samples/WebSerials.razor

@@ -67,6 +67,26 @@ private ISerialService? SerialService { get; set; }</Pre>
             <div class="col-12">
                 <Button IsDisabled="CheckClose" OnClick="Write" Text="@Localizer["WriteButtonText"]"></Button>
             </div>
+            <div class="col-12 col-sm-6">
+                <Checkbox Value="_ring" ShowAfterLabel="true" DisplayText="RING"></Checkbox>
+                <Checkbox Value="_dsr" ShowAfterLabel="true" DisplayText="DSR" class="ms-3"></Checkbox>
+            </div>
+            <div class="col-12 col-sm-6">
+                <Checkbox Value="_cts" ShowAfterLabel="true" DisplayText="CTS"></Checkbox>
+                <Checkbox Value="_dcd" ShowAfterLabel="true" DisplayText="DCD" class="ms-3"></Checkbox>
+            </div>
+            <div class="col-12">
+                <Button IsDisabled="CheckClose" OnClick="GetSignals" Text="@Localizer["GetSignalsButtonText"]"></Button>
+            </div>
+            <div class="col-12 col-sm-6">
+                <Display Value="@_usbInfo?.UsbVendorId" ShowLabel="true" DisplayText="VendorId"></Display>
+            </div>
+            <div class="col-12 col-sm-6">
+                <Display Value="@_usbInfo?.UsbProductId" ShowLabel="true" DisplayText="ProductId"></Display>
+            </div>
+            <div class="col-12">
+                <Button IsDisabled="CheckClose" OnClick="GetInfo" Text="@Localizer["GetInfoButtonText"]"></Button>
+            </div>
         </div>
     </GroupBox>
 </DemoBlock>
@@ -90,7 +110,7 @@ if (SerialService.IsSupport == false)
 
 <ul class="ul-demo">
     <li>如果需要读取数据，请先设置 <code>ISerialPort</code> 实例 <code>DataReceive</code> 参数</li>
-    <li>调用 <code>ISerialPort</code> 实例方法 <code>Open</code> 打开串口，可通过参数设置 <code>波特率</code> 等信息</li>
+    <li>调用 <code>ISerialPort</code> 实例方法 <code>Open</code> 打开串口，可通过 <code>SerialPortOptions</code> 参数设置 <code>波特率</code> 等信息</li>
 </ul>
 
 <Pre>private async Task OpenPort()

src/BootstrapBlazor.Server/Components/Samples/WebSerials.razor.cs

@@ -48,7 +48,7 @@ public partial class WebSerials : IAsyncDisposable
 
     private ISerialPort? _serialPort;
 
-    private readonly SerialOptions _serialOptions = new();
+    private readonly SerialPortOptions _serialOptions = new();
 
     private bool CheckOpen => _serialPort is not { IsOpen: false };
 
@@ -149,6 +149,38 @@ private static byte[] ConvertToHex(string data)
         return [.. ret];
     }
 
+    private SerialPortSignals? _signals;
+
+    private bool _ring => _signals?.RING ?? false;
+
+    private bool _dsr => _signals?.DSR ?? false;
+
+    private bool _dcd => _signals?.DCD ?? false;
+
+    private bool _cts => _signals?.CTS ?? false;
+
+    private async Task GetSignals()
+    {
+        if (_serialPort == null)
+        {
+            return;
+        }
+
+        _signals = await _serialPort.GetSignals();
+    }
+
+    private SerialPortUsbInfo? _usbInfo;
+
+    private async Task GetInfo()
+    {
+        if (_serialPort == null)
+        {
+            return;
+        }
+
+        _usbInfo = await _serialPort.GetUsbInfo();
+    }
+
     private async ValueTask DisposeAsync(bool disposing)
     {
         if (disposing)

src/BootstrapBlazor.Server/Locales/en-US.json

@@ -6323,7 +6323,9 @@
     "NotSupportSerialTitle": "Get Port",
     "NotSupportSerialContent": "The current browser does not support serial port operations. Please change to Edge or Chrome browser.",
     "OpenPortSerialTitle": "Open Port",
-    "OpenPortSerialContent": "Failed to open the serial port"
+    "OpenPortSerialContent": "Failed to open the serial port",
+    "GetSignalsButtonText": "Signals",
+    "GetInfoButtonText": "Infos"
   },
   "BootstrapBlazor.Server.Components.Samples.MindMaps": {
     "MindMapTitle": "Mind Map",

src/BootstrapBlazor.Server/Locales/zh-CN.json

@@ -6323,7 +6323,9 @@
     "NotSupportSerialTitle": "申请串口权限",
     "NotSupportSerialContent": "当前浏览器不支持串口操作，请更换 Edge 或者 Chrome 浏览器",
     "OpenPortSerialTitle": "打开串口操作",
-    "OpenPortSerialContent": "打开串口失败"
+    "OpenPortSerialContent": "打开串口失败",
+    "GetSignalsButtonText": "串口参数",
+    "GetInfoButtonText": "USB 信息"
   },
   "BootstrapBlazor.Server.Components.Samples.MindMaps": {
     "MindMapTitle": "Mind Map 思维导图",