# SerialPortAssistant

**Repository Path**: jf_linux/SerialPortAssistant

## Basic Information

- **Project Name**: SerialPortAssistant
- **Description**: 本项目是一个跨平台的串口助手。它能运行在WINDOWS、linux、mac系统上
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 49
- **Created**: 2019-09-28
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Serial Port Assistant
=====================

Author: Kang Lin (kl222@126.com)
--------------------------------

[<img src="Resource/png/China.png" alt="Chinese" title="Chinese" width="16" height="16" />Chinese](README_zh_CN.md)

1. ![Project: https://github.com/KangLin/SerialPortAssistant](https://github.com/KangLin/SerialPortAssistant)  
This project is a cross-platform serial assistant. It can run on:
    - [x] WINDOWS
    - [x] linux
    - [x] mac  
        Mac os, I don't have the corresponding equipment,
        please compile and test the user with the corresponding equipment.

2. Complie status

    |Platform|Status|
    |:---:|:------:|
    |windows、android|[![windows、android](https://ci.appveyor.com/api/projects/status/y77e828ysqc79r9o?svg=true)](https://ci.appveyor.com/project/KangLin/serialportassistant)|
    |linux|[![linux](https://travis-ci.org/KangLin/SerialPortAssistant.svg?branch=master)](https://travis-ci.org/KangLin/SerialPortAssistant)|

3. Multi-language
    * Chinese  
    ![Chinese](Docs/ui-zh.jpg)
    * Englisth  
    ![Englisth](Docs/ui-en.jpg)

4. Multi style

5. ![Release download](https://github.com/KangLin/SerialPortAssistant/releases)  
![Latest release download](https://github.com/KangLin/SerialPortAssistant/releases/latest)

- windows
    + [SerialPortAssistant-Setup-v0.5.0.exe](https://github.com/KangLin/SerialPortAssistant/releases/download/v0.5.0/SerialPortAssistant-Setup-v0.5.0.exe)

- linux
    + [SerialPortAssistant_v0.5.0.tar.gz](https://github.com/KangLin/SerialPortAssistant/releases/download/v0.5.0/SerialPortAssistant_v0.5.0.tar.gz)  
        The AppImage format executable can be run directly on the Linux system, see: https://appimage.org/  
        Usage:    
        1. Decompress. Copy SerialPortAssistant_v0.5.0.tar.gz to install directory, then decompress it:
    
                  sudo mkdir /opt/SerialPortAssistant
                  cd SerialPortAssistant
                  sudo wget https://github.com/KangLin/SerialPortAssistant/releases/download/v0.5.0/SerialPortAssistant_v0.5.0.tar.gz
                  sudo tar xvfz SerialPortAssistant_v0.5.0.tar.gz
    
        2. install
    
                  sudo ./install.sh install
    
        3. If you want to uninstall
    
                  sudo ./install.sh remove

- ubuntu
    + [serialportassistant_0.5.0_amd64.deb](https://github.com/KangLin/SerialPortAssistant/releases/download/v0.5.0/serialportassistant_0.5.0_amd64.deb)

            sudo dpkg -i serialportassistant_0.5.0_amd64.deb

6. Donate  
If you are satisfied, you can donate to me  
 
![donation](https://github.com/KangLin/RabbitCommon/raw/master/Src/Resource/image/Contribute.png "donation")

7. Dependence  

  + [Qt (LGPL v2.1)](http://qt.io/)
  + RabbitCommon: https://github.com/KangLin/RabbitCommon
  
  ```
  git clon https://github.com/KangLin/RabbitCommon.git
  ```
  
8. Compile
    - Compiled with QtCreator
       * Open the project file ![SerialPortAssistant.pro](SerialPortAssistant.pro) with QtCreator
       * Set the parameter RabbitCommon_DIR
       * Direct compilation can generate programs
    - Compile with the command line
       * Build the build directory in the project root directory
       * *qmake* build compilation project
       * *make* install Build the program with the local toolchain
       * The program is generated in the *install* directory

    ```sh
    mkdir build
    cd build
    qmake ../SerialPortAssistant.pro
    make install
    cd install  #The program is generated in the install directory
    ```