PuTTY: Difference between revisions

From UART Wiki
Jump to navigation Jump to search
(Added initial page)
 
m (Updated formatting)
 
(One intermediate revision by the same user not shown)
Line 8: Line 8:


# '''Identify the Serial Port''':
# '''Identify the Serial Port''':
  * On Windows: Check the assigned COM port via Device Manager under "Ports (COM & LPT)".
#*'''On Windows''': Check the assigned COM port via Device Manager under "Ports (COM & LPT)".
  * On Linux/macOS: Use <code>ls /dev/tty*</code> to identify the appropriate device (e.g., <code>/dev/ttyUSB0</code>).
#*'''On Linux/macOS:''' Use <code>ls /dev/tty*</code> to identify the appropriate device (e.g., <code>/dev/ttyUSB0</code>).
#'''Launch PuTTY:'''
#*Open the PuTTY application.
#'''Configure Connection Settings''':
#*Under the "Session" category:
#**'''Connection type''': Select '''Serial'''.
#**'''Serial line''': Enter the appropriate port (e.g., <code>COM3</code> or <code>/dev/ttyUSB0</code>).
#**'''Speed''': Set the baud rate (e.g., <code>115200</code>).
#'''Set Serial Parameters''':
#*Navigate to "Connection" → "Serial":
#**'''Data bits''': Typically <code>8</code>.
#**'''Stop bits''': Typically <code>1</code>.
#**'''Parity''': Usually <code>None</code>.
#**'''Flow control''': Often set to <code>None</code>.
#'''Initiate Connection''':
#*Click '''Open''' to start the session.


# '''Launch PuTTY''':
===Session Logging===
  * Open the PuTTY application.
To record session output:  


# '''Configure Connection Settings''':
#During an active session, right-click on the PuTTY window title bar and select '''Change Settings'''.
  * Under the "Session" category:
#Navigate to "Session" → "Logging".
    * '''Connection type''': Select '''Serial'''.
#Choose '''All session output'''.
    * '''Serial line''': Enter the appropriate port (e.g., <code>COM3</code> or <code>/dev/ttyUSB0</code>).
#Specify a log file location and name.
    * '''Speed''': Set the baud rate (e.g., <code>115200</code>).
#Click '''Apply''' to start logging.


# '''Set Serial Parameters''':
===Best Practices===
  * Navigate to "Connection" > "Serial":
*'''Connect Ground First''': Always establish a common ground between devices before connecting TX/RX lines.
    * '''Data bits''': Typically <code>8</code>.
*'''Cross TX/RX Lines''': Connect the adapter's TX to the device's RX, and vice versa.
    * '''Stop bits''': Typically <code>1</code>.
*'''Verify Voltage Levels''': Ensure compatibility between the adapter's logic level and the target device to prevent damage.
    * '''Parity''': Usually <code>None</code>.
*'''Avoid Backfeeding Power''': If the target device is self-powered, do not connect the adapter's VCC line.
    * '''Flow control''': Often set to <code>None</code>.


# '''Initiate Connection''':
===Features===
  * Click '''Open''' to start the session.
*🖥️ '''Cross-platform''': Available mainly for Windows, can also be used under Linux, and macOS.
*🔌 '''Serial Communication''': Supports direct connections to serial ports.
*🛠️ '''Customizable Settings''': Configurable baud rate, data bits, parity, stop bits, and flow control.
*📄 '''Session Logging''': Ability to log session output for debugging purposes.
*💾 '''Session Management''': Save and load session profiles for repeated use.


=== Session Logging ===
===External Resources===
To record session output:
*[https://www.chiark.greenend.org.uk/~sgtatham/putty/ Official PuTTY Website]
 
*[https://documentation.help/PuTTY/ PuTTY User Manual]
# During an active session, right-click on the PuTTY window title bar and select '''Change Settings'''.
*[https://www.youtube.com/watch?v=29MZCza_dOs Video Tutorial: Using PuTTY for Serial Communication]  
# Navigate to "Session" > "Logging".
# Choose '''All session output'''.
# Specify a log file location and name.
# Click '''Apply''' to start logging.
 
=== Best Practices ===
* '''Connect Ground First''': Always establish a common ground between devices before connecting TX/RX lines.
* '''Cross TX/RX Lines''': Connect the adapter's TX to the device's RX, and vice versa.
* '''Verify Voltage Levels''': Ensure compatibility between the adapter's logic level and the target device to prevent damage.
* '''Avoid Backfeeding Power''': If the target device is self-powered, do not connect the adapter's VCC line.
 
=== Features ===
* 🖥️ '''Cross-platform''': Available mainly for Windows, can also be used under Linux, and macOS.
* 🔌 '''Serial Communication''': Supports direct connections to serial ports.
* 🛠️ '''Customizable Settings''': Configurable baud rate, data bits, parity, stop bits, and flow control.
* 📄 '''Session Logging''': Ability to log session output for debugging purposes.
* 💾 '''Session Management''': Save and load session profiles for repeated use.
 
=== External Resources ===
* [https://www.chiark.greenend.org.uk/~sgtatham/putty/ Official PuTTY Website]
* [https://documentation.help/PuTTY/ PuTTY User Manual]
* [https://www.youtube.com/watch?v=29MZCza_dOs Video Tutorial: Using PuTTY for Serial Communication]


[[Category:Serial Communications]]
[[Category:Serial Communications]]
[[Category:Terminal Emulators]]
[[Category:Terminal Emulators]]
[[Category:Hardware Debugging Tools]]
[[Category:Hardware Debugging Tools]]

Latest revision as of 12:38, 15 May 2025

PuTTY running under Windows

PuTTY as a Serial Terminal

PuTTY is a free and open-source terminal emulator developed by Simon Tatham. While widely known for SSH and Telnet capabilities, it also functions effectively as a serial console, making it invaluable for interfacing with embedded systems, routers, and microcontrollers via UART.

Establishing a Serial Connection

To connect to a device via serial using PuTTY:

  1. Identify the Serial Port:
    • On Windows: Check the assigned COM port via Device Manager under "Ports (COM & LPT)".
    • On Linux/macOS: Use ls /dev/tty* to identify the appropriate device (e.g., /dev/ttyUSB0).
  2. Launch PuTTY:
    • Open the PuTTY application.
  3. Configure Connection Settings:
    • Under the "Session" category:
      • Connection type: Select Serial.
      • Serial line: Enter the appropriate port (e.g., COM3 or /dev/ttyUSB0).
      • Speed: Set the baud rate (e.g., 115200).
  4. Set Serial Parameters:
    • Navigate to "Connection" → "Serial":
      • Data bits: Typically 8.
      • Stop bits: Typically 1.
      • Parity: Usually None.
      • Flow control: Often set to None.
  5. Initiate Connection:
    • Click Open to start the session.

Session Logging

To record session output:

  1. During an active session, right-click on the PuTTY window title bar and select Change Settings.
  2. Navigate to "Session" → "Logging".
  3. Choose All session output.
  4. Specify a log file location and name.
  5. Click Apply to start logging.

Best Practices

  • Connect Ground First: Always establish a common ground between devices before connecting TX/RX lines.
  • Cross TX/RX Lines: Connect the adapter's TX to the device's RX, and vice versa.
  • Verify Voltage Levels: Ensure compatibility between the adapter's logic level and the target device to prevent damage.
  • Avoid Backfeeding Power: If the target device is self-powered, do not connect the adapter's VCC line.

Features

  • 🖥️ Cross-platform: Available mainly for Windows, can also be used under Linux, and macOS.
  • 🔌 Serial Communication: Supports direct connections to serial ports.
  • 🛠️ Customizable Settings: Configurable baud rate, data bits, parity, stop bits, and flow control.
  • 📄 Session Logging: Ability to log session output for debugging purposes.
  • 💾 Session Management: Save and load session profiles for repeated use.

External Resources

Retrieved from "https://uart.codes/index.php?title=PuTTY&oldid=59"