Package: eurekaroom
SpaceRoomByCDEguiawithYetiCraft, andJ. ScottforEureka RoomCode for running escape room hardware comprised of Arduino's and Raspberry Pi's running Rasbian.General SetupThe following section describes the setup process in generic detail.First, create an SD card with the Raspbian OS (latest) image using the methods foundonline.Write ssh and wifi configs to the /boot partition so that both will be available upon first boot (with or without a screen attached)Enable SSHInsert the prepared card and boot the device.Connect to the device.ProductionFor production purposes, each Eurekaroom node will run on a Raspberry Pi (version 3b or higher) with Raspbian (latest) as the OS.Install Eurekaroom$ pip3 install eurekaroomUsageTo use the command line utility, execute the following on the linux system in a terminal where you have installed the package:Display Help:$ ecmd -hRun Web interface using default config:$ ecmd -asLaunch Web interface with user provided config and save provide config:$ ecmd -wam PATH_TO_MEDIA -n NODE_NAME -sChange the default node name:$ ecmd --writeconfig --nodename NODE_NAMEChange the default media path:$ ecmd --writeconfig --mediapath PATH_TO_MEDIAAdd media to the config file:$ ecmd --writeconfig --autoaddmediaLaunch the web interface:$ ecmd -sThis will allow you to control the media displayed on the node through the web interface.To access you ecmd web interface open up your favorite web browser on any pc connected to the same network as your node and enter the ip address followed by the port number i.e. "192.168.0.54:5000/"Auto start on bootIf eurekaroom was installed with thepip install eurekaroomcommand you can run:$ ecmd --installserviceOr set the autostart application in the auto-login account to be the/full/path/to/ecmd -scommand.Reboot and ensure the system is responding on the expected when port and to command line execution.DevelopmentClone RepoClone this repo or copy the code to the target linux system.  To clone the repo to a Linux system, ensure that you havegitinstalled properly and then use the following command from a terminal:$ git clone git@gitlab.com:growlf/eurekaroom.gitThis will expect that your SSH keys are installed on this system in the correct path.Add system dependenciesNext, open a terminal shell and execute the following, which will update packages and install the system dependencies:$ sudo apt-get update && sudo apt install -y git python3-pip python3-tk libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-dev libopenjp2-7-dev libdbus-1-dev libtiff5
$ pip3 install --user pipenv
$ export PATH=$PATH:/home/pi/.local/bin # Add new path
$ exit # Reboot the PiActivate development ecmdNext, open a terminal shell within the code directory to execute the following commands:$ pipenv shell
$ pip install -e .This will create and activate a local Python3 virtual environment that allows isolation from the system's copy of Python and it's libraries. This Python environment will be completely dedicated to this project and will not affect the system Python interpreter - nor be affected by it.Development MediaNext, add your media files (Images and Videos folders) into system.  It is recommended to use a layout similar to the following for default configuration:eurekaroom (project root, created from the git clone operation)
|
+-/bin
| +-/ecmd (commandline tool)
|
+-/eurekaroom (module folder)
| | ...(class definition files)  
|
+-/Media
| | ... (misc media - should be none)
| +-/Images
| | ... (image files)
| +-/Videos
|   ... (video files)
|
+-/tests (test folder)
| | ...(test files)  
|
+-/eurekanode.log
+-/README.md
+-/requirements.txt
+-/Pipfile
+-/Pipfile.lock
+-/setup.pyDeveloper NotesThe following are mostly links and random bits of info that the developers thought were important or needed to share with each other.Development EnvironmentGetVisual Code, a graphical programing interfaceAdding teststo python code with Visual CodePythonpython3-tk, GUI framework for graphical interfaces using TkRPi.GPIO, library to allow using the code on a NON-Raspberry Pi during development.https://blog.withcode.uk/wp-content/uploads/2016/10/RPi_GPIO_python_quickstart_guide.pdfgpiosimulatorargparse, an option parsing library for command line processingconfigparsera configuration file library.Loggingwith pythonA guide toWorking with files in PythonOtherReal favicon generatorTable of ContentsSpaceRoomGeneral SetupProductionInstall EurekaroomUsageAuto start on bootDevelopmentClone RepoAdd system dependenciesActivate development ecmdDevelopment MediaDeveloper NotesDevelopment EnvironmentPythonOtherTable of Contents