常用關鍵字介紹
- Add Port
參數：【port_locator | open=True | make_current=False | **kwargs】
說明：添加端口
Port_locator：端口號
Open：默認為True表示激活狀態，False表示禁用狀態
Make_current：默認為False，如果為True真值，則打開的端口設置為通用的端口使用
舉例：
結果：
Starting test: Demo.Serial.Demo.Add Port
20200214 15:53:08.110 : INFO : ${ret} = Serial<id=0x31bc860, open=False>(port=u'COM1', baudrate=38400, bytesize=8, parity='N', stopbits=1, timeout=1.0, xonxoff=False, rtscts=False, dsrdtr=False)
Ending test: Demo.Serial.Demo.Add Port
- Switch Port
參數：【port_locator】
說明：切換端口
切換當前指定的端口進行操作
舉例：
備注：當環境存在多個串口連接DUT設備，如特殊情況需要切換到其它端口時，進行切換端口。
- List Com Port Names
參數：無
說明：返回當前環境端口名
舉例：
結果：
- List Com Port
參數：無
說明：返回當前端口條目信息
舉例：
結果：
- Set Encoding
參數：【encoding=None】
說明：設置編碼
默認是以16進制形式輸出，如需要從串口輸出字符展示，則設置為utf-8
舉例：
結果：
- Write Data
參數：【data | encoding=None | port_locator=None】
說明：在指定串口發送指令數據
舉例：從串口獲取接口的MAC保存在變量。
結果：
備注：先發送指令，然后再使用Read All Data讀取所有的數據保存在緩存變量里，最后通過字符處理方式截取MAC地址。
- Write File Data
參數：【file_or_path | offset =0| length=-1 | port_locator】
說明：讀取指定文件內容向串口下發數據
Length默認為-1表示則讀取當前輸入文件位置之后的所有內容，否則，將從輸入文件中讀取指定字節數。
舉例：
比如文本文件內容為ifconfig eth0，讀取文件內容默認從0位置開始讀取
結果：
- Com Port Should Exist Regexp
參數：【regexp】
說明：查找匹配的COM端口
如果在系統上找不到與給定模式匹配的com端口，則失敗。如果存在的話，則返回與模式匹配的COM端口列表。
舉例：
結果：
- Port Should Be Open & Closed
參數：無
說明：檢查串口開啟/關閉狀態
比如想要知道COM2串口當前是打開還是關閉狀態，當COM2是打開狀態，則返回通過，表示COM2是打開狀態；否則當前COM2是關閉狀態
舉例：
結果：
- Read All And Log
參數：【loglevel='debug', encoding=None, port_locator=None】
說明：讀取所有可用數據並將其寫入日志
Loglevel可以是“info”、“debug”或“warn”（不區分大小寫）。
任何其他級別都會導致錯誤。如果未指定“encoding”，則使用默認編碼。
如果日志設置為debug級別，則正常數據不會打印出來。Warn級別會輸出錯誤或警告信息。
舉例：
結果：
- Read Data Should Be
參數：[ data | encoding=None | port_locator=None ]
說明：如果從端口讀取的所有字節都不等於指定的數據，則失敗
Data :讀取的數據以16進制輸出
【備注：此關鍵字不常用，一般特殊情況校驗數據字節碼用到】
舉例：
結果：
- Read Until
參數：[ terminator= | size=None | encoding=None | port_locator=None ]
說明：讀取數據，直到找到終止符、超出大小或超時。
terminator：終止符。循環讀取數據時，直到找到預期的字符就停止讀取，把讀到的數據存入緩存
size：緩存大小。按指定的緩存大小范圍內讀取預期的字符。
encodig：字符編碼
port_locator：端口號
舉例：
結果：
- Delete Port
參數：[ port_locator=None ]
說明：刪除指定的端口號
如果端口已打開，則它將關閉。默認情況下，將刪除當前端口，並選擇最近添加的端口作為新的當前端口。刪除庫實例中的最后一個端口會將當前端口設置為“無”。如果找不到指定的端口，則失敗；如果將當前端口設置為“無”，則嘗試刪除該端口
舉例：
結果：
- Delete All Ports
參數：[]
說明：刪除庫實例中維護的所有端口
打開的端口在刪除前關閉。
舉例：
結果：
- Read All Data
參數：[ encoding=None | port_locator=None ]
說明：從端口的傳入緩沖區讀取所有可用數據。
舉例：
結果：
- Get Port Parameter
參數：[ param_name | port_locator=None ]
說明：
默認情況下，檢查當前端口。可用參數是可以在庫導入或添加端口關鍵字時設置的參數：波特率、字節大小、奇偶校驗、停止位、超時、xonxoff、rtscts、寫入超時、dsrdtr和內部字節超時。
在錯誤的參數名或端口定位器上失敗。
舉例：
結果：
