GitHub - robocre8/epmc_setup_application: It contains source code of the Easy PID Motor Controller (EPMC) GUI application

It contains source code of the Easy PID Motor Controller (EPMC) GUI application. Without the module, only the start page can be viewed.

Screenshot 2025-05-08 150800

Running the GUI app (Using python virtual environment)

Prequisites

  • This would run on Linux (Ubuntu), Windows, and MAC OS

Note

For Windows and Mac Users, ensure you have the CH340 serial converter driver installed.

For Ubuntu Users - the CH340 driver is installed by default.

  • Ensure you have python3 installed on your PC and also pip

  • install python virtual environment

    sudo apt install python3-pip   # linux or mac users
    sudo apt install python3-virtualenv   # linux or mac users

    OR

    pip install virtualenv   # windows users (ensure you have pip installed)
  • Ensure you have the EPMC Module connected to the PC.

Run / Build App [ Ubuntu or Mac Users ]

  • Download (by clicking on the green Code button above) or clone the repo into your PC using git clone

    you can use this command if you want to clone the repo:

    git clone https://github.com/robocre8/epmc_setup_application.git
  • change directory into the root epmc_setup_application folder

    cd epmc_setup_application/
  • create a python virtual environment named .env in the root folder

  • activate the virtual environment

  • you should see now that you are in the .env virtual environment

  • install all required python modules

    pip3 install -r requirements.txt
  • now you can run the app in the virtual environment

  • Now follow this tutorial on how to use the Easy PID Motor Controller to setup velocity PID for a DC Motor

  • build the application with pyinstaller (optional):

    pyinstaller app.py --onefile --name epmc_app_ubuntu_<OS-version-number> --hidden-import='PIL._tkinter_finder' --noconsole

    OR

    pyinstaller app.py --onefile --name epmc_app_mac_<OS-version-number> --hidden-import='PIL._tkinter_finder' --noconsole
  • once you are done using the application, just close and deactivate the environment

Run / Build App [ Windows ]

  • Download (by clicking on the green Code button above) or clone the repo into your PC using git clone

    you can use this command if you want to clone the repo:

    git clone https://github.com/robocre8/epmc_setup_application.git
  • change directory into the root epmc_setup_application folder

    cd .\epmc_setup_application\
  • create a python virtual environment named .env in the root folder

  • activate the virtual environment

    .\.env\Scripts\Activate.ps1 # In Powershel

    OR

    .\.env\Scripts\activate.bat # In CMD
  • you should see now that you are in the .env virtual environment

  • install all required python modules

    pip install -r requirements.txt
  • now you can run the app in the virtual environment

  • Now follow this tutorial on how to use the Easy PID Motor Controller to setup velocity PID for a DC Motor

  • build the application with pyinstaller:

    pyinstaller app.py --onefile --name epmc_app_windows_<OS-version-number> --hidden-import='PIL._tkinter_finder' --noconsole
  • once you are done using the application, just close and dectivate the environment