hobbylab.jp Software プログラミング Python LibrarySerial

apply_settings()	baudrate	BAUDRATES
break_condition	bytesize	BYTESIZES
cancel_read()	cancel_write()	cd
close()	cts	dsr
dsrdtr	dtr	fileno()
flush()	get_settings()	in_waiting()
inter_byte_timeout	is_open	name
nonblocking()	open()	PARITIES
parity	port	read()
read_until()	readable()	readinto(b)
readline()	readlines()	reset_input_buffer()
reset_output_buffer()	rs485_mode	ri
rts	rtscts	rtsToggle
seekable()	send_break()	set_input_flow_control()
set_output_flow_control()	stopbits	STOPBITS
timeout	writable()	write(data)
write_timeout	writelines()	xonxoff

非推奨であり、将来のリリースで削除される予定です。

applySettingsDict()	flowControlOut()	flushInput()
flushOutput()	getCD()	getCTS()
getDSR()	getRI()	getSettingsDict()
interCharTimeout	inWaiting()	isOpen()
outWaiting()	portstr	sendBreak()
setBreak()	setDTR()	setRTS()
setXON()	writeTimeout

__init__()

__init__(port=None, baudrate=9600, bytesize=EIGHTBITS, parity=PARITY_NONE, stopbits=STOPBITS_ONE, timeout=None, xonxoff=False, rtscts=False, write_timeout=None, dsrdtr=False, inter_byte_timeout=None, exclusive=None)

Parameters:
読み取りタイムアウト値を秒単位で設定します。

port	デバイス名または None
baudrate (int)	9600 や 115200 などのボーレート。
bytesize	データビット数。可能な値: FIVEBITS、SIXBITS、SEVENBITS、EIGHTBITS
parity	パリティチェックを有効にします。可能な値: PARITY_NONE、PARITY_EVEN、PARITY_ODD PARITY_MARK、PARITY_SPACE
stopbits	ストップビット数。可能な値: STOPBITS_ONE、STOPBITS_ONE_POINT_FIVE、STOPBITS_TWO
timeout (float)
xonxoff (bool)	ソフトウェアフロー制御を有効にします。
rtscts (bool)	ハードウェア (RTS/CTS) フロー制御を有効にします。
dsrdtr (bool)	ハードウェア (DSR/DTR) フロー制御を有効にします。
write_timeout (float)	書き込みタイムアウト値を秒単位で設定します。
inter_byte_timeout (float)	文字間タイムアウト。無効にする場合は None (デフォルト)
exclusive (bool)	排他アクセスモードを設定します (POSIX のみ)。ポートがすでに排他アクセスモードで開いている場合は、そのポートを排他アクセスモードで開くことはできません。

発生する例外:

ValueError	パラメータが範囲外の場合 (ボーレート、データビットなど) に発生します。
SerialException	デバイスが見つからないか、構成できない場合に発生します。

ポートが指定されると、オブジェクトの作成時にポートがすぐに開かれます。ポートが None の場合は開かれず、open() への連続呼び出しが必要です。

port はデバイス名です。オペレーティングシステムによって異なります。たとえば、GNU/Linux では /dev/ttyUSB0、Windows では COM3 です。

パラメータ baudrate は、標準値のいずれかになります: 50、75、110、134、150、200、300、600、1200、1800、2400、4800、9600、19200、38400、57600、115200。これらはすべてのプラットフォームで適切にサポートされています。

115200 を超える標準値 (230400、460800、500000、576000、921600、1000000、1152000、1500000、2000000、2500000、3000000、3500000、4000000 など) も、多くのプラットフォームやデバイスで動作します。

一部のプラットフォーム (GNU/Linux、MAC OSX >= Tiger、Windows) では、非標準値もサポートされています。ただし、これらのプラットフォームでも、一部のシリアルポートでは非標準値が拒否される場合があります。

read() の動作を制御するパラメータ timeout の可能な値:

timeout = None: 永久に待機 / 要求されたバイト数が受信されるまで
timeout = 0: 非ブロッキングモード、いずれの場合もすぐに戻り、要求されたバイト数まで 0 以上の値を返します
timeout = x: タイムアウトを x 秒に設定 (浮動小数点も可) 要求されたバイト数が利用可能になるとすぐに戻り、それ以外の場合はタイムアウトが切れるまで待機し、それまでに受信したすべてのバイトを返します。
write() は、write_timeout が設定されていない限り、デフォルトでブロックします。可能な値については、上記のタイムアウトのリストを参照してください。

両方のフロー制御方法 (xonxoff と rtscts) を同時に有効にすることはサポートされていない可能性があることに注意してください。一度に 1 つの方法を使用するのが一般的であり、両方を使用するのではありません。

dsrdtr はすべてのプラットフォームでサポートされているわけではありません (暗黙的に無視されます)。これを None に設定すると、その状態は rtscts に従います。

また、Serial インスタンスを直接作成する代わりに、関数 serial_for_url() を使用することも検討してください。

バージョン 2.5 での変更: dsrdtr のデフォルトが False (None ではなく) になりました

バージョン 3.0 での変更: ポート引数としての数値はサポートされなくなりました

バージョン 3.3 の新機能: 排他フラグ

　　[コマンド目次へ戻る]

close()

ポートを閉じる