soft_uart - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #llm #go #android #linux #docker #macos #kubernetes #pytorch #ios #openai

soft_uart

(★ 180)

Software-based serial port module for Raspberry Pi.

파일 탐색기

최종 버전 다운로드 (.zip)

LICENSE
Makefile
module.c
queue.c
queue.h
raspberry_soft_uart.c
raspberry_soft_uart.h
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/adrianomarto/soft_uart

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd soft_uart

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

APT (Debian/Ubuntu 계열) Debian/Ubuntu 계열 리눅스에 기본 내장된 패키지 매니저입니다.

sudo apt-get install raspberrypi-kernel-headers

APT 패키지 저장소에서 바로 설치합니다 (Debian/Ubuntu 계열).

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# soft_uart

Software-based serial port module for Raspberry Pi.

This module creates a software-based serial port using a configurable pair of GPIO pins. The serial port will appear as `/dev/ttySOFT0`.

## Features

* Works exactly as a hardware-based serial port.
* Works with any application, e.g. cat, echo, minicom.
* Configurable baud rate.
* TX buffer of 256 bytes.
* RX buffer managed by the kernel.

## Compiling

Fetch the source:
```
git clone https://github.com/adrianomarto/soft_uart
```

Install the package `raspberrypi-kernel-headers`:
```
sudo apt-get install raspberrypi-kernel-headers
```

Run `make` and `make install`, as usual.
```
cd soft_uart
make
sudo make install
```

I haven't tried cross-compiling this module, but it should work as well.

## Loading

Module parameters:

* gpio_tx: int [default = 17]
* gpio_rx: int [default = 27]

Loading the module with default parameters:
```
sudo insmod soft_uart.ko
```

Loading module with custom parameters:
```
sudo insmod soft_uart.ko gpio_tx=10 gpio_rx=11
```

## Usage

The device will appear as `/dev/ttySOFT0`. Use it as any usual TTY device.

You must be included in the group `dialout`. You can verify in what groups you are included by typing `groups`. To add an user to the group `dialout`, type:
```
sudo usermod -aG dialout <username>
```

Usage examples:
```
minicom -b 4800 -D /dev/ttySOFT0
cat /dev/ttySOFT0
echo "hello" > /dev/ttySOFT0
```

## Baud rate

When choosing the baud rate, take into account that:
* The Raspberry Pi is not very fast.
* You will probably not be running a real-time operating system.
* There will be other processes competing for CPU time.

As a result, you can expect communication errors when using fast baud rates. So I would not try to go any faster than 4800 bps.