C SerialPort 控制項屬性及用法

2021-09-05 01:26:30 字數 4926 閱讀 8204

屬性:portname 串列埠名 預設值com1

串列埠對於作業系統來說是乙個檔案,如果設定portname為本機不存在的串列埠名(即檔名),如「com7」或「comk」,open()開啟串列埠將失敗,提示「埠com7不存在」。

baudrate 獲取或設定序列波特率bit/s 預設值9600

位元率=波特率x單個調製狀態對應的二進位制位數。

rs232是要用在近距離傳輸上最大距離為30m

rs485用在長距離傳輸最大距離1200m

databits 獲取或設定每個位元組的標準資料位長度 預設值8

當計算機傳送乙個資訊包,實際的資料不會是8位的,標準的值是5、7和8位。如何設定取決於你想傳送的資訊。比如,標準的ascii碼是0~127(7位)。擴充套件的ascii碼是0~255(8位)。如果資料使用簡單的文字(標準 ascii碼),那麼每個資料報使用7位資料。每個包是指乙個位元組,包括開始/停止位,資料位和奇偶校驗位。由於實際資料位取決於通訊協議的選取,術語「包」指任何通訊的情況。

stopbits 獲取或設定每個位元組的標準停止位數 預設值one

用於表示單個包的最後一位。典型的值為1,1.5和2位。由於資料是在傳輸線上定時的,並且每乙個裝置有其自己的時鐘,很可能在通訊中兩台裝置間出現了小小的不同步。因此停止位不僅僅是表示傳輸的結束,並且提供計算機校正時鐘同步的機會。適用於停止位的位數越多,不同時鐘同步的容忍程度越大,但是資料傳輸率同時也越慢。

parity 獲取或設定奇偶校驗檢查協議 預設值none

在串列埠通訊中一種簡單的檢錯方式。有四種檢錯方式:偶、奇、高和低。當然沒有校驗位也是可以的。對於偶和奇校驗的情況,串列埠會設定校驗位(資料位後面的一位),用乙個值確保傳輸的資料有偶個或者奇個邏輯高位。例如,如果資料是011,那麼對於偶校驗,校驗位為0,保證邏輯高的位數是偶數個。如果是奇校驗,

校驗位位1,這樣就有3個邏輯高位。高位和低位不真正的檢查資料,簡單置位邏輯高或者邏輯低校驗。這樣使得接收裝置能夠知道乙個位的狀態,有機會判斷是否有雜訊干擾了通訊或者是否傳輸和接收資料是否不同步。

parityreplace 獲取或設定乙個位元組,該位元組在發生奇偶校驗錯誤時替換資料流中的無效位元組 預設值63(?)

readbuffersize 獲取或設定 serialport 輸入緩衝區的大小 預設值4096

readbuffersize 屬性忽略任何小於 4096 的值??由於 readbuffersize 屬性只表示 windows 建立的緩衝區,而 bytestoread 屬性除了表示 windows 建立的緩衝區外還表示 serialport 緩衝區,所以 bytestoread 屬性可以返回乙個比 readbuffersize 屬性大的值。

readtimeout 獲取或設定讀取操作未完成時發生超時之前的毫秒數 預設值-1

確切的說readtimeout設定了read(outbuf, offset, count)超時等待的時間,即如果接收緩衝區一直沒有資料,則read()等待readtimeout毫秒後甩timeoutexception異常。但是在readtimeout期間,只要有乙個資料,則read()立馬返回,而不是等待count個位元組資料。readtimeout不是為了read()阻塞等待count個位元組,那它有什麼意義?

receivedbytesthreshold 獲取或設定 datareceived 事件發生前內部輸入緩衝區中的位元組數 預設值1

如果緩衝區一次性有4個位元組資料,那麼datareceived事件是觸發1次還是4次?

writebuffersize 獲取或設定串列埠輸出緩衝區的大小 預設值2048

readbuffersize 屬性忽略任何小於 4096 的值。

由於 readbuffersize 屬性僅表示 windows 建立的緩衝區,所以它可以返回比 bytestoread屬性小的值,這表示 serialport 和 windows 建立的緩衝區。

wreitetimeout 獲取或設定寫入操作未完成時發生超時之前的毫秒數 預設值-1

寫入超時值在 win32 通訊 api 中最初被設定為 500 毫秒。此屬性允許您設定此值。此值可以設定為 0 以立即從寫入操作返回,或設定為任意正值,也可以設定為預設的 infinitetimeout。此屬性不影響 basestream 的 beginwrite 方法。

bytestoread 獲取接收緩衝區中資料的位元組數

由於 readbuffersize 屬性只表示 windows 建立的緩衝區,而 bytestoread 屬性除了表示 windows 建立的緩衝區外還表示 serialport 緩衝區,所以 bytestoread 屬性可以返回乙個比 readbuffersize 屬性大的值。

bytestowrite 獲取傳送緩衝區中資料的位元組數

newline 獲取或設定用於解釋 readline( )和writeline( )方法呼叫結束的值 預設值「\n」

discardnull 獲取或設定乙個值,指示 null 位元組在埠和接收緩衝區之間傳輸時是否被忽略 預設值false

正常情況下,特別是對於二進位制傳輸而言,此值應該設定為 false。將此屬性設定為 true 會使 utf32 和 utf16 編碼位元組產生意外結果。

handshake 獲取或設定串列埠資料傳輸的握手協議 預設值none

使用握手時,將指示連線到 serialport 物件的裝置在緩衝區中至少有 (readbuffersize-1024) 個位元組時停止傳送資料。當緩衝區中的位元組數小於等於 1024 時,將指示裝置重新開始傳送資料。如果裝置在大於 1024 個位元組的塊中傳送資料,可能會導致緩衝區溢位。

如果將 handshake 屬性設定為 requesttosendxonxoff 並將 ctsholding 設定為 false,則不會傳送 xoff 字元。如果後來將 ctsholding 設定為 true,則必須傳送更多的資料後才會傳送 xoff 字元。

encodeing 獲取或設定傳輸前後文字轉換的位元組編碼 預設為 asciiencoding

asciiencoding 不提供錯誤檢測。出於安全原因,建議您使用 utf8encoding、unicodeencoding 或 utf32encoding 並啟用錯誤檢測。

asciiencoding 僅支援 u+0000 和 u+007f之間的 unicode 字元值。因此,utf8encoding、unicodeencoding 和 utf32encoding 可以更好地適應全球化的應用程式。

dtrenable 獲取或設定乙個值,該值在序列通訊過程中啟用資料終端就緒 (dtr) 訊號 預設值 false

在 xon/xoff 軟體握手、請求傳送/可以傳送 (rts/cts) 硬體握手和數據機通訊的過程中通常啟用資料終端就緒 (dtr)。

rtsenable 獲取或設定乙個值,該值指示在序列通訊中是否啟用請求傳送 (rts) 訊號 預設值false

請求傳送 (rts) 訊號通常用在請求傳送/可以傳送 (rts/cts) 硬體握手中。

cdholding 獲取埠的載波檢測行的狀態

此屬性可用於監視埠的載波檢測行的狀態。無載波通常表明接收方已結束通話且載波已被丟棄。

ctsholding 獲取「可以傳送」行的狀態

在請求傳送/可以傳送 (rts/cts) 硬體握手中使用可以傳送 (cts) 行。傳送資料之前埠會查詢 cts 行。

dsrholding 獲取資料設定就緒 (dsr) 訊號的狀態

在資料設定就緒/資料終端就緒 (dsr/dtr) 握手中使用此屬性。通常由數據機將資料設定就緒 (dsr) 訊號傳送到埠,以表明它已經為資料傳輸或資料接收做好準備。

buffersize 值1024

maxdatabits 值8

mindatabits 值5

serial_name 值\device\serial

事件:

datareceive事件 資料接收事件的方法

不保證對接收到的每個位元組引發 datareceived 事件。 使用 bytestoread 屬性確定緩衝區中剩餘的要讀取的資料量。從 serialport 物件接收資料時,將在輔助線程上引發 datareceived 事件。

pinchanged事件 序列管腳更改事件的方法

在 serialport 物件進入 breakstate 時引發,但在埠退出 breakstate 時不引發。將在輔助線程上引發 pinchanged 事件。

errorreceived事件 錯誤事件的方法

如果在流的尾位元組上出現奇偶校驗錯誤,將向輸入緩衝區新增乙個值為 126 的額外位元組。將在輔助線程上引發 errorreceived事件。

方法:open() 開啟乙個新的串列埠連線

close() 關閉埠連線,將 isopen 屬性設定為 false,並釋放內部 stream 物件

read(byte, int, int) 輸入緩衝區讀取一些位元組並將那些位元組寫入位元組陣列中指定的偏移量處

readbyte() 從 serialport 輸入緩衝區中同步讀取乙個位元組

readchar() 從 serialport 輸入緩衝區中同步讀取乙個字元

readexisting() 在編碼的基礎上,讀取 serialport 物件的流和輸入緩衝區中所有立即可用的位元組

readline() 一直讀取到輸入緩衝區中的 newline 值

readto() 一直讀取到輸入緩衝區中的指定 value 的字串

write(string) 將指定的字串寫入串列埠

write(byte, int, int) 使用緩衝區的資料將指定數量的字元寫入串列埠

writeline() 將指定字串和newline值寫入輸出緩衝區

discardinbuffer() 丟棄接收緩衝區的資料

discardoutbuffer() 丟棄傳送緩衝區的資料

static getportnanes() 獲取當前計算機的串列埠名稱陣列

C SerialPort常用的屬性和方法

basestream 獲取 serialport 物件的基礎 stream 物件 baudrate 獲取或設定序列波特率 breakstate 獲取或設定中斷訊號狀態 bytestoread 獲取接收緩衝區中資料的位元組數 bytestowrite 獲取傳送緩衝區中資料的位元組數 cdholding...

C serialport控制項的一些理解

readtimeout 1000 writetimeout 1000 1 用途 2 用法 當你的程式在視窗傳送一幀資料 所謂一幀是指由多個位元組組成的有邏輯意義的資料 過程中檢測到串列埠傳送錯誤,如果讓串列埠繼續發生就沒有意義了,這個時候可以用serialport.discardoutbuffer方...

CSerialPort串列埠操作

最近要寫乙個串列埠程式,用mfc自帶com元件的效果很差 一次接收乙個緩衝區的資料,沒辦法像寫嵌入式程式那樣單位元組就能觸發中斷接收那樣 所以進行了一些研究,發現了乙個第三方串列埠類很強大,效果非常好。程式設計環境 vs2008 建立乙個基於對話方塊的mfc應用程式,我在這裡是serialportt...