developer.makewonder.comGitHub - playi/WonderPy: Official Public Python API for working with Wonder Workshop robots

Skip to content Why GitHub? Features → Code review Project management Integrations Actions Packages Security Team management Hosting Customer stories → Security → Enterprise Explore Explore GitHub → Learn & contribute Topics Collections Trending Learning Lab Open source guides Connect with others Events Community forum GitHub Education Marketplace Pricing Plans → Compare plans Contact Sales Nonprofit → Education → -- In this repository All GitHub ↵ Jump to ↵ No suggested jump to results In this repository All GitHub ↵ Jump to ↵ In this repository All GitHub ↵ Jump to ↵ Sign in Sign up playi / WonderPy Watch 14 Star 36 Fork 18 Code Issues 14 Pull requests 0 Actions Projects 0 Security Insights Dismiss Join GitHub today GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together. Sign up Official Public Python API for working with Wonder Workshop robots 68 commits 3 branches 0 packages 0 releases Fetching contributors MIT Python Python 100.0% Branch: master New pull request Find file Clone or download Clone with HTTPS Use Git or checkout with SVN using the web URL. Open in Desktop Download ZIP Downloading Want to be notified of new releases in playi/WonderPy ? Sign in Sign up Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Go back Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Go back Launching Xcode If nothing happens, download Xcode and try again. Go back Launching Visual Studio If nothing happens, download the GitHub extension for Visual Studio and try again. Go back elenzil Merge pull request #23 from davidko-ww/beacon_v2_robot_id … Added initial support for Beacon V2... Latest commit 8b3fc73 Oct 8, 2019 Permalink Type Name Latest commit message Commit time Failed to load latest commit information. WonderPy Added initial support for Beacon V2... Aug 14, 2019 doc fix typo: comand -> command Aug 23, 2018 test remove obsolete commands Jul 24, 2018 .gitignore gitignore egg-info Jul 20, 2018 .travis.yml #1 'tests' -> 'test' Jul 25, 2018 LICENSE license Jul 20, 2018 README.md requirements.txt requirements.txt.travis #1 travis doesn't support python for osx. (travis issue 2312) however… Jul 25, 2018 setup.py 0.1.0 Jul 31, 2018 setup.py.travis #1 travis doesn't support python for osx. (travis issue 2312) however… Jul 25, 2018 README.md WonderPy WonderPy is a Python package providing an interface to the WonderWorkshop robots Dash, Dot, and Cue. It has fine-grained realtime access to all the robot's commands and sensors. There is a companion repository with tutorials and examples. To get the most out of WonderPy, you should already have a beginner-level comfort with python and the command-line. Project Status WonderPy is current at an "Alpha" release. It's ready to be tried out by folks who are willing to live with a few more rough-edges than one would want, and ideally who can provide constructive criticism. Please see the "Issues" in github for an up-to-date list of known bugs and to-do items. Command Categories: eyering head media monoLED body RGB accessory Sensor Categories: accelerometer / gyroscope beacon buttons distance head angles pose speaker wheels Setup Prerequisites MacOS Python 2.7 Familiarity with python and the command-line Install hard dependencies All of these are required . pip pip is the standard package manager for python. It's used to install packages such as WonderPy and AdaFruit BLE, below. It can be tempting to skip installing this, but unfortunately it is required. Installing pip tends to vary significantly from system to system, so we can't provide specific instructions it. The best we can do is refer you to google to find the best match for your situation. Here's Google on the topic . VirtualEnv VirtualEnv is a system which enables you to be sure which version of Python you're running for WonderPy, and which packages are present. pip install virtualenv Depending on how you installed pip, you may need to sudo pip install virtualenv XCode Command Line Tools xcode-select --install You may need to install XCode, visit the Apple Developer site and search for "Command Line Tools". Then download and install the appropriate file based on your version of macOS and XCode. Some users may need to uninstall/reinstall Python 2.x afterwards, depending on their setup. (Since there are many ways python is installed, we don't provide instructions for that here) AdaFruit Python BTLE Package The AdaFruit BTLE package is not hosted on PyPi, which makes it difficult to automatically install when this package is installed via pip. Additionally, this project requires a fork of that project by WonderWorkshop, which as of this writing has not been merged back into the main project. pip install git+git://github.com/playi/Adafruit_Python_BluefruitLE@928669a#egg=Adafruit_BluefruitLE Create a new python virtual environment virtualenv --python=/usr/bin/python2.7 --no-site-packages venv source venv/bin/activate Install WonderPy pip install WonderPy Documentation Documentation is still also in Alpha stage. WonderPy readme WonderPy Robot Reference Manual Tutorials and other examples Getting Started The steps above install the core library. There are many examples of using it separately in the github repository playi/WonderPyExamples . It is highly recommended to look at those examples. To test basic functionality, run these at the command-line, inside your fresh virtualenv: download the "01_hello_world.py" tutorial example: curl -o 01_hello_world.py https://raw.githubusercontent.com/playi/WonderPyExamples/master/tutorial/01_hello_world.py run it: python 01_hello_world.py It should connect to any nearby robot and say hello ! Robot Connection Options Upon launching any of the examples, the app will scan for robots for at least 5 and at most 20 seconds. After scanning, whichever robot had the highest signal strength (RSSI) will be connected to. This is a reasonable approximation of connecting to the closest robot. Connection Options: [--connect-type cue | dot | dash] filter for robots of the specified type/s [--connect-name MY_ROBOT | MY_OTHER_ROBOT | ...] filter for robots with the specified name/s [--connect-eager] connect as soon as a qualified robot is discovered. do not wait the full scanning period. if there are more than one robot with matching criteria, the one with the best signal is still selected [--connect-ask] show a list of available robots, and interactively ask for input. indicates which has the highest signal strength. Connection Examples: Spend 5 seconds looking for all Cue and Dash robots which are named either "sammy" or "sally", and connect to the one with the best signal strength: python demos/roboFun.py --connect-type cue dash --connect-name sammy blippy sally Connect ASAP to any robot named 'orions robot', no matter what type of robot it is. python demos/roboFun.py --connect-eager --connect-name "orions robot" Known Issues and To-Do's Please see the "Issues" in github for an up-to-date list of known bugs and to-do items. As of this writing, the open issues are: Only works with a single robot. Only works with Python2.7. The limiting factor here is getting the AdaFruit BTLE package to run under Python3. There's evidence this is possible. Once under Python3, update the concurrency model. Flesh-out inline documentation. Make the pip installation more standard. Currently this requires a manual install of a github-based fork of the AdaFruit package. Port to Windows, Linux Feedback - Survey How is WonderPy working for you ? We're eager to hear. Please take time to fill out a survey ! Contribute Pull requests are welcome! Please check the list of issues and todo's at the WonderPy repository on github . Additional examples in the WonderPyExamples repository would also be great: Integrations with other cool packages IoT integrations Demos with the Sketch Kit accessory Feature requests for the API sh...