Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chon-group/serialportemulator
A Linux kernel module for serial device emulation
https://github.com/chon-group/serialportemulator
emulator kernel serial serial-communication serial-port
Last synced: 1 day ago
JSON representation
A Linux kernel module for serial device emulation
- Host: GitHub
- URL: https://github.com/chon-group/serialportemulator
- Owner: chon-group
- License: gpl-3.0
- Created: 2022-09-25T15:46:19.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-27T21:11:54.000Z (13 days ago)
- Last Synced: 2025-01-27T21:39:07.340Z (13 days ago)
- Topics: emulator, kernel, serial, serial-communication, serial-port
- Language: C
- Homepage:
- Size: 120 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SerialPortEmulator
This is a serial port emulator. This is done by creating pairs of ports on /dev where writing data on one port can be read on the pair and vice-versa.
## Installation
1) Install the dependencies. On your Debian-like Linux machine, run:
```
sudo apt install python3-serial linux-headers-`uname -r` gcc binutils make
```
2) Inside the driver folder, run:
```
make clean all
sudo make modules_install
sudo make install
```
3) Set read and write permissions on the pairs of devices to be used
Example: for the EmulatedPort 0 device:
```
sudo chmod 777 /dev/ttyEmulatedPort0
sudo chmod 777 /dev/ttyExogenous0
```
## Uninstallation
Inside the 'driver' folder, run:
```
sudo make uninstall
```
## Use
After the installation, by default, it will be instantiated on /dev many pairs of devices:
- /dev/ttyEmulatedPort0 <---> /dev/ttyExogenous0
- /dev/ttyEmulatedPort1 <---> /dev/ttyExogenous1
...
And so on. Writing on one device will make its content ready to be read on the other pair, and vice-versa.
You MUST at least open the other pair port to start sending data to it.
## Example
In a terminal window, execute the command below to put the emulated port waiting for incoming data
Open another terminal window and run the below command. On the first terminal Window. It should appear the message.
## Copyright
ChonIDE is licensed under a Creative Commons Attribution 4.0 International License. The licensor cannot revoke these freedoms as long as you follow the license terms:
* __Attribution__ — You must give __appropriate credit__ like below:
FREITAS, Bruno Policarpo Toledo; LAZARIN, Nilson Mori; PANTOJA, Carlos Eduardo. Uma Proposta de Emulador de Portas Seriais para Sistemas Multiagentes Embarcados. _In_: Workshop-Escola de Sistemas de Agentes, seus Ambientes e Aplicações (WESAAC), 17. , 2023, Pelotas/RS. Anais [...]. Pelotas: UFPel, 2023 . p. 55-66. URL: [https://zenodo.org/record/8329081](https://www.researchgate.net/publication/373484449_Uma_Proposta_de_Emulador_de_Portas_Seriais_para_Sistemas_Multiagentes_Embarcados)
### Bibtex
```
@inproceedings{freitas2023,
author = {Freitas, Bruno Policarpo Toledo and Lazarin, Nilson Mori and Pantoja, Carlos Eduardo},
title = {Uma {Proposta} de {Emulador} de {Portas} {Seriais} para {Sistemas} {Multiagentes} {Embarcados}},
booktitle = {Anais do XVII Workshop-Escola de Sistemas de Agentes, seus Ambientes e Aplicações (WESAAC 2023)},
location = {Pelotas/RS},
year = {2023},
pages = {55--66},
publisher = {UFPel},
address = {Pelotas, RS, Brasil},
url = {https://zenodo.org/record/8329081}
}