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.

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