aat440hz/sshclient-m5cardputer

SSH Terminal with M5Cardputer and ESP32

This project demonstrates how to create an SSH terminal using an M5Cardputer device and an ESP32 microcontroller. With this setup, you can remotely connect to an SSH server and interact with it using the M5Cardputer's keyboard and display.

Prerequisites

Before you get started, make sure you have the following hardware and software installed:

• M5Cardputer
• ESP32 development environment
• Arduino IDE
• Libraries:
  • M5Stack library
  • LibSSH-ESP32 by Ewan Parker

Installation

1. Clone or download this repository to your local machine.

2. Open the Arduino IDE, go to File > Preferences, and add the following URL to the "Additional Boards Manager URLs" field:

   https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/arduino/package_m5stack_index.json

3. Go to Tools > Board > Boards Manager, search for "M5Stack," and install the M5Stack board manager.

4. Select your M5Cardputer device from the Tools > Board menu.

5. Install the required libraries:

   • LibSSH-ESP32: It can be installed directly via the Arduino Library Manager. Search for "libssh" in the Library Manager and install LibSSH-ESP32 by Ewan Parker.

6. Configure your WiFi settings in the Arduino sketch:

   • Set your WiFi SSID and password.

7. Connect your M5Cardputer device to your computer, select the correct COM port, and upload the sketch.

Usage

1. Power on your M5Cardputer device.

2. Connect to your SSH server by pressing Enter after typing the server address, username, and password.

3. You can now interact with your SSH server through the M5Cardputer terminal.

4. The terminal supports basic keyboard input, and you can send commands to the SSH server.

Features

• Basic SSH terminal interface with M5Cardputer.
• Keyboard input and display for interacting with the SSH server.
• Ability to configure WiFi settings in the Arduino sketch.

Contributing

If you'd like to contribute to this project, please open an issue or pull request on the GitHub repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• M5Stack
• LibSSH-ESP32 by Ewan Parker

sshclient-m5cardputer's Issues

Needs M5Cardputer Library to compile

I had to add the M5Cardputer library (https://github.com/m5stack/M5Cardputer) in order to get this to compile.

Can't connect to non standard SSH port

When I try to connect to hosts that don't use default 22 port, where I put the port option?
Tried:

host_IP:port

host_IP port

Nothing seems to work. Is there a way to change port?

Crashing after inputting SSH credentials, seemingly due to stack/buffer overflow

PC      : 0x4038260b  PS      : 0x00060036  A0      : 0x8202aa31  A1      : 0x3fcf4e40  
A2      : 0x9c400000  A3      : 0x00038000  A4      : 0x9c400000  A5      : 0x00000000  
A6      : 0x3fc9e1f0  A7      : 0x00000000  A8      : 0x6001f000  A9      : 0x00000000  
A10     : 0x00000000  A11     : 0x00000000  A12     : 0x00000008  A13     : 0x3fcf4e78  
A14     : 0x4202a278  A15     : 0x00000000  SAR     : 0x00000020  EXCCAUSE: 0x00000001  
EXCVADDR: 0xb33fffff  LBEG    : 0x400570e8  LEND    : 0x400570f3  LCOUNT  : 0xffffffff  


Backtrace: 0x40382608:0x3fcf4e40 0x4202aa2e:0x3fcf4e70 0x4202aa85:0x3fcf4ea0 0x4202af1e:0x3fcf4f10 0x403774cd:0x3fcf4f60 0x40378714:0x3fcf4f80 0x42029e3d:0x3fcf5040 0x4202a245:0x3fcf5060 0x4202a27b:0x3fcf5090 0x4202a72e:0x3fcf50b0 0x4037e508:0x3fcf50d0




ELF file SHA256: b45901b8f08271f1

Rebooting...

Hi! This is my log. It complains about a stack canary being overwritten, so I think there is an issue with the code. It connects to WiFi fine, but when I put the password in, regardless of length, it crashes and reboots.