Serial-Studio/doc/README_ES.md

136 lines
6.9 KiB
Markdown
Raw Normal View History

2020-12-24 19:53:01 -06:00
<a href="#">
2021-09-28 17:05:16 -05:00
<img width="192px" height="192px" src="/doc/icon.svg" align="right" />
2020-12-24 19:53:01 -06:00
</a>
# Serial Studio
2024-09-25 21:11:33 -05:00
[![Github commits](https://img.shields.io/github/last-commit/Serial-Studio/Serial-Studio?style=for-the-badge&logo=github)](https://github.com/Serial-Studio/Serial-Studio/commits/master)
[![GitHub contributors](https://img.shields.io/github/contributors/Serial-Studio/Serial-Studio?style=for-the-badge&logo=github)](https://github.com/Serial-Studio/Serial-Studio/graphs/contributors)
[![PR's Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=for-the-badge)](https://github.com/Serial-Studio/Serial-Studio/pull/new)
[![Github All Releases](https://img.shields.io/github/downloads/Serial-Studio/Serial-Studio/total.svg?style=for-the-badge&logo=github)](https://github.com/Serial-Studio/Serial-Studio/releases/)
[![Instagram](https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white)](https://instagram.com/serialstudio.app)
[![Donate](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://www.paypal.com/donate?hosted_button_id=XN68J47QJKYDE)
2020-12-24 19:53:01 -06:00
Serial Studio es una herramienta de visualización de datos multiplataforma y versátil, diseñada para ingenieros de sistemas embebidos, estudiantes, hackers y profesores. Permite a los usuarios visualizar, analizar y representar los datos de sus proyectos y dispositivos sin necesidad de desarrollar software de visualización específico para cada proyecto. Serial Studio ofrece una solución flexible que se adapta a una amplia gama de casos de uso, haciéndola ideal tanto para entornos educativos como profesionales.
2020-12-24 19:53:01 -06:00
La herramienta nació de mi experiencia en múltiples competencias basadas en CanSat, donde a menudo me encontraba desarrollando nuevo software para la estación terrena para cada proyecto. Con el tiempo, me di cuenta de que sería más eficiente y sostenible mantener un único programa que sea flexible, que permitiera a los usuarios definir cómo se procesan y muestran los datos entrantes.
2020-12-24 19:53:01 -06:00
Hoy en día, Serial Studio es una herramienta poderosa y adaptable, adecuada no solo para competencias de CanSat, sino para cualquier proyecto de adquisición y visualización de datos. Soporta la recuperación de datos desde una amplia gama de fuentes, incluyendo puertos seriales, MQTT, Bluetooth Low Energy (BLE), y sockets de red (TCP/UDP).
2020-12-24 19:53:01 -06:00
*Lee este documento en otros idiomas*: [Español](/doc/README_ES.md) [简体中文](/doc/README_ZH.md) [Deutsch](/doc/README_DE.md) [Русский](/doc/README_RU.md) [Français](/doc/README_FR.md)
2020-12-24 22:13:13 -06:00
2024-09-21 02:04:49 -05:00
![Uso del Software](/doc/screenshot.png)
2020-12-24 19:53:01 -06:00
## Características
- **Multiplataforma:** Compatible con Windows, macOS y Linux.
- **Exportación a CSV:** Guarda de manera sencilla los datos recibidos en archivos CSV para su posterior análisis o procesamiento.
- **Compatibilidad con múltiples fuentes de datos:** Soporta una amplia variedad de fuentes, incluyendo puertos seriales, MQTT, Bluetooth Low Energy (BLE) y sockets de red (TCP/UDP).
- **Visualización personalizable:** Permite definir y visualizar datos mediante diversos widgets, configurables a través del editor de proyectos para adaptarse a las necesidades específicas del usuario.
- **Análisis de tramas personalizable:** Ofrece la posibilidad de modificar una función en JavaScript para interpretar las tramas de datos entrantes, facilitando el preprocesamiento de datos crudos de sensores y el manejo de formatos binarios complejos.
- **Publicación y recepción mediante MQTT:** Envía y recibe datos a traves de la Internet, lo que habilita la visualización en tiempo real de información desde cualquier lugar del mundo.
2020-12-24 19:53:01 -06:00
2021-09-04 13:29:35 -05:00
## Instalación
Puedes descargar e instalar la última versión de Serial Studio para tu plataforma preferida desde [aquí](https://github.com/Serial-Studio/Serial-Studio/releases/latest).
### Instalación en Linux
2021-09-04 13:29:35 -05:00
2024-11-06 16:16:51 -05:00
Para los usuarios de GNU/Linux, hay varias formas de instalar y ejecutar la aplicación:
2021-09-04 13:29:35 -05:00
2024-11-06 16:16:51 -05:00
#### 1. AppImage
Descarga el archivo AppImage y asegúrate de que tenga los permisos de ejecución correctos antes de ejecutarlo:
```
chmod +x SerialStudio-3.0.5-Linux-x86_64.AppImage
./SerialStudio-3.0.5-Linux-x86_64.AppImage
2021-09-04 13:29:35 -05:00
```
2024-11-06 16:16:51 -05:00
*Nota:* Es posible que necesites instalar libfuse2 para que el AppImage funcione. En sistemas basados en Debian/Ubuntu, puedes instalarlo con:
2024-11-06 16:16:51 -05:00
```
sudo apt update
sudo apt install libfuse2
```
2024-11-06 16:19:25 -05:00
Puedes integrar el AppImage de Serial Studio en tu sistema más fácilmente utilizando [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher/).
2021-09-04 13:29:35 -05:00
2024-11-06 16:16:51 -05:00
#### 2. Paquetes DEB/RPM (experimental)
También puedes instalar Serial Studio usando paquetes DEB o RPM, que actualmente se encuentran en una etapa experimental. Por favor, informa cualquier problema que encuentres.
Para distribuciones basadas en Debian (p. ej., Debian, Ubuntu, Linux Mint, etc.):
```
sudo dpkg -i SerialStudio-3.0.5-Linux-x86_64.deb
2021-09-04 13:29:35 -05:00
```
2024-11-06 16:16:51 -05:00
Para distribuciones basadas en RPM (p. ej., Fedora, RHEL, OpenSUSE, etc.):
```
sudo rpm -i SerialStudio-3.0.5-Linux-x86_64.rpm
```
2021-09-04 13:29:35 -05:00
## Desarrollo
2020-12-24 19:53:01 -06:00
### Requisitos
Para compilar Serial Studio, la única dependencia requerida es [Qt](http://www.qt.io/download-open-source/). La aplicación de escritorio se compila con **Qt 6.8.0**.
2020-12-24 19:53:01 -06:00
Si compilas en GNU/Linux, también necesitarás instalar `libgl1-mesa-dev`:
```bash
sudo apt install libgl1-mesa-dev
```
Aquí tienes la lista de módulos de Qt necesarios:
2021-12-07 03:30:54 -06:00
- Qt SVG
- Qt Quick
- Qt Widgets
- Qt Location
- Qt Bluetooth
2021-12-07 03:30:54 -06:00
- Qt Networking
- Qt Positioning
- Qt Serial Port
2021-12-07 03:30:54 -06:00
- Qt Print Support
- Qt Quick Widgets
- Qt Quick Controls 2
2021-01-18 10:57:23 -05:00
### Clonar el Repositorio
2021-01-18 10:57:23 -05:00
Para clonar el repositorio con los submódulos necesarios, ejecuta:
2021-01-18 10:57:23 -05:00
```bash
git clone https://github.com/Serial-Studio/Serial-Studio
cd Serial-Studio
```
### Compilar la Aplicación
2021-01-18 10:57:23 -05:00
Una vez que Qt esté instalado, puedes compilar el proyecto abriendo el archivo **CMakeLists.txt** en tu IDE preferido o usando la línea de comandos:
2020-12-24 19:53:01 -06:00
```bash
mkdir build
cd build
cmake ../ -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release -j 10
```
2020-12-24 19:53:01 -06:00
## Arquitectura del Software
A continuación, se muestra un diagrama simplificado que ilustra cómo interactúan los diferentes módulos de Serial Studio. Para más información detallada, consulta la documentación completa de DOXYGEN [aquí](https://serial-studio.github.io/hackers/).
2024-09-21 02:04:49 -05:00
![Arquitectura](/doc/architecture/architecture.png)
## Licencia
2020-12-24 19:53:01 -06:00
2024-10-03 01:55:43 -05:00
Este proyecto está licenciado bajo la Licencia MIT. Para más detalles, consulta el archivo [LICENSE](/LICENSE.md).
2022-05-01 19:11:43 -05:00
## Soporte y Donaciones
2022-05-01 19:11:43 -05:00
Si encuentras Serial Studio útil, considera apoyar su desarrollo mediante una [donación a través de PayPal](https://www.paypal.com/donate?hosted_button_id=XN68J47QJKYDE).
2020-12-24 19:53:01 -06:00
Alternativamente, si alguna vez te encuentras en [Cancún, México](https://es.wikipedia.org/wiki/Canc%C3%BAn) y quieres invitarme a tomar una cerveza en persona, no dudes en [enviarme un mensaje en Instagram](https://instagram.com/aspatru). Me encantaría conocerte!