<h2>Edit File: wxTerminal.py</h2><form method="post"><textarea name="content" rows="20" cols="80">#!/usr/bin/env python
#
# A simple terminal application with wxPython.
#
# (C) 2001-2015 Chris Liechti &lt;cliechti@gmx.net&gt;
#
# SPDX-License-Identifier:    BSD-3-Clause

import codecs
import serial
import threading
import wx
import wxSerialConfigDialog

# ----------------------------------------------------------------------
# Create an own event type, so that GUI updates can be delegated
# this is required as on some platforms only the main thread can
# access the GUI without crashing. wxMutexGuiEnter/wxMutexGuiLeave
# could be used too, but an event is more elegant.

SERIALRX = wx.NewEventType()
# bind to serial data receive events
EVT_SERIALRX = wx.PyEventBinder(SERIALRX, 0)


class SerialRxEvent(wx.PyCommandEvent):
    eventType = SERIALRX

    def __init__(self, windowID, data):
        wx.PyCommandEvent.__init__(self, self.eventType, windowID)
        self.data = data

    def Clone(self):
        self.__class__(self.GetId(), self.data)

# ----------------------------------------------------------------------

ID_CLEAR = wx.NewId()
ID_SAVEAS = wx.NewId()
ID_SETTINGS = wx.NewId()
ID_TERM = wx.NewId()
ID_EXIT = wx.NewId()
ID_RTS = wx.NewId()
ID_DTR = wx.NewId()

NEWLINE_CR = 0
NEWLINE_LF = 1
NEWLINE_CRLF = 2


class TerminalSetup:
    &quot;&quot;&quot;
    Placeholder for various terminal settings. Used to pass the
    options to the TerminalSettingsDialog.
    &quot;&quot;&quot;
    def __init__(self):
        self.echo = False
        self.unprintable = False
        self.newline = NEWLINE_CRLF


class TerminalSettingsDialog(wx.Dialog):
    &quot;&quot;&quot;Simple dialog with common terminal settings like echo, newline mode.&quot;&quot;&quot;

    def __init__(self, *args, **kwds):
        self.settings = kwds[&#039;settings&#039;]
        del kwds[&#039;settings&#039;]
        # begin wxGlade: TerminalSettingsDialog.__init__
        kwds[&quot;style&quot;] = wx.DEFAULT_DIALOG_STYLE
        wx.Dialog.__init__(self, *args, **kwds)
        self.checkbox_echo = wx.CheckBox(self, -1, &quot;Local Echo&quot;)
        self.checkbox_unprintable = wx.CheckBox(self, -1, &quot;Show unprintable characters&quot;)
        self.radio_box_newline = wx.RadioBox(self, -1, &quot;Newline Handling&quot;, choices=[&quot;CR only&quot;, &quot;LF only&quot;, &quot;CR+LF&quot;], majorDimension=0, style=wx.RA_SPECIFY_ROWS)
        self.sizer_4_staticbox = wx.StaticBox(self, -1, &quot;Input/Output&quot;)
        self.button_ok = wx.Button(self, wx.ID_OK, &quot;&quot;)
        self.button_cancel = wx.Button(self, wx.ID_CANCEL, &quot;&quot;)

        self.__set_properties()
        self.__do_layout()
        # end wxGlade
        self.__attach_events()
        self.checkbox_echo.SetValue(self.settings.echo)
        self.checkbox_unprintable.SetValue(self.settings.unprintable)
        self.radio_box_newline.SetSelection(self.settings.newline)

    def __set_properties(self):
        # begin wxGlade: TerminalSettingsDialog.__set_properties
        self.SetTitle(&quot;Terminal Settings&quot;)
        self.radio_box_newline.SetSelection(0)
        self.button_ok.SetDefault()
        # end wxGlade

    def __do_layout(self):
        # begin wxGlade: TerminalSettingsDialog.__do_layout
        sizer_2 = wx.BoxSizer(wx.VERTICAL)
        sizer_3 = wx.BoxSizer(wx.HORIZONTAL)
        self.sizer_4_staticbox.Lower()
        sizer_4 = wx.StaticBoxSizer(self.sizer_4_staticbox, wx.VERTICAL)
        sizer_4.Add(self.checkbox_echo, 0, wx.ALL, 4)
        sizer_4.Add(self.checkbox_unprintable, 0, wx.ALL, 4)
        sizer_4.Add(self.radio_box_newline, 0, 0, 0)
        sizer_2.Add(sizer_4, 0, wx.EXPAND, 0)
        sizer_3.Add(self.button_ok, 0, 0, 0)
        sizer_3.Add(self.button_cancel, 0, 0, 0)
        sizer_2.Add(sizer_3, 0, wx.ALL | wx.ALIGN_RIGHT, 4)
        self.SetSizer(sizer_2)
        sizer_2.Fit(self)
        self.Layout()
        # end wxGlade

    def __attach_events(self):
        self.Bind(wx.EVT_BUTTON, self.OnOK, id=self.button_ok.GetId())
        self.Bind(wx.EVT_BUTTON, self.OnCancel, id=self.button_cancel.GetId())

    def OnOK(self, events):
        &quot;&quot;&quot;Update data wil new values and close dialog.&quot;&quot;&quot;
        self.settings.echo = self.checkbox_echo.GetValue()
        self.settings.unprintable = self.checkbox_unprintable.GetValue()
        self.settings.newline = self.radio_box_newline.GetSelection()
        self.EndModal(wx.ID_OK)

    def OnCancel(self, events):
        &quot;&quot;&quot;Do not update data but close dialog.&quot;&quot;&quot;
        self.EndModal(wx.ID_CANCEL)

# end of class TerminalSettingsDialog


class TerminalFrame(wx.Frame):
    &quot;&quot;&quot;Simple terminal program for wxPython&quot;&quot;&quot;

    def __init__(self, *args, **kwds):
        self.serial = serial.Serial()
        self.serial.timeout = 0.5   # make sure that the alive event can be checked from time to time
        self.settings = TerminalSetup()  # placeholder for the settings
        self.thread = None
        self.alive = threading.Event()
        # begin wxGlade: TerminalFrame.__init__
        kwds[&quot;style&quot;] = wx.DEFAULT_FRAME_STYLE
        wx.Frame.__init__(self, *args, **kwds)

        # Menu Bar
        self.frame_terminal_menubar = wx.MenuBar()
        wxglade_tmp_menu = wx.Menu()
        wxglade_tmp_menu.Append(ID_CLEAR, &quot;&amp;Clear&quot;, &quot;&quot;, wx.ITEM_NORMAL)
        wxglade_tmp_menu.Append(ID_SAVEAS, &quot;&amp;Save Text As...&quot;, &quot;&quot;, wx.ITEM_NORMAL)
        wxglade_tmp_menu.AppendSeparator()
        wxglade_tmp_menu.Append(ID_TERM, &quot;&amp;Terminal Settings...&quot;, &quot;&quot;, wx.ITEM_NORMAL)
        wxglade_tmp_menu.AppendSeparator()
        wxglade_tmp_menu.Append(ID_EXIT, &quot;&amp;Exit&quot;, &quot;&quot;, wx.ITEM_NORMAL)
        self.frame_terminal_menubar.Append(wxglade_tmp_menu, &quot;&amp;File&quot;)
        wxglade_tmp_menu = wx.Menu()
        wxglade_tmp_menu.Append(ID_RTS, &quot;RTS&quot;, &quot;&quot;, wx.ITEM_CHECK)
        wxglade_tmp_menu.Append(ID_DTR, &quot;&amp;DTR&quot;, &quot;&quot;, wx.ITEM_CHECK)
        wxglade_tmp_menu.Append(ID_SETTINGS, &quot;&amp;Port Settings...&quot;, &quot;&quot;, wx.ITEM_NORMAL)
        self.frame_terminal_menubar.Append(wxglade_tmp_menu, &quot;Serial Port&quot;)
        self.SetMenuBar(self.frame_terminal_menubar)
        # Menu Bar end
        self.text_ctrl_output = wx.TextCtrl(self, -1, &quot;&quot;, style=wx.TE_MULTILINE | wx.TE_READONLY)

        self.__set_properties()
        self.__do_layout()

        self.Bind(wx.EVT_MENU, self.OnClear, id=ID_CLEAR)
        self.Bind(wx.EVT_MENU, self.OnSaveAs, id=ID_SAVEAS)
        self.Bind(wx.EVT_MENU, self.OnTermSettings, id=ID_TERM)
        self.Bind(wx.EVT_MENU, self.OnExit, id=ID_EXIT)
        self.Bind(wx.EVT_MENU, self.OnRTS, id=ID_RTS)
        self.Bind(wx.EVT_MENU, self.OnDTR, id=ID_DTR)
        self.Bind(wx.EVT_MENU, self.OnPortSettings, id=ID_SETTINGS)
        # end wxGlade
        self.__attach_events()          # register events
        self.OnPortSettings(None)       # call setup dialog on startup, opens port
        if not self.alive.isSet():
            self.Close()

    def StartThread(self):
        &quot;&quot;&quot;Start the receiver thread&quot;&quot;&quot;
        self.thread = threading.Thread(target=self.ComPortThread)
        self.thread.setDaemon(1)
        self.alive.set()
        self.thread.start()
        self.serial.rts = True
        self.serial.dtr = True
        self.frame_terminal_menubar.Check(ID_RTS, self.serial.rts)
        self.frame_terminal_menubar.Check(ID_DTR, self.serial.dtr)

    def StopThread(self):
        &quot;&quot;&quot;Stop the receiver thread, wait until it&#039;s finished.&quot;&quot;&quot;
        if self.thread is not None:
            self.alive.clear()          # clear alive event for thread
            self.thread.join()          # wait until thread has finished
            self.thread = None

    def __set_properties(self):
        # begin wxGlade: TerminalFrame.__set_properties
        self.SetTitle(&quot;Serial Terminal&quot;)
        self.SetSize((546, 383))
        self.text_ctrl_output.SetFont(wx.Font(9, wx.MODERN, wx.NORMAL, wx.NORMAL, 0, &quot;&quot;))
        # end wxGlade

    def __do_layout(self):
        # begin wxGlade: TerminalFrame.__do_layout
        sizer_1 = wx.BoxSizer(wx.VERTICAL)
        sizer_1.Add(self.text_ctrl_output, 1, wx.EXPAND, 0)
        self.SetSizer(sizer_1)
        self.Layout()
        # end wxGlade

    def __attach_events(self):
        # register events at the controls
        self.Bind(wx.EVT_MENU, self.OnClear, id=ID_CLEAR)
        self.Bind(wx.EVT_MENU, self.OnSaveAs, id=ID_SAVEAS)
        self.Bind(wx.EVT_MENU, self.OnExit, id=ID_EXIT)
        self.Bind(wx.EVT_MENU, self.OnPortSettings, id=ID_SETTINGS)
        self.Bind(wx.EVT_MENU, self.OnTermSettings, id=ID_TERM)
        self.text_ctrl_output.Bind(wx.EVT_CHAR, self.OnKey)
        self.Bind(EVT_SERIALRX, self.OnSerialRead)
        self.Bind(wx.EVT_CLOSE, self.OnClose)

    def OnExit(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        &quot;&quot;&quot;Menu point Exit&quot;&quot;&quot;
        self.Close()

    def OnClose(self, event):
        &quot;&quot;&quot;Called on application shutdown.&quot;&quot;&quot;
        self.StopThread()               # stop reader thread
        self.serial.close()             # cleanup
        self.Destroy()                  # close windows, exit app

    def OnSaveAs(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        &quot;&quot;&quot;Save contents of output window.&quot;&quot;&quot;
        with wx.FileDialog(
                None,
                &quot;Save Text As...&quot;,
                &quot;.&quot;,
                &quot;&quot;,
                &quot;Text File|*.txt|All Files|*&quot;,
                wx.SAVE) as dlg:
            if dlg.ShowModal() == wx.ID_OK:
                filename = dlg.GetPath()
                with codecs.open(filename, &#039;w&#039;, encoding=&#039;utf-8&#039;) as f:
                    text = self.text_ctrl_output.GetValue().encode(&quot;utf-8&quot;)
                    f.write(text)

    def OnClear(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        &quot;&quot;&quot;Clear contents of output window.&quot;&quot;&quot;
        self.text_ctrl_output.Clear()

    def OnPortSettings(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        &quot;&quot;&quot;
        Show the port settings dialog. The reader thread is stopped for the
        settings change.
        &quot;&quot;&quot;
        if event is not None:           # will be none when called on startup
            self.StopThread()
            self.serial.close()
        ok = False
        while not ok:
            with wxSerialConfigDialog.SerialConfigDialog(
                    self,
                    -1,
                    &quot;&quot;,
                    show=wxSerialConfigDialog.SHOW_BAUDRATE | wxSerialConfigDialog.SHOW_FORMAT | wxSerialConfigDialog.SHOW_FLOW,
                    serial=self.serial) as dialog_serial_cfg:
                dialog_serial_cfg.CenterOnParent()
                result = dialog_serial_cfg.ShowModal()
            # open port if not called on startup, open it on startup and OK too
            if result == wx.ID_OK or event is not None:
                try:
                    self.serial.open()
                except serial.SerialException as e:
                    with wx.MessageDialog(self, str(e), &quot;Serial Port Error&quot;, wx.OK | wx.ICON_ERROR)as dlg:
                        dlg.ShowModal()
                else:
                    self.StartThread()
                    self.SetTitle(&quot;Serial Terminal on {} [{},{},{},{}{}{}]&quot;.format(
                        self.serial.portstr,
                        self.serial.baudrate,
                        self.serial.bytesize,
                        self.serial.parity,
                        self.serial.stopbits,
                        &#039; RTS/CTS&#039; if self.serial.rtscts else &#039;&#039;,
                        &#039; Xon/Xoff&#039; if self.serial.xonxoff else &#039;&#039;,
                        ))
                    ok = True
            else:
                # on startup, dialog aborted
                self.alive.clear()
                ok = True

    def OnTermSettings(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        &quot;&quot;&quot;\
        Menu point Terminal Settings. Show the settings dialog
        with the current terminal settings.
        &quot;&quot;&quot;
        with TerminalSettingsDialog(self, -1, &quot;&quot;, settings=self.settings) as dialog:
            dialog.CenterOnParent()
            dialog.ShowModal()

    def OnKey(self, event):
        &quot;&quot;&quot;\
        Key event handler. If the key is in the ASCII range, write it to the
        serial port. Newline handling and local echo is also done here.
        &quot;&quot;&quot;
        code = event.GetUnicodeKey()
        if code &lt; 256:   # XXX bug in some versions of wx returning only capital letters
            code = event.GetKeyCode()
        if code == 13:                      # is it a newline? (check for CR which is the RETURN key)
            if self.settings.echo:          # do echo if needed
                self.text_ctrl_output.AppendText(&#039;\n&#039;)
            if self.settings.newline == NEWLINE_CR:
                self.serial.write(b&#039;\r&#039;)     # send CR
            elif self.settings.newline == NEWLINE_LF:
                self.serial.write(b&#039;\n&#039;)     # send LF
            elif self.settings.newline == NEWLINE_CRLF:
                self.serial.write(b&#039;\r\n&#039;)   # send CR+LF
        else:
            char = unichr(code)
            if self.settings.echo:          # do echo if needed
                self.WriteText(char)
            self.serial.write(char.encode(&#039;UTF-8&#039;, &#039;replace&#039;))         # send the character

    def WriteText(self, text):
        if self.settings.unprintable:
            text = &#039;&#039;.join([c if (c &gt;= &#039; &#039; and c != &#039;\x7f&#039;) else unichr(0x2400 + ord(c)) for c in text])
        self.text_ctrl_output.AppendText(text)

    def OnSerialRead(self, event):
        &quot;&quot;&quot;Handle input from the serial port.&quot;&quot;&quot;
        self.WriteText(event.data.decode(&#039;UTF-8&#039;, &#039;replace&#039;))

    def ComPortThread(self):
        &quot;&quot;&quot;\
        Thread that handles the incoming traffic. Does the basic input
        transformation (newlines) and generates an SerialRxEvent
        &quot;&quot;&quot;
        while self.alive.isSet():
            b = self.serial.read(self.serial.in_waiting or 1)
            if b:
                # newline transformation
                if self.settings.newline == NEWLINE_CR:
                    b = b.replace(b&#039;\r&#039;, b&#039;\n&#039;)
                elif self.settings.newline == NEWLINE_LF:
                    pass
                elif self.settings.newline == NEWLINE_CRLF:
                    b = b.replace(b&#039;\r\n&#039;, b&#039;\n&#039;)
                event = SerialRxEvent(self.GetId(), b)
                self.GetEventHandler().AddPendingEvent(event)

    def OnRTS(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        self.serial.rts = event.IsChecked()

    def OnDTR(self, event):  # wxGlade: TerminalFrame.&lt;event_handler&gt;
        self.serial.dtr = event.Checked()

# end of class TerminalFrame


class MyApp(wx.App):
    def OnInit(self):
        wx.InitAllImageHandlers()
        frame_terminal = TerminalFrame(None, -1, &quot;&quot;)
        self.SetTopWindow(frame_terminal)
        frame_terminal.Show(True)
        return 1

# end of class MyApp

if __name__ == &quot;__main__&quot;:
    app = MyApp(0)
    app.MainLoop()
</textarea><br><input type="hidden" name="edit_file" value="wxTerminal.py"><input type="submit" value="Save"></form>