Welcome to SmallSOCC, a simple gui for commanding an arduino based linear stepper hardware over a serial interface.

Python package dependencies are handled during setup or can be installed manually using pip install <package-name> (see setup.py for up-to-date dependencies)

clone the repository:

git clone https://github.com/ryanneph/SmallSOCC.git
cd SmallSOCC

then install using pip or pipenv:

pip install .

or

pip install pipenv
pipenv install .

finally run with:

smallsocc

or

python smallsocc/gui.py

When installed as a development package, changes to the source code will be immediately reflected the next time smallsocc is run, without requiring a re-installation.

First clone the repository:

git clone https://github.com/ryanneph/SmallSOCC.git
cd SmallSOCC

Then install:

pip install pipenv
pipenv install -e .

conda create -n soc_dev python=3
conda activate soc_dev
python -m pip install -e .

pip install virtualenv
virtualenv soc_dev && source soc_dev/bin/activate
python -m pip install -e .

Communicating with serial ports is a bit different on windows and linux.

In linux, serial comm. is handled by the kernel and accessible using virtual file-like descriptors that typically show as /dev/ttyACMx or /dev/ttyUSBx depending on your distribution.

In windows, serial devices are assigned to a COMx ports instead. All of this should be relatively invisible since the PySerial package provides a convenient way to list all accessible serial ports regardless of the system.

Every attempt has been made to automatically detect the correct serial device on startup, but if manual specification is necessary, you may feed the your usb hardware ID as an argument to the device initialization function HWSOC(8, HID=<xxxx:xxxx>) in VID:PID format. You can view the detected devices and their HIDs by inspecting the command line warnings after a failure to connect.