Skip to content

robocre8/epmc_setup_application

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Easy PID Motor Controller (EPMC) Setup Application

It contains source code of the Easy PID Motor Controller (EPMC) GUI application. The application requires that you have the L298N EPMC MODULE (or a CUSTOM EPMC INTERFACE BOARD) is connected to your PC. 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-venv   # 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 Easy IMU Module connected to the PC.

Run App First Time [ 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

    python3 -m venv .env
  • activate the virtual environment

    source .env/bin/activate
  • 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

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

  • once you are done using the application, just close and deactivate the environment

      deactivate

Run App First Time [ 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

    python -m venv .env
  • activate the virtual environment

    .\.env\Scripts\activate.bat # In CMD
    .\.env\Scripts\Activate.ps1 # In Powershel
  • 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

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

  • once you are done using the application, just close and dectivate the environment

    deactivate

Run App - Not As First Time [ Ubuntu or Mac Users ]

  • change directory into the root epmc_setup_application folder

    cd epmc_setup_application/
  • activate the virtual environment

    source .env/bin/activate
  • you should see now that you are in the .env virtual environment

  • now you can run the app in the virtual environment

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

  • once you are done using the application, just close and dectivate the environment

      deactivate

Run App - Not As First Time [ Windows ]

  • change directory into the root epmc_setup_application folder

    cd .\epmc_setup_application\
  • activate the virtual environment

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

  • now you can run the app in the virtual environment

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

  • once you are done using the application, just close and dectivate the environment

    deactivate

Build epmc_app with pyinstaller [Linux and Mac]

  • change directory into the root epmc_setup_application folder

    cd epmc_setup_application/
  • activate the virtual environment

    source .env/bin/activate
  • you should see now that you are in the .env virtual environment

  • build the application with pyinstaller:

    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

Build epmc_app with pyinstaller [Windows]

  • change directory into the root epmc_setup_application folder

    cd epmc_setup_application\
  • activate the virtual environment

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

  • 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, close and dectivate the environment

    deactivate

About

It contains source code of the Easy PID Motor Controller (EPMC) GUI application

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages