v3.1.0

This method was added in 30803fc.

.github/workflows/build.yml

@@ -1,7 +1,7 @@
 # This workflow will install Python dependencies, run tests and lint with a variety of Python versions
 # For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
 
-name: Python package
+name: Build Python package and docs
 
 on: [ push, pull_request ]
 
@@ -40,4 +40,4 @@ jobs:
         sudo apt-get update
         sudo apt-get install dvisvgm preview-latex-style texlive texlive-fonts-extra texlive-latex-extra
     - name: Build html docs for Pybricks Code IDE
-      run: poetry run make -C doc html SOURCEDIR=ide
+      run: poetry run make -C doc html TAG=ide

.github/workflows/publish-ide-docs.yml

@@ -31,8 +31,8 @@ jobs:
         node-version: '14.x'
         registry-url: 'https://registry.npmjs.org'
     - run: yarn build
-      working-directory: doc/ide
+      working-directory: npm/ide-docs
     - run: yarn publish
-      working-directory: doc/ide
+      working-directory: npm/ide-docs
       env:
         NODE_AUTH_TOKEN: ${{ secrets.NODE_AUTH_TOKEN }}

.github/workflows/release-to-pypi.yml

@@ -0,0 +1,22 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build_and_publish:
+    runs-on: ubuntu-20.04
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-python@v2
+      with:
+        python-version: 3.8
+    - uses: abatilo/actions-poetry@v2.0.0
+      with:
+        poetry-version: 1.1.6
+    - run: poetry install
+    - run: poetry build
+    - run: poetry publish
+      env:
+        POETRY_PYPI_TOKEN_PYPI: ${{ secrets.PYPI_TOKEN }}

.readthedocs.yaml

@@ -0,0 +1,22 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+#
+# Settings in the readthedocs online dashboard will be ignored.
+
+# Required
+version: 2
+
+# Build documentation in the doc/main directory with Sphinx
+sphinx:
+   configuration: doc/main/conf.py
+
+# Build your docs in additional formats such as PDF
+formats:
+   - pdf
+
+# Set the version of Python and requirements required to build the docs
+python:
+   version: 3.8
+   install:
+   - requirements: rtd-requirements.txt

.vscode/settings.json

@@ -6,7 +6,7 @@
     "python.linting.enabled": true,
     "python.languageServer": "Pylance",
     "files.associations": {"*.inc": "restructuredtext"},
-    "restructuredtext.confPath": "${workspaceFolder}/doc/api",
+    "restructuredtext.confPath": "${workspaceFolder}/doc/main",
     "spellright.language": [
         "en_US"
     ],

CHANGELOG.md

@@ -0,0 +1,93 @@
+# Changelog
+
+<!-- refer to https://keepachangelog.com/en/1.0.0/ for guidance -->
+
+## 3.1.0 - 2021-12-16
+
+### Added
+- Added maximum voltage setter for `DCMotor` and `Motor`.
+- Documented `DriveBase.curve()` method.
+
+### Changed
+- Removed `duty` setting from `Control.limits` method.
+- Removed `integral_range` setting from `Control.pid` method.
+
+### Fixed
+- Fixed link to Color Light Matrix page.
+- Fixed link to Inventor Hub page.
+
+## 3.1.0rc1 - 2021-11-19
+
+### Added
+- Added `ColorLightMatrix` class.
+- Added `LWP3Device` class.
+
+**NOTE: version number after this point were from JavaScript package and do
+not correspond to Pybricks firmware version numbers.**
+
+## 1.6.0 - 2021-08-30
+
+### Added
+- MicroPython module documentation.
+- Examples for hub system functions including stop button and shutdown.
+
+### Changed
+- Build IDE docs as main docs with minor changes, instead of a completely
+  separate build.
+- Moved motor control documentation to the motor page.
+
+## 1.5.0 - 2021-07-01
+
+### Added
+- Documentation for Powered Up Remote Control.
+
+## 1.4.0 - 2021-06-23
+
+### Added
+- Enabled beta content that was hidden for the 3.0 release.
+- Added notice about using the latest beta version.
+
+## 1.3.3 - 2021-05-21
+
+### Changed
+- Match example snippet styling to IDE.
+- Add more examples.
+
+## 1.3.2 - 2021-04-26
+
+## Changed
+- Theme style fixes.
+- Example code fixes
+- Match doc version to firmware version.
+
+## 1.3.1 - 2021-04-12
+
+### Changed
+- Upgrade sphinx and rtd-theme to fix style issues.
+
+## 1.3.0 - 2021-04-12
+
+### Removed
+- Removed features which not be in the official 3.0 release. These features
+  are still in beta. They'll come back in future releases once tested.
+
+## 1.2.0 - 2021-04-09
+
+### Changed
+- Moved installation guide to external site.
+
+## 1.1.1 - 2021-02-14
+
+### Added
+- Added installation guide.
+- Various documentation fixes.
+
+## 1.1.0 - 2021-01-28
+
+### Added
+- Scrollbar styling.
+
+## 1.0.0 - 2021-01-25
+
+### Added
+- Sphinx build output.

CONTRIBUTING.md

@@ -20,20 +20,23 @@ will actually be implemented.
 
 - Commit messages have a one-line subject, a blank line and a multiline body:
 
-        prefix: subject
+        prefix: Subject of the change.
 
         body...
 
-- Use a prefix to categorize the change. Usually this is the path the the file
-  being changed. 
-  - If it is a documentation change, it can be shortened to `doc/<file>` (omit
-    `api` from the path).
-  - If it is an API change (in the `pybricks` folder), write `api/<file>` 
-    instead of `pybricks/<file>`.
-- The subject briefly describes _what_ was changed, e.g. `fix typo`.
+- Use a prefix to categorize the change:
+  - Use the import path as the prefix whenever possible. Examples:
+     - pybricks.tools: Add StopWatch class.
+     - pybricks.tools: Reorganize RST files.
+     - pybricks.tools.StopWatch: Fix return type.
+     - pybricks.tools.wait: Add example of waiting.
+     - pybricks.pupdevices: Fix all sensor class ports.
+     - umath.sin: Fix spelling of Hypotenuse.
+  - If an import path makes no sense, just use the file path without extensions:
+     - .vscode/settings: Fix file associations.
+- The subject briefly describes _what_ was changed. Use a short full sentence as in the examples above.
 - The body describes _why_ the change was made, e.g. `The word "sensor" was
   spelled incorrectly`.
-- See the [commit history][commits] for more examples.
 
 [commits]: https://github.com/pybricks/pybricks-api/commits/master
 
@@ -59,15 +62,24 @@ Build docs:
 
     # Linux
     poetry run make -C doc html
-    xdg-open doc/api/build/html/index.html
+    xdg-open doc/main/build/html/index.html
 
     # macOS
     poetry run make -C doc html
-    open doc/api/build/html/index.html
+    open doc/main/build/html/index.html
 
     # Windows (PowerShell)
     poetry run doc\make.bat html
-    Invoke-Item doc\api\build\html\index.html
+    Invoke-Item doc\main\build\html\index.html
+
+Building IDE docs variant:
+
+    # Linux/macOS
+    poetry run make -C doc html TAG=ide
+
+    # Windows (PowerShell)
+    $env:TAG="ide"
+    poetry run doc\make.bat html
 
 Linting:
 

doc/Makefile

@@ -5,12 +5,13 @@
 SPHINXOPTS    = -W
 SPHINXBUILD   = sphinx-build
 SPHINXPROJ    = Pybricks
-SOURCEDIR     = api
+SOURCEDIR     = main
 BUILDDIR      = "$(SOURCEDIR)"/build
+TAG           = main
 
 # Put it first so that "make" without argument is like "make help".
 help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -t $(TAG) $(O)
 
 .PHONY: help Makefile
 
@@ -21,4 +22,4 @@ diagrams:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -t $(TAG) $(O)

doc/api/conf.py

@@ -1,22 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-#
-# Pybricks documentation build configuration file
-#
-import os
-
-# General information about the project.
-project = 'pybricks'
-copyright = '2018-2021 The Pybricks Authors'
-author = ''
-
-_TITLE = 'Pybricks Modules and Examples'
-_DISCLAIMER = 'LEGO, the LEGO logo, MINDSTORMS and the MINDSTORMS EV3 logo are\
-               trademarks and/or copyrights of the LEGO Group of companies \
-               which does not sponsor, authorize or endorse this site.'
-
-html_favicon = '../common/images/favicon.ico'
-html_logo = '../common/images/pybricks-logo-rtd.png'
-latex_logo = '../common/images/pybricks-logo-large.png'
-
-exec(open(os.path.abspath("../common/conf.py")).read())

doc/api/diagram_source/pupmotors.ldr

@@ -1,13 +0,0 @@
-0 Name: pupmotors.ldr
-0 Author: Pybricks {laurens@pybricks.com}
-0 !LICENSE MIT
-0 ROTATION CENTER 0 0 0 1 "Custom" 
-0 ROTATION CONFIG 0 0
-1 15 430 -96 190 0 0 1 1 0 0 0 1 0 54675c01.dat
-1 15 430 -96 400 0 0 1 1 0 0 0 1 0 54675c01.dat
-1 322 430 -72 30 0 0 1 1 0 0 0 1 0 54696c01.dat
-1 71 430 -72 -180 0 0 1 1 0 0 0 1 0 54696c01.dat
-1 71 190 -144 -180 1 0 0 0 1 0 0 0 1 22169c01.dat
-1 71 -20 -216 -140 1 0 0 0 1 0 0 0 1 22172c01.dat
-1 15 120 -320 160 1 0 0 0 1 0 0 0 1 26913c01.dat
-0

doc/api/hubs/index.rst

@@ -1,51 +0,0 @@
-:mod:`hubs <pybricks.hubs>` -- Programmable Hubs
-================================================
-
-.. module:: pybricks.hubs
-
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   movehub
-   cityhub
-   technichub
-   primehub
-   ev3brick
-
-.. pybricks-classlink:: MoveHub
-
-.. figure:: ../../api/images/movehub.png
-    :height: 10 em
-    :target: movehub.html
-
-.. pybricks-classlink:: CityHub
-
-.. figure:: ../../api/images/cityhub.png
-    :height: 10 em
-    :target: cityhub.html
-
-.. pybricks-classlink:: TechnicHub
-
-.. figure:: ../../api/images/technichub.png
-    :height: 10 em
-    :target: technichub.html
-
-.. pybricks-classlink:: PrimeHub
-
-.. figure:: ../../api/images/primehub.png
-    :height: 10 em
-    :target: primehub.html
-
-.. pybricks-classlink:: InventorHub
-
-.. figure:: ../../api/images/inventorhub.png
-    :height: 10 em
-    :target: primehub.html
-
-.. pybricks-classlink:: EV3Brick
-
-.. figure:: ../../api/images/ev3brick.png
-    :height: 10 em
-    :target: ev3brick.html
-

doc/api/hubs/movehub.rst

@@ -1,41 +0,0 @@
-Move Hub
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. _fig_movehub:
-
-.. figure:: ../../api/images/movehub_label.png
-    :height: 15 em
-
-.. autoclass:: pybricks.hubs.MoveHub
-    :no-members:
-
-    .. rubric:: Using the hub status light
-
-    .. automethod:: pybricks.hubs::MoveHub.light.on
-
-    .. automethod:: pybricks.hubs::MoveHub.light.off
-
-    .. automethod:: pybricks.hubs::MoveHub.light.blink
-
-    .. automethod:: pybricks.hubs::MoveHub.light.animate
-
-    .. rubric:: Using the battery
-
-    .. automethod:: pybricks.hubs::MoveHub.battery.voltage
-
-    .. automethod:: pybricks.hubs::MoveHub.battery.current
-
-Status light examples
----------------------
-
-Turning the light on and off
-******************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_movehub/light_off.py
-
-Making the light blink
-******************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_movehub/light_blink.py

doc/api/hubs/technichub.rst

@@ -1,99 +0,0 @@
-Technic Hub
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. figure:: ../../api/images/technichub.png
-    :height: 15 em
-
-.. autoclass:: pybricks.hubs.TechnicHub
-    :no-members:
-
-    .. rubric:: Using the hub status light
-
-    .. automethod:: pybricks.hubs::TechnicHub.light.on
-
-    .. automethod:: pybricks.hubs::TechnicHub.light.off
-
-    .. automethod:: pybricks.hubs::TechnicHub.light.blink
-
-    .. automethod:: pybricks.hubs::TechnicHub.light.animate
-
-    .. rubric:: Using the IMU
-
-    .. automethod:: pybricks.hubs::TechnicHub.imu.up
-
-    .. automethod:: pybricks.hubs::TechnicHub.imu.tilt
-
-    .. automethod:: pybricks.hubs::TechnicHub.imu.acceleration
-
-    .. automethod:: pybricks.hubs::TechnicHub.imu.angular_velocity
-
-    .. automethod:: pybricks.hubs::TechnicHub.imu.heading
-
-    .. automethod:: pybricks.hubs::TechnicHub.imu.reset_heading
-
-    .. rubric:: Using the battery
-
-    .. automethod:: pybricks.hubs::TechnicHub.battery.voltage
-
-    .. automethod:: pybricks.hubs::TechnicHub.battery.current
-
-Status light examples
----------------------
-
-Turning the light on and off
-****************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/light_off.py
-
-Changing brightness and using custom colors
-*******************************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/light_hsv.py
-
-Making the light blink
-**********************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/light_blink.py
-
-Creating light animations
-*************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/light_animate.py
-
-IMU examples
----------------
-
-Testing which way is up
-********************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/imu_up.py
-
-
-Reading the tilt value
-********************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/imu_tilt.py
-
-Using a custom hub orientation
-**************************************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/imu_tilt_blast.py
-
-Reading acceleration and angular velocity vectors
-**************************************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/imu_read_vector.py
-
-Reading acceleration and angular velocity on one axis
-*****************************************************
-
-.. literalinclude::
-    ../../../examples/pup/hub_technichub/imu_read_scalar.py

doc/api/index.rst

@@ -1,94 +0,0 @@
-Welcome to Pybricks!
-==================================================================
-
-This documentation has everything you need to install Pybricks and
-run your first scripts.
-
-
-**Step 1: Install Pybricks**
-
-Pybricks scripts are the same across all hubs. The only difference is in how
-you install Pybricks and how you run scripts. To get started, click one of
-the platforms below.
-
-.. list-table::
-
-   * - **MINDSTORMS EV3**
-     - **Powered Up (Technic/City/BOOST)**
-     - **SPIKE / MINDSTORMS Inventor**
-
-   * - .. image:: ../api/images/ev3brick.png
-         :target: start_ev3/index.html
-
-     - .. figure:: ../api/images/powereduphubs.png
-         :target: start_pup.html
-
-     - .. figure:: ../api/images/primeinventorhub.png
-          :target: start_inventor.html
-
-
-**Step 2: Start coding!**
-
-After you've followed the installation steps for your hub,
-check out the Pybricks modules in the left hand menu to see what
-you can do.
-
-**Step 3: Share what you made (or ask for help!)**
-
-Got questions or issues? Please share your
-findings on our `support page`_ so we can make Pybricks even better.
-*Thank you!*
-
-
-.. _support page: https://github.com/pybricks/support/issues/
-
-.. toctree::
-    :maxdepth: 1
-    :caption: Table of Contents
-    :hidden:
-
-.. toctree::
-    :maxdepth: 1
-    :caption: Pybricks
-    :hidden:
-
-    Home Page <https://pybricks.com>
-    Downloads <https://pybricks.com/downloads/>
-    Example Projects <https://github.com/pybricks/pybricks-projects>
-    Support <https://github.com/pybricks/support/issues/>
-    About Pybricks <https://pybricks.com/about/>
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Getting started
-   :hidden:
-
-   start_ev3/index
-   start_pup
-   start_inventor
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Pybricks Modules
-   :hidden:
-
-   hubs/index
-   pupdevices/index
-   ev3devices
-   nxtdevices
-   iodevices/index
-   parameters/index
-   tools/index
-   robotics
-   media
-   messaging
-   geometry
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Engineering Extras
-   :hidden:
-
-   signaltypes
-   motors
-..    frames

doc/api/iodevices/index.rst

@@ -1,61 +0,0 @@
-:mod:`iodevices <pybricks.iodevices>` -- Generic I/O Devices
-============================================================
-
-.. automodule:: pybricks.iodevices
-    :no-members:
-
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   pupdevice
-   i2cdevice
-   uartdevice
-   analogsensor
-   lumpdevice
-   dcmotor
-   ev3devsensor
-
-.. pybricks-classlink:: PUPDevice
-
-.. figure:: ../../api/images/sensor_pup.png
-   :width: 70 %
-   :target: pupdevice.html
-
-   This class is only available on Powered Up hubs.
-
-.. pybricks-classlink:: I2CDevice
-
-.. figure:: ../../api/images/sensor_rj12_bluegreen.png
-   :width: 25 %
-   :target: i2cdevice.html
-
-.. pybricks-classlink:: UARTDevice
-
-.. figure:: ../../api/images/sensor_rj12_gray.png
-   :width: 25 %
-   :target: uartdevice.html
-
-.. pybricks-classlink:: AnalogSensor
-
-.. figure:: ../../api/images/sensor_rj12_brown.png
-   :width: 25 %
-   :target: analogsensor.html
-
-.. pybricks-classlink:: LUMPDevice
-
-.. figure:: ../../api/images/sensor_rj12_green.png
-   :width: 25 %
-   :target: lumpdevice.html
-
-.. pybricks-classlink:: DCMotor
-
-.. figure:: ../../api/images/rcxmotor.png
-   :width: 40 %
-   :target: dcmotor.html
-
-.. pybricks-classlink:: Ev3devSensor
-
-.. figure:: ../../api/images/sensor_ev3dev.png
-   :width: 70 %
-   :target: ev3devsensor.html

doc/api/motors.rst

@@ -1,139 +0,0 @@
-More about Motors
-===========================================
-
-.. Motor Tips & Tricks
-.. ^^^^^^^^^^^^^^^^^^^
-
-.. The difference between ``run_angle`` and ``run_target``
-.. -------------------------------------------------------
-
-.. *TODO*
-
-.. .. _absangles:
-
-.. Absolute angles
-.. ----------------------------
-
-.. .. todo::
-
-..     This section will be included in a future release.
-
-.. .. _stalled:
-
-.. Using stall detection
-.. ---------------------
-
-.. .. todo::
-
-..     This section will be included in a future release.
-
-.. When a motor cannot move any further despite using the maximally allowed
-.. torque we say that the motor is stalled. Something could be blocking the
-.. motor, or the load is just too heavy. For example, if you manually hold
-.. the motor shaft still while the motor is busy executing a command, the
-.. motor will stall.
-
-.. What can I do with stall detection?
-.. +++++++++++++++++++++++++++++++++++
-
-.. Stall detection is useful to detect that a motor can't move any further.
-.. This can be used to detect an endpoint of a mechanism. For example, you
-.. can detect whether a robotic hand is fully closed, because the gripper
-.. motor simply can't go further. This way, you don't need a touch or light
-.. sensor to detect this.
-
-.. *TODO: How, what, why. Explain run_until_stalled. Rack & pinion example.*
-
-.. When is a motor stalled?
-.. ++++++++++++++++++++++++
-
-.. TODO
-
-.. .. _gears:
-
-.. Using gears
-.. -----------------
-
-.. .. todo::
-
-..     This section will be included in a future release.
-
-.. Many LEGO robots use mechanisms with gears to change the speed and torque
-.. output of a motor. Let's consider the following dial mechanism.
-
-.. *TODO: INSERT PICTURE OF MOTOR WITH 12z gear AND 36z gear.*
-
-.. This gear train slows down the dial on the output axle by a factor of 3.
-.. Therefore, if you want to rotate the dial by 90 degrees, the motor has to
-.. rotate by 270 degrees. To turn at 200 degrees per second, the motor has to
-.. turn at 600 degrees per second, and so on.
-
-.. To avoid using this factor 3 everywhere in your program, you can use the
-.. `gears` setting of the ``Motor`` object, as shown in this example::
-
-..     # This example uses the EV3 brick, but the same
-..     # technique applies to other programmable hubs.
-..     ev3 = EV3Brick()
-
-..     # Initialize the motor. See picture above.
-..     dial = Motor(Port.C, Direction.COUNTERCLOCKWISE, gears=[12, 36])
-
-..     # Turn the dial by 90-degrees
-..     dial.run_angle(500, 90)
-
-..     # Print the dial angle
-..     print(dial.angle())
-
-..     # Turn the dial back to the original position
-..     dial.run_target(500, 0)
-
-.. When you use any of the other methods, the same scaling is applied. For
-.. example, you can print the angle of the dial as shown above. This will print
-.. 90 (approximately), even though the motor has turned 270 degrees.
-
-.. Notice that there is no magic going on. It is just a convenient scaling
-.. function. This helps you organize your code. For example, if you change
-.. your mechanism to use different gears, you only have to change the first
-.. line of this example.
-
-.. _control:
-
-The Control Class
-^^^^^^^^^^^^^^^^^
-
-The ``Motor`` class uses PID control to accurately track your commanded target
-angles. Similarly, the ``DriveBase`` class uses two of such controllers:
-one to control the heading and one to control the traveled distance.
-
-You can change the control settings through the following attributes, which are
-instances of the ``Control`` class given below.:
-
-    - ``Motor.control``
-    - ``DriveBase.heading_control``
-    - ``DriveBase.distance_control``
-
-You can only change the settings while the controller is stopped. For example,
-you can set the settings at the beginning of your program. Alternatively, first
-call ``stop()`` to make your ``Motor`` or ``DriveBase`` stop, and then change
-the settings.
-
-.. autoclass:: pybricks._common.Control
-    :no-members:
-
-    .. rubric:: Status
-
-    .. automethod:: pybricks._common.Control.done
-
-    .. automethod:: pybricks._common.Control.stalled
-
-    .. automethod:: pybricks._common.Control.load
-
-    .. rubric:: Settings
-
-    .. automethod:: pybricks._common.Control.limits
-
-    .. automethod:: pybricks._common.Control.pid
-
-    .. automethod:: pybricks._common.Control.target_tolerances
-
-    .. automethod:: pybricks._common.Control.stall_tolerances

doc/api/parameters/port.rst

@@ -1,38 +0,0 @@
-Port
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. class:: Port
-
-    Input and output ports:
-
-    .. autoattribute:: pybricks.parameters.Port.A
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.B
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.C
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.D
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.E
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.F
-        :annotation:
-
-    EV3 Sensor ports:
-
-    .. autoattribute:: pybricks.parameters.Port.S1
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.S2
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.S3
-        :annotation:
-
-    .. autoattribute:: pybricks.parameters.Port.S4
-        :annotation:

doc/api/pupdevices/remote.rst

@@ -1,23 +0,0 @@
-Remote Control
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. warning::
-
-    This remote is not yet supported.
-    Upvote `this issue <https://github.com/pybricks/support/issues/186>`_ if
-    you want to see this happen.
-
-.. figure:: ../../api/images/pupremote.png
-   :width: 60 %
-
-.. autoclass:: pybricks.pupdevices.Remote
-  :no-members:
-
-  .. autoattribute:: pybricks.pupdevices::Remote.address
-       :annotation:
-
-  .. automethod:: pybricks.pupdevices::Remote.light.on
-
-  .. automethod:: pybricks.pupdevices::Remote.light.off
-
-  .. automethod:: pybricks.pupdevices::Remote.buttons.pressed

doc/api/start_ev3/index.rst

@@ -1,23 +0,0 @@
-MINDSTORMS EV3
-########################
-
-.. note::
-
-   This documentation is for EV3 MicroPython with Pybricks **3.0**.
-
-   Click `here`_ to view the documentation EV3 MicroPython **2.0**. This is
-   is the stable version officially supported by `LEGO Education`_.
-
-.. rubric:: Table of contents
-
-.. toctree::
-   :maxdepth: 1
-
-   start_ev3_install
-   start_ev3_brick
-   start_ev3_run
-   start_ev3_linux
-   start_ev3_upgrade
-
-.. _here: https://pybricks.github.io/ev3-micropython/index.html
-.. _LEGO Education: https://education.lego.com/en-us/support/mindstorms-ev3/python-for-ev3

doc/api/start_ev3/start_ev3_brick.rst

@@ -1,81 +0,0 @@
-Using the EV3 Brick
-===================
-
-Make sure the EV3 Brick is turned off. Insert the microSD card you prepared
-into the microSD card slot on the EV3 Brick, as shown in :numref:`fig_sd`.
-
-.. _fig_sd:
-
-.. figure:: ../../api/images/sd_label.png
-   :width: 75 %
-   :alt: sd
-   :align: center
-
-   Inserting the flashed microSD card into the EV3 Brick
-
-
-Turning the EV3 Brick on and off
------------------------------------------------------------
-
-Turn on the EV3 Brick by pressing the dark gray center button.
-
-The boot process may take several minutes. While booting, the EV3 Brick status
-light turns orange and blinks intermittently, and you'll see a lot of text on
-the EV3 screen. The EV3 Brick is ready for use when the status light turns
-green.
-
-To turn the EV3 Brick off, open the shutdown menu with the back button, and
-then select *Power Off* using the center button, as shown
-in :numref:`fig_onoff`.
-
-.. _fig_onoff:
-
-.. figure:: ../../api/images/onoff_label.png
-   :width: 65 %
-   :alt: onoff
-   :align: center
-
-   Turning the EV3 Brick off
-
-Viewing motor and sensor values
------------------------------------------------------------
-
-When you're not running a program, you can view motor and sensor values using
-the device browser, as shown in :numref:`fig_devicebrowser`.
-
-.. _fig_devicebrowser:
-
-.. figure:: ../../api/images/devicebrowser_label.png
-   :width: 100 %
-   :alt: devicebrowser
-   :align: center
-
-   Viewing motor and sensor values
-
-Running a program without a computer
------------------------------------------------------------
-
-You can run previously downloaded programs directly from the EV3 Brick.
-
-To do so, find the program using the *file browser* on the EV3 screen and press
-the center button key to start the program as shown in :numref:`fig_manualrun`.
-
-.. _fig_manualrun:
-
-.. figure:: ../../api/images/manualrun_label.png
-   :width: 100 %
-   :alt: manualrun
-   :align: center
-
-   Starting a program using the buttons on the EV3 Brick
-
-Going back to the original firmware
------------------------------------------------------------
-
-You can go back to the LEGO® firmware and your LEGO programs at any time. To
-do so:
-
-1. Turn the EV3 Brick off as shown above.
-2. Wait for the screen and brick status light to turn off.
-3. Remove the microSD card.
-4. Turn the EV3 on.

doc/api/start_ev3/start_ev3_install.rst

@@ -1,118 +0,0 @@
-Installation
-===================
-
-This page guides you through the steps to collect and install everything you
-need to start programming.
-
-What do you need?
------------------------------------------------------------
-
-To get started, you'll need:
-
-- A Windows 10 or Mac OS computer
-- Internet access and administrator access
-
-    This is required during the installation only. You will not need special
-    access to write and run programs later on.
-
-- A microSD card
-
-    You'll need a card with a minimum capacity of 4GB and a maximum capacity
-    of 32GB. This type of microSD card is also known as microSDHC. We recommend
-    cards with Application Performance Class A1.
-
-- A microSD card slot or card reader in your computer
-
-    If your computer does not have a (micro)SD card slot, you can use an
-    external USB (micro)SD card reader.
-
-- A mini-USB cable, like the one included with your EV3 set
-
-The typical configuration of this equipment is summarized
-in :numref:`fig_overview`.
-
-.. _fig_overview:
-
-.. figure:: ../../api/images/overview_label.png
-   :width: 90 %
-   :alt: overview
-   :align: center
-
-   Setup overview
-
-Preparing your computer
------------------------------------------------------------
-
-You'll write your MicroPython programs using Visual Studio Code. Follow the
-steps below to download, install, and configure this application:
-
-1. Download `Visual Studio Code <https://code.visualstudio.com/Download>`_.
-2. Follow the on-screen instructions to install the application.
-3. Launch Visual Studio Code.
-4. Open the extensions tab.
-5. Install the EV3 MicroPython extension as shown in :numref:`fig_store`.
-
-.. _fig_store:
-
-.. figure:: ../../api/images/store_label.png
-    :alt: store
-    :align: center
-
-    Installing the extension from the Visual Studio Code marketplace
-
-.. _prepsdcard:
-
-Preparing the microSD card
------------------------------------------------------------
-
-To make it possible to run MicroPython programs on your EV3 Brick, you'll now
-learn how to install the required tools on your microSD card.
-
-If the microSD card contains files you want to keep, make sure to create a
-backup of its contents first.
-See :ref:`managing files on the EV3 <managefiles>` to learn how to backup your
-previous MicroPython programs if necessary.
-
-*This process erases everything on your microSD card, including any previous
-MicroPython programs on it.*
-
-
-To install the MicroPython tools on your microSD card:
-
-1. Download the `EV3 MicroPython microSD card image`_ and save it in a
-   convenient location. This file is approximately 360 MB. You do **not** need
-   to unzip the file.
-2. Download and install a microSD card flashing tool
-   such as `Etcher <https://www.balena.io/etcher/>`_.
-3. Insert the microSD card into your computer or card reader.
-4. Launch the flashing tool and follow the steps on your screen to install
-   the file you have just downloaded. If you use Etcher, you can follow the
-   instructions below, as shown in :numref:`fig_etcher`.
-
-    a. Select the EV3 MicroPython microSD card image file you have just
-       downloaded.
-    b. Select your microSD card. Make sure that the device and size correspond
-       to your microSD card.
-    c. Start the flashing process. This may take several minutes. Do not remove
-       the card until the flashing process is complete.
-
-.. _fig_etcher:
-
-.. figure:: ../../api/images/etcher_label.png
-   :width: 85 %
-   :alt: etcher
-   :align: center
-
-   Using Etcher to flash the EV3 MicroPython microSD card image
-
-Updating the microSD card
------------------------------------------------------------
-
-To update the microSD card, download a new image file using the link above and
-flash it to the microSD card as described above. Be sure
-to :ref:`back up any MicroPython programs you want to save <managefiles>`.
-
-You do not need to erase the contents of the microSD card first. This is done
-automatically when you flash the new image file.
-
-.. _EV3 MicroPython microSD card image: https://education.lego.com/en-us/product-resources/mindstorms-ev3/teacher-resources/python-for-ev3

doc/api/start_ev3/start_ev3_linux.rst

@@ -1,101 +0,0 @@
-Accessing advanced EV3 features
-===============================
-
-MicroPython runs on top of `ev3dev`_, which is a specific version of Linux.
-Linux is an *operating system*. (Other popular operating
-systems are Microsoft Windows and Apple macOS.) This means that your EV3 is
-almost like a real computer, just much smaller.
-
-The Linux command line
------------------------------------------
-
-Although your EV3 Brick is quite like a real computer, you do not interact with
-it using a big screen and a mouse. Instead, you can access files and programs
-on it using the *command line*. It is also called the *terminal*.
-
-Follow the steps in :numref:`fig_terminal` to access the command line. Now
-you can enter commands by typing them in and pressing enter.
-
-.. _fig_terminal:
-
-.. figure:: ../../api/images/terminal_label.png
-   :width: 100 %
-   :alt: files
-   :align: center
-
-   Opening the Linux command line and running the ``ls`` command.
-
-**Running basic commands**
-
-For example, if you type the following command and press enter::
-
-   ls
-
-then you will see the contents of the current folder. :numref:`fig_terminal`
-shows the result: it listed the project folder of the ``getting_started``
-project that we just ran.
-
-If you type the following command and press enter::
-
-   exit
-
-then the command line will be closed. Alternatively, click the garbage icon
-shown in :numref:`fig_terminal`.
-
-You can copy text from the command line by selecting it and
-then pressing ``ctrl`` ``shift`` ``c``.
-You can paste text into the command line
-using ``ctrl`` ``shift`` ``v``.
-
-**Running commands as an administrator**
-
-Some commands require a password to run. This is similar to administrative
-tasks on your computer or tablet, such as installing a new app. These commands
-work like any other command, but you add ``sudo`` in front of
-them.
-
-As an exercise, you can run the following command to turn the EV3 Brick off::
-
-   sudo poweroff
-
-You will be prompted for a password. Type ``maker`` and then press ``Enter``.
-
-.. warning::
-
-   Only run commands with ``sudo`` if you know what you are doing.
-
-**Learning more about the command line**
-
-To learn more about the command line and many of the available commands, we
-recommend reading the beginner-friendly free ebook
-called `The Linux Command Line`_.
-
-To learn more about ev3dev-specific tips and tricks, visit the `ev3dev`_
-website.
-
-.. _hostname:
-
-Changing the EV3 Brick name
------------------------------------------------------------
-
-When you search for your EV3 using Visual Studio Code, you see all EV3 Bricks
-listed by their name. By default, all EV3 Bricks are named *ev3dev*. Follow
-these steps to change that name:
-
-   1. Open Visual Studio Code and connect to your EV3 as usual.
-   2. Read the steps above about running commands as an administrator.
-   3. Think of a good name. In this example, we'll
-      call it ``autonomous-vehicle2``
-   4. Enter the following command and press enter::
-
-         sudo hostnamectl set-hostname autonomous-vehicle2
-
-   5. Reboot the EV3 Brick for the change to take effect.
-   6. You may need to reboot your computer as well.
-
-EV3 Brick names should only contain lowercase letters ``a`` through ``z``,
-the digits ``0`` through ``9``, and the hyphen ``-``. It must start with a
-letter or digit. It cannot include spaces or other symbols.
-
-.. _ev3dev: https://www.ev3dev.org/
-.. _The Linux Command Line: http://linuxcommand.org/tlcl.php

doc/api/start_ev3/start_ev3_run.rst

@@ -1,166 +0,0 @@
-Creating and running programs
-=============================
-
-Now that you've set up your computer and EV3 Brick, you're ready to start
-writing programs.
-
-To make it easier to create and manage your programs, let's first have a quick
-look at how MicroPython projects and programs for your EV3 robots are
-organized.
-
-Programs are organized into *project folders*, as shown in
-:numref:`fig_projectstructure`. A project folder is a directory on your
-computer that contains the main program (**main.py**) and other optional
-scripts or files. This project folder and all of its contents will be copied
-to the EV3 Brick, where the main program will be run.
-
-This page shows you how to create such a project and how to transfer it to the
-EV3 Brick.
-
-.. _fig_projectstructure:
-
-.. figure:: ../../api/images/projectstructure_label.png
-   :width: 100 %
-   :alt: projectstructure
-   :align: center
-
-   A project contains a program called **main.py** and optional resources like
-   sounds or MicroPython modules.
-
-
-Creating a new project
------------------------------------------------------------
-
-To create a new project, open the EV3 MicroPython tab and
-click *create a new project*, as shown in :numref:`fig_newproject`. Enter a
-project name in the text field that appears and press *Enter*. When prompted,
-choose a location for this program and confirm by clicking *choose folder*.
-
-.. _fig_newproject:
-
-.. figure:: ../../api/images/newproject_label.png
-   :width: 100 %
-   :alt: newproject
-   :align: center
-
-   Creating a new project. This example is called *getting_started*, but you
-   can choose any name.
-
-When you create a new project, it already includes a file called *main.py*. To
-see its contents and to modify it, open it from the file browser as shown in
-:numref:`fig_projectoverview`. This is where you'll write your programs.
-
-If you are new to MicroPython programming, we recommend that you keep the
-existing code in place and add your code to it.
-
-.. _fig_projectoverview:
-
-.. figure:: ../../api/images/projectoverview_label.png
-   :width: 100 %
-   :alt: projectoverview
-   :align: center
-
-   Opening the default *main.py* program.
-
-Opening an existing project
------------------------------------------------------------
-
-To open a project you created previously, click *File* and click
-*Open Folder*, as shown in :numref:`fig_existingproject`. Next, navigate to
-your previously created project folder and click *OK*. You can also open your
-recently used projects using the *Open Recent* menu option.
-
-.. _fig_existingproject:
-
-.. figure:: ../../api/images/existingproject_label.png
-   :width: 75 %
-   :alt: existingproject
-   :align: center
-
-   Opening a previously created project.
-
-
-Connecting to the EV3 Brick with Visual Studio Code
------------------------------------------------------------
-
-To be able to transfer your code to the EV3 Brick, you'll first need to
-connect the EV3 Brick to your computer with the mini-USB cable and configure
-the connection with Visual Studio Code. To do so:
-
-- Turn the EV3 Brick on
-- Connect the EV3 Brick to your computer with the mini-USB cable
-- Configure the USB connection as shown in :numref:`fig_connecting`.
-
-.. _fig_connecting:
-
-.. figure:: ../../api/images/connecting_label.png
-   :width: 100 %
-   :alt: connecting
-   :align: center
-
-   Configuring the USB connection between the computer and the EV3 Brick
-
-Downloading and running a program
------------------------------------------------------------
-
-You can press the F5 key to run the program. Alternatively, you can start it
-manually by going to the *debug* tab and clicking the green start arrow, as
-shown in :numref:`fig_running`.
-
-When the program starts, a pop-up toolbar allows you to stop the program if
-necessary. You can also stop the program at any time using the back button on
-the EV3 Brick.
-
-If your program produces any output with the ``print`` command, this is shown
-in the output window.
-
-.. _fig_running:
-
-.. figure:: ../../api/images/running_label.png
-   :width: 100 %
-   :alt: running
-   :align: center
-
-   Running a program
-
-Expanding the example program
------------------------------------------------------------
-
-Now that you've run the basic code template, you can expand the program to
-make a motor move. First, attach a Large Motor to Port B on the EV3 Brick,
-as shown  in :numref:`fig_firstprogram`.
-
-.. _fig_firstprogram:
-
-.. figure:: ../../api/images/firstprogram_label.png
-   :width: 100 %
-   :alt: firstprogram
-   :align: center
-
-   The EV3 Brick with a Large Motor attached to port B.
-
-Next, edit *main.py* to make it look like this:
-
-.. literalinclude::
-   ../../../examples/ev3/getting_started/main.py
-
-This program makes your robot beep, rotate the motor, and beep again with a
-higher pitched tone. Run the program to make sure that it works as expected.
-
-.. _managefiles:
-
-Managing files on the EV3 Brick
------------------------------------------------------------
-
-After you've downloaded a project to the EV3 Brick, you can run, delete, or
-back up programs stored on it using the device browser as shown in
-:numref:`fig_files`.
-
-.. _fig_files:
-
-.. figure:: ../../api/images/files_label.png
-   :width: 100 %
-   :alt: files
-   :align: center
-
-   Using the EV3 device browser to manage files on your EV3 Brick

doc/api/start_ev3/start_ev3_upgrade.rst

@@ -1,248 +0,0 @@
-Upgrading from v1.0 to v2.0
-===============================
-
-*EV3 MicroPython version 2.0 was released on May 18, 2020.*
-
-This section is for users who have previously used LEGO MINDSTORMS EV3
-MicroPython v1.0. We'll explain what's changed and how you can upgrade to
-benefit from the latest improvements.
-
-If you are a new user and you just got started using version 2.0, you can skip
-this page.
-
-Upgrading the microSD Card
------------------------------------------
-
-To upgrade, download the latest microSD card file and install it using the
-standard :ref:`instructions <prepsdcard>`.
-
-Note that this will erase all your existing files on the SD Card. Before you
-upgrade, make sure that you still have all your projects on your computer.
-If not, you can upload files back to your computer using
-:ref:`these instructions <managefiles>`.
-
-As with any software update, *be careful about when you update*. For example,
-if you developed your code using version v1.0 and you are halfway into your
-robotics competition season, you may want to stick with v1.0 for now.
-
-
-Upgrading your existing programs
------------------------------------------
-
-Most changes in v2.0 are *new* features, like support for additional sensors.
-Naturally, this will not affect your existing code.
-However, some changes were made to existing features to improve performance.
-
-All originally documented features in v1.0 will still work after you upgrade.
-This means that most programs originally made for v1.0 will work with the v2.0
-microSD card image without any changes.
-
-To try this, simply download and run your original code as you did before.
-
-However, it is recommended that you upgrade both the microSD card and your
-programs at the same time to ensure everything works as expected.
-
-The new EV3Brick() class replaces the ev3brick module
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Version 2.0 introduces the :class:`EV3Brick() <pybricks.hubs.EV3Brick>` class.
-You can use it instead of the old  ``ev3brick`` module. The old ``ev3brick``
-module can still be used, but it is no longer recommended or documented.
-
-The :class:`EV3Brick() <pybricks.hubs.EV3Brick>` class improves the speed and
-reliability of the EV3 screen and the EV3 speaker. It also adds functionality
-like speech and drawing shapes. The default
-font size is also bigger to make it easier to read text on the screen.
-
-You can use
-the following table as a starting point to upgrade your scripts. See the
-:class:`EV3Brick() <pybricks.hubs.EV3Brick>` class documentation for
-complete details of all methods and arguments.
-
-.. list-table::
-
-  * - **Action**
-    - **v1.0**
-    - **v2.0**
-
-  * - | Initialize
-      | your EV3
-    - ::
-
-          from pybricks import ev3brick as brick
-    - ::
-
-          from pybricks.hubs import EV3Brick
-
-          ev3 = EV3Brick()
-
-  * - | Light on
-    - ::
-
-          brick.light(Color.RED)
-    - ::
-
-          ev3.light.on(Color.RED)
-
-  * - | Light off
-    - ::
-
-          brick.light(None)
-    - ::
-
-          ev3.light.off()
-
-  * - | Read
-      | Buttons
-    - ::
-
-          if Button.LEFT in brick.buttons():
-              print("Left is pressed.")
-    - ::
-
-          if Button.LEFT in ev3.buttons.pressed():
-              print("Left is pressed.")
-
-  * - | Play a
-      | beep
-    - ::
-
-          brick.sound.beep()
-    - ::
-
-          ev3.speaker.beep()
-
-  * - | Play a
-      | sound file
-    - ::
-
-          brick.sound.file(SoundFile.HELLO)
-    - ::
-
-          ev3.speaker.play_file(SoundFile.HELLO)
-
-  * - | Text to
-      | speech
-    -
-    - ::
-
-          ev3.speaker.say("I can say anything!")
-
-  * - | Play
-      | notes
-    -
-    - ::
-
-          ev3.speaker.play_notes(['C4/4', 'G4/4'])
-
-  * - | Write text
-      | at a given
-      | position
-    - ::
-
-          brick.display.text("Hello!", (50, 60))
-    - ::
-
-          ev3.screen.draw_text(50, 60, "Hello!")
-
-  * - | Write text
-      | and scroll
-      | automatically
-    - ::
-
-          brick.display.text("Hello")
-          brick.display.text("world!")
-    - ::
-
-          ev3.screen.print("Hello")
-          ev3.screen.print("world!")
-
-  * - | Change font
-      | size
-    -
-    - ::
-
-          from pybricks.media.ev3dev import Font
-
-          big_font = Font(size=24)
-          ev3.screen.set_font(big_font)
-
-  * - | Display an
-      | image on
-      | the screen
-    - ::
-
-          from pybricks.parameters import ImageFile
-
-          brick.display.image(ImageFile.QUESTION_MARK)
-    - ::
-
-          from pybricks.media.ev3dev import ImageFile
-
-          ev3.screen.load_image(ImageFile.Question_MARK)
-
-  * - | Draw shapes
-      | on the screen
-    -
-    - ::
-
-          ev3.screen.draw_line(30, 30, 30, 100)
-          ev3.screen.draw_box(50, 30, 90, 60)
-          ev3.screen.draw_circle(70, 90, 20, fill=True)
-
-  * - | Read
-      | battery
-      | voltage
-    - ::
-
-          brick.battery.voltage()
-    - ::
-
-          ev3.battery.voltage()
-
-
-Other internal changes to existing features
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-- Most methods of the ``Motor`` class now
-  have ``Stop.HOLD`` as the default instead of ``Stop.COAST``. This improves
-  accuracy in most applications. You can still select ``Stop.COAST`` if you
-  like.
-- The internal PID controllers for the motors are more accurate than before.
-  If you give a motor command when it is already running, it smoothly adjusts
-  the speed to the newly given command. This works even if you keep
-  adjusting the speed in a fast loop.
-- Methods to configure motor settings have changed. You can change settings
-  using the ``control`` attribute now. The old settings setters
-  continue to exist in the implementation, but they are no longer documented.
-- So-called Python *keyword arguments* are now supported. Previously, you
-  could only enter the argument *values*. For example:
-
-   ::
-
-       my_motor.run_angle(500, 90, Stop.HOLD, False)
-
-  This is still possible. But you can now choose to omit optional arguments
-  and specify others with *keywords*. This can make your code easier to read.
-  For example:
-
-   ::
-
-      my_motor.run_angle(500, 90, wait=False)
-- It is no longer necessary to import ``pybricks.tools.print``. The ``print``
-  function is now built-in. It works just like Python or MicroPython.
-- Most parameters in the :mod:`parameters <pybricks.parameters>` now have a
-  specific type and representation. For example, suppose you measure a color
-  and print the result. If you do ``print(Color.RED)``, you will see the
-  parameter instead of a technical number.
-- Sound and image files have moved to a dedicated ``media`` module.
-  Importing them from the old location will continue to work in this release,
-  to make sure existing scripts will still work.
-
-**Installing an older version of the Visual Studio Code extension**
-
-The Visual Studio Code extension and this documentation are updated
-automatically. You can still use your existing scripts with the updated
-extension. If you absolutely wish to keep the old version, look for the EV3
-extension on the extension tab, click the gear icon, and
-click *install another version*.

doc/api/start_inventor.rst

@@ -1,4 +0,0 @@
-SPIKE Prime / Robot Inventor
-########################################################
-
-Coming soon!

doc/api/start_pup.rst

@@ -1,176 +0,0 @@
-.. _pupguide:
-
-Powered Up
-########################
-
-.. figure:: ../api/images/powereduphubs.png
-    :height: 15 em
-    :align: center
-
-This page shows how you can install Pybricks on the BOOST Move Hub, the City
-Hub, and the Technic Hub using the `Pybricks Code`_ interface.
-
-You can reinstall the :ref:`original firmware <restoring>` at any time
-using the official Powered Up app.
-
-1. Requirements
---------------------------------------
-
-* A BOOST Move Hub, City Hub, or Technic Hub.
-* A Windows, Mac, Linux, or Android device.
-* Bluetooth Low Energy (BLE). Make sure that Bluetooth is switched on.
-
-If you don't have BLE, the coding interface will inform you during the
-installation step. In that case, you can try using a low-cost USB Bluetooth
-Dongle thats support Bluetooth Low Energy.
-
-2. Installing a compatible browser
----------------------------------------------------
-
-Writing Pybricks programs requires a web browser with web Bluetooth
-functionality, such as:
-
-    * `Google Chrome`_
-    * `Microsoft Edge`_
-    * Chromium
-
-If you use Linux, enable *Experimental Web Platform features* on
-the ``chrome://flags/`` page. On Windows and Mac, this is already enabled.
-
-3. Installing the Pybricks firmware
------------------------------------
-
-Before you begin, turn the hub off. The update works best with fresh batteries.
-If you use the City Hub, you must unplug all motors and sensors. Follow these
-steps:
-
-1. Go to `Pybricks Code`_.
-2. Press and hold the green button, and wait for the light to start blinking.
-3. While you hold it, click the firmware update button.
-4. Select the ``LEGO Bootloader`` and click *Pair*.
-5. Wait until the light goes off and until it blinks red/green/blue again.
-6. You may now release the button and wait for the installation to finish.
-
-These steps are summarized in this video:
-
-.. raw:: html
-
-    <video controls src="https://pybricks.com/wp-content/uploads/2020/06/install.mp4" width="100%"></video>
-    <br /><br />
-
-
-4. Running programs
---------------------------------
-
-Once the firmware is installed, you can start coding! Use the *Bluetooth*
-button to connect to your *Pybricks Hub*. Then press run to
-start your program.
-
-.. figure:: ../api/images/pybrickscode.png
-
-To get started, just copy and paste this snippet::
-
-    from pybricks.pupdevices import Motor
-    from pybricks.parameters import Port, Stop
-    from pybricks.tools import wait
-
-    # We'll use two motors. One is a dial
-    # to set the speed of the other motor.
-    motor = Motor(Port.B)
-    dial = Motor(Port.A)
-
-    # Say hello :)
-    print("Hello, Pybricks!")
-
-    # First, we'll move the dial to zero.
-    dial.run_target(500, 0, Stop.COAST)
-
-    while True:
-        # Set the speed based on dial angle
-        speed = dial.angle()*3
-        if abs(speed) < 100:
-            speed = 0
-
-        # Run motor at desired speed
-        motor.run(speed)
-
-        # Wait briefly, then repeat
-        wait(10)
-
-5. Next steps
------------------------------------------
-
-Now that you've learned how to install Pybricks and run programs, check out
-the steps below to make Pybricks coding even easier. We'll also show you how
-you can restore the original firmware.
-
-Saving a program on the hub
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The Move Hub, City Hub, and Technic Hub do not have separate storage space
-for user programs. This means your program is erased after it is done running.
-Fortunately, you can still save one program on the hub, by including it in the
-firmware. To do so:
-
-1. Open the settings tab with the ⚙ icon.
-2. Activate the *Include current program* switch.
-3. Update the firmware as you did before. Now, your current program will be
-   included.
-4. Now can start and stop your program with the green button.
-   No connection required!
-5. You can still download and run new programs with the run button as usual.
-
-This is a bit of a slow process to do each time. We recommend to
-use the run button to run your code most of the time. When you are
-happy with your final program, follow the steps above to save it on the hub.
-
-Using Pybricks offline
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Instead of working in your browser, you can install Pybricks locally:
-
-1. Open the settings tab with the ⚙ icon.
-2. Click on *Install as App* and follow the on-screen instructions.
-
-To uninstall, click the ⋮ menu in the top and
-click *Uninstall*. Note that this only removes the app from your computer.
-To restore the original firmware on the hub, see the next section.
-
-.. _restoring:
-
-Restoring the original firmware
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Pybricks uses the same update procedure as the LEGO apps. The only difference
-is which firmware file we upload. This means you can go back to the original
-firmware any time. As shown in the video below, just put the hub in update mode
-and connect using a LEGO app.
-
-.. raw:: html
-
-    <video controls src="https://pybricks.com/wp-content/uploads/2020/06/restore.mp4" width="100%"></video>
-
-This video shows the Powered Up app in *create* mode. It has firmware for all
-hubs. As usual, you may need to restart the app to detect the hub. If it fails,
-try again with fresh batteries.
-
-Installing the latest build
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. warning::
-
-   This section is only intended for developers who want to try the
-   latest features. Some features may not work when you do this. To revert
-   to a stable version, just install the firmware as you normally would.
-
-Pybricks Code automatically provides the latest stable and tested firmware.
-To get a more recent version, log in to GitHub and go to our `latest builds`_.
-Click on the desired build and go to `Artifacts`.
-Download the firmware ZIP archive for your hub. To install it, drag this file
-*onto* the firmware update button in Pybricks Code. The update now proceeds as
-usual.
-
-.. _latest builds: https://github.com/pybricks/pybricks-micropython/actions?query=is%3Asuccess+branch%3Amaster+workflow%3ABuild
-.. _support page: https://github.com/pybricks/support/issues/
-.. _Pybricks Code: http://code.pybricks.com/
-.. _Google Chrome: https://www.google.com/chrome/
-.. _Microsoft Edge: https://www.microsoft.com/en-us/edge

doc/common/_static/js/ide.js

@@ -1,3 +1,4 @@
+// Since Pybricks Code is an "app", all external links get opened in new tab/window
 // https://stackoverflow.com/a/62742435/1976323
 $(document).ready(function () {
     $('a[href^="http://"], a[href^="https://"]').not('a[class*=internal]').attr('target', '_blank');

doc/common/conf.py

@@ -27,11 +27,10 @@ from docutils import nodes
 from docutils.parsers.rst.directives import flag
 from docutils.parsers.rst import Directive
 from sphinx.application import Sphinx
-from sphinx.domains.python import PyClassmember, PythonDomain
 import toml
 
 TOP_DIR = os.path.abspath(os.path.join('..', '..'))
-sys.path.insert(0, TOP_DIR)
+sys.path.insert(0, os.path.join(TOP_DIR, 'src'))
 sys.path.append(os.path.abspath('../common/extensions'))
 
 from pybricks.hubs import EV3Brick  # noqa E402
@@ -60,6 +59,8 @@ extensions = [
     'sphinx.ext.mathjax',
     'color',
     'classlink',
+    'requirements',
+    'requirements-static',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -91,7 +92,7 @@ version = re.match(r'(v\d+\.\d+)', release)[0]
 language = None
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = 'xcode'
 
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
@@ -128,6 +129,20 @@ nitpick_ignore = [
     ('py:exc', 'ValueError'),
 ]
 
+# not sure why, but this is needed for typing.IO in uselect
+nitpick_ignore.append(('py:class', 'IO'))
+
+# Workaround until change below is released.
+# https://github.com/sphinx-doc/sphinx/commit/86091934db5ec593b4b0c982b7f08f3231ef995b
+nitpick_ignore.extend([
+    ('py:class', '0'),
+    ('py:class', '1'),
+    ('py:class', '2'),
+    ('py:class', '3'),
+    ('py:class', 'big'),
+    ('py:class', 'little'),
+])
+
 # -- Autodoc options ------------------------------------------------------
 
 autodoc_member_order = 'bysource'
@@ -147,11 +162,6 @@ else:
     html_theme = 'sphinx_rtd_theme'
     html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
-# a little extra javascript
-html_js_files = [
-    'js/custom.js'
-]
-
 html_context = {
     'disclaimer': _DISCLAIMER,
 }
@@ -249,7 +259,27 @@ latex_documents = [
      author, 'manual'),
 ]
 
-# -- Options for manual page output ---------------------------------------
+# -- Content control -----------------------------------------------------
+
+
+exclude_patterns = [
+    'ev3devices.rst',
+    'hubs/ev3brick.rst',
+    'hubs/primehub.rst',
+    'geometry.rst',
+    'iodevices/analogsensor.rst',
+    'iodevices/dcmotor.rst',
+    'iodevices/ev3devsensor.rst',
+    'iodevices/i2cdevice.rst',
+    'iodevices/lumpdevice.rst',
+    'iodevices/lwp3device.rst',
+    'iodevices/uartdevice.rst',
+    'media.rst',
+    'messaging.rst',
+    'nxtdevices.rst',
+    'tools/datalog.rst'
+]
+
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
@@ -295,44 +325,3 @@ def setup(app: Sphinx):
 
 
 # -- Python domain hacks ---------------------------------------------------
-
-real_get_signature_prefix = PyClassmember.get_signature_prefix
-
-
-def get_signature_prefix(self, sig):
-    # hacks for battery and light
-    if sig.count('.') >= 2:
-        return ''
-    return real_get_signature_prefix(self, sig)
-
-
-PyClassmember.get_signature_prefix = get_signature_prefix
-
-
-# HACK: For certain hub attributes, we list the class members of the attributes
-# class as if the attribute was a nested class so that readers don't have to
-# skip around the docs as much. To make this work, we replace the attribute
-# values with the type and override PythonDomain.find_obj so that references
-# still work.
-
-base_find_obj = PythonDomain.find_obj
-
-
-def find_obj(self, env, modname, classname, name, type, searchmode=0):
-    if modname == 'pybricks.hubs':
-        if classname == 'screen':
-            if name.startswith('Font.') or name == 'Font':
-                modname = 'pybricks.media.ev3dev'
-            elif name.startswith('Image.') or name == 'Image':
-                modname = 'pybricks.media.ev3dev'
-            else:
-                classname = 'EV3Brick.screen'
-        elif classname == 'speaker':
-            classname = 'EV3Brick.speaker'
-    return base_find_obj(self, env, modname, classname, name, type, searchmode)
-
-
-PythonDomain.find_obj = find_obj
-
-EV3Brick.screen = Image
-EV3Brick.speaker = Speaker

doc/common/extensions/classlink.py

@@ -5,13 +5,15 @@ from docutils.parsers.rst import Directive
 class PybricksClasslinkDirective(Directive):
 
     required_arguments = 1
+    optional_arguments = 1
 
     def run(self):
-        # Get link name from sphinx-directive
+        # Get link and name from sphinx-directive
         name = self.arguments[0]
+        link = name if len(self.arguments) == 1 else self.arguments[1]
 
         html = (
-            '<a href="{0}.html">'.format(name.lower()) +
+            '<a href="{0}.html">'.format(link.lower()) +
             '<dl class="py class">' +
             '<dt>' +
             '<em class="property">class </em>' +

doc/common/extensions/requirements-static.py

@@ -0,0 +1,101 @@
+from os import path, makedirs
+
+from docutils import nodes
+from docutils.parsers.rst import Directive
+
+from sphinx.util.osutil import copyfile
+
+# Base feature set.
+FEATURES_SMALL = set()
+
+# Medium feature set.
+FEATURES_MEDIUM = FEATURES_SMALL | {
+    'pybricks-geometry',
+    'pybricks-iodevices',
+    'stm32-extra',
+    'stm32-float',
+}
+
+# Large feature set.
+FEATURES_LARGE = FEATURES_MEDIUM | set()
+
+# Features per hub.
+HUB_FEATURES = {
+    'movehub': {'movehub'} | FEATURES_SMALL,
+    'cityhub': {'cityhub'} | FEATURES_MEDIUM,
+    'technichub': {'technichub'} | FEATURES_MEDIUM,
+    'primehub':  {'primehub', 'inventorhub'} | FEATURES_LARGE,
+    'inventorhub':  {'primehub', 'inventorhub'} | FEATURES_LARGE,
+}
+
+
+class PybricksRequirementsStaticDirective(Directive):
+
+    required_arguments = 0
+    optional_arguments = 10
+
+    def run(self):
+
+        # Copy required resources to static
+        # CC BY-SA 4.0 via https://stackoverflow.com/a/63728208
+        env = self.state.document.settings.env
+
+        destdir = path.join(env.app.builder.outdir, '_images')
+        if not path.exists(destdir):
+            makedirs(destdir)
+
+        for hub in HUB_FEATURES:
+            for compat in ("true", "false"):
+                uri = 'compat_{0}_{1}_label.png'.format(hub, compat)
+                src_uri = path.join(env.app.builder.srcdir, 'images', uri)
+                build_uri = path.join(env.app.builder.outdir, '_images', uri)
+                copyfile(src_uri, build_uri)
+
+        # Get requirements from sphinx-directive.
+        requirements = set(self.arguments)
+
+        # Cell with image of a hub.
+        hub_cell = """
+        <th><div class="align-default">
+        <img alt="" src="{0}_images/compat_{1}_{2}_label.png">
+        </div></th>
+        """
+
+        # Determine how far up the tree we are to set correct image path.
+        current_document = env.docname
+        depth = len(current_document.split("/")) - 1
+        depth_path = "../" * depth
+
+        # Table row with hub images.
+        compat_row = "".join([
+            hub_cell.format(
+                depth_path,
+                hub,
+                "true" if requirements <= features else "false")
+            for hub, features in HUB_FEATURES.items()
+        ])
+
+        # Generate full table.
+        html = """
+        <div class="wy-table-responsive">
+            <table class="docutils align-default">
+                <tbody>
+                    <tr>
+                        {0}
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+        """.format(compat_row)
+
+        # Return the node.
+        node = nodes.raw('', html, format="html")
+        return [node]
+
+
+def setup(app):
+    app.add_directive_to_domain(
+        'py',
+        'pybricks-requirements-static',
+        PybricksRequirementsStaticDirective
+    )

doc/common/extensions/requirements.css

@@ -0,0 +1,44 @@
+/*MIT License
+
+Copyright (c) 2017 Robert, https://github.com/ulrobix/sphinxcontrib-contentui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. */
+
+.toggle-header {
+    display: block;
+    float: right;
+    clear: both;
+    cursor: pointer;
+}
+.toggle-header p {display: inline;}
+.toggle-header strong {color: #2980b9 }
+
+.toggle-header:after {
+    content: "Compatibility ▼";
+}
+
+.toggle-header.open:after {
+    content: "▲";
+}
+
+.toggle-content {
+    display: none;
+    margin-bottom: 0px;
+}
+

doc/common/extensions/requirements.js

@@ -0,0 +1,33 @@
+/*MIT License
+
+Copyright (c) 2017 Robert, https://github.com/ulrobix/sphinxcontrib-contentui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. */
+
+$(function() {
+    /**
+     * Toggle logic
+     */
+    $('.toggle-content').hide()
+    $('.toggle-header').click(function () {
+        $(this).toggleClass("open");
+        $(this).next('.toggle-content').toggle('400');
+    })
+});
+

doc/common/extensions/requirements.py

@@ -0,0 +1,79 @@
+# MIT License
+
+# Copyright (c) 2017 Robert, https://github.com/ulrobix/sphinxcontrib-requirements
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+
+import os
+from docutils.parsers.rst import Directive, directives
+from docutils import nodes
+from docutils.statemachine import StringList
+from sphinx.util.osutil import copyfile
+from sphinx.util import logging
+
+
+CSS_FILE = 'requirements.css'
+JS_FILE = 'requirements.js'
+
+
+class PybricksRequirementsDirective(Directive):
+    has_content = True
+    option_spec = {'header': directives.unchanged}
+
+    required_arguments = 0
+    optional_arguments = 10
+
+    def run(self):
+        node = nodes.container()
+        node['classes'].append('toggle-content')
+
+        par = nodes.container()
+        par['classes'].append('toggle-header')
+
+        content = '.. pybricks-requirements-static:: ' + " ".join(self.arguments)
+
+        self.state.nested_parse(StringList([content]), self.content_offset, node)
+
+        return [par, node]
+
+
+def add_assets(app):
+    app.add_css_file(CSS_FILE)
+    app.add_js_file(JS_FILE)
+
+
+def copy_assets(app, exception):
+    if app.builder.name not in ['html', 'readthedocs'] or exception:
+        return
+    logger = logging.getLogger(__name__)
+    logger.info('Copying requirements stylesheet/javascript... ', nonl=True)
+    dest = os.path.join(app.builder.outdir, '_static', CSS_FILE)
+    source = os.path.join(os.path.abspath(os.path.dirname(__file__)), CSS_FILE)
+    copyfile(source, dest)
+    dest = os.path.join(app.builder.outdir, '_static', JS_FILE)
+    source = os.path.join(os.path.abspath(os.path.dirname(__file__)), JS_FILE)
+    copyfile(source, dest)
+    logger.info('done')
+
+
+def setup(app):
+    app.add_directive('pybricks-requirements', PybricksRequirementsDirective)
+    app.connect('builder-inited', add_assets)
+    app.connect('build-finished', copy_assets)

doc/ide/CHANGELOG.md

@@ -1,15 +0,0 @@
-# 1.1.1 - 2021-02-14
-
-## Added:
-- Added installation guide.
-- Various documentation fixes.
-
-# 1.1.0 - 2021-01-28
-
-## Added:
-- Scrollbar styling.
-
-# 1.0.0 - 2021-01-25
-
-## Added:
-- Sphinx build output.

doc/ide/conf.py

@@ -1,32 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-#
-# Pybricks documentation build configuration file
-#
-import os
-
-# General information about the project.
-project = 'pybricks'
-copyright = '2018-2021 The Pybricks Authors'
-author = ''
-
-_TITLE = 'Pybricks Modules and Examples'
-_DISCLAIMER = ''
-
-html_favicon = '../common/images/favicon.ico'
-html_logo = '../common/images/pybricks-logo-rtd.png'
-html_show_copyright = False
-html_show_sphinx = False
-html_css_files = ['css/ide.css']
-
-imgmath_image_format = 'svg'
-imgmath_use_preview = True  # requires Sphinx v3
-imgmath_latex_preamble = r'''
-\usepackage{newtxsf}
-'''
-
-exec(open(os.path.abspath("../common/conf.py")).read())
-
-extensions.remove('sphinx.ext.mathjax')  # noqa F821
-extensions.append('sphinx.ext.imgmath')  # noqa F821
-html_theme_options['prev_next_buttons_location'] = None  # noqa F821

doc/ide/diagram_source/Makefile

@@ -1,25 +0,0 @@
-
-SRC_DIR = .
-OUT_DIR = ../images
-
-POSTFIX := _label
-SVG := $(wildcard $(SRC_DIR)/*.svg)
-DIAGRAMS := $(patsubst $(SRC_DIR)/%.svg,$(OUT_DIR)/%$(POSTFIX).png,$(SVG))
-DIR := ${CURDIR}
-
-all: $(DIAGRAMS)
-
-clean:
-	rm -f $(DIAGRAMS)
-
-$(OUT_DIR)/%$(POSTFIX).png: $(SRC_DIR)/%.svg
-	if inkscape --version | grep -q "Inkscape 0"; then \
-		inkscape --file=$(DIR)/$< --export-area-drawing --export-png=$(DIR)/$@; \
-	else \
-		inkscape \
-			--export-area-drawing \
-			--export-background=white \
-			--export-background-opacity=1.0 \
-			--export-file=$(DIR)/$@ \
-			$(DIR)/$<; \
-	fi

doc/ide/geometry.rst

@@ -1 +0,0 @@
-.. include:: ../api/geometry.rst

doc/ide/hubs/cityhub.rst

@@ -1 +0,0 @@
-.. include:: ../../api/hubs/cityhub.rst

doc/ide/hubs/index.rst

@@ -1,43 +0,0 @@
-:mod:`hubs <pybricks.hubs>` -- Programmable Hubs
-================================================
-
-.. module:: pybricks.hubs
-
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   movehub
-   cityhub
-   technichub
-   primehub
-
-.. pybricks-classlink:: MoveHub
-
-.. figure:: ../../api/images/movehub.png
-    :height: 10 em
-    :target: movehub.html
-
-.. pybricks-classlink:: CityHub
-
-.. figure:: ../../api/images/cityhub.png
-    :height: 10 em
-    :target: cityhub.html
-
-.. pybricks-classlink:: TechnicHub
-
-.. figure:: ../../api/images/technichub.png
-    :height: 10 em
-    :target: technichub.html
-
-.. pybricks-classlink:: PrimeHub
-
-.. figure:: ../../api/images/primehub.png
-    :height: 10 em
-    :target: primehub.html
-
-.. pybricks-classlink:: InventorHub
-
-.. figure:: ../../api/images/inventorhub.png
-    :height: 10 em
-    :target: primehub.html

doc/ide/hubs/movehub.rst

@@ -1 +0,0 @@
-.. include:: ../../api/hubs/movehub.rst

doc/ide/hubs/primehub.rst

@@ -1 +0,0 @@
-.. include:: ../../api/hubs/primehub.rst

doc/ide/hubs/technichub.rst

@@ -1 +0,0 @@
-.. include:: ../../api/hubs/technichub.rst

doc/ide/index.rst

@@ -1,49 +0,0 @@
-Pybricks Documentation
-==================================================================
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Getting started
-   :hidden:
-
-   start_pup
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Pybricks Modules
-   :hidden:
-
-   hubs/index
-   pupdevices/index
-   iodevices/index
-   parameters/index
-   tools/index
-   robotics
-   geometry
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Engineering Extras
-   :hidden:
-
-   signaltypes
-   motors
-
-Use the ☰ menu to navigate all available classes, methods, and tools. A few
-commonly used devices and classes are listed below for quick reference.
-
-.. rubric:: Installation
-
-Click :ref:`to jump to the installation guide <pupguide>`.
-
-.. rubric:: Programmable Hubs
-
-.. figure:: ../api/images/hubsoverview.png
-   :width: 100 %
-   :target: hubs/index.html
-
-.. rubric:: Powered Up Motors and Sensors
-
-.. figure:: ../api/images/pupdevicesoverview.png
-   :width: 100 %
-   :target: pupdevices/index.html

doc/ide/iodevices/index.rst

@@ -1,17 +0,0 @@
-:mod:`iodevices <pybricks.iodevices>` -- Generic I/O Devices
-============================================================
-
-.. automodule:: pybricks.iodevices
-    :no-members:
-
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   pupdevice
-
-.. pybricks-classlink:: PUPDevice
-
-.. figure:: ../../api/images/sensor_pup.png
-   :width: 70 %
-   :target: pupdevice.html

doc/ide/iodevices/pupdevice.rst

@@ -1 +0,0 @@
-.. include:: ../../api/iodevices/pupdevice.rst

doc/ide/motors.rst

@@ -1 +0,0 @@
-.. include:: ../api/motors.rst

doc/ide/parameters/button.rst

@@ -1 +0,0 @@
-.. include:: ../../api/parameters/button.rst

doc/ide/parameters/color.rst

@@ -1 +0,0 @@
-.. include:: ../../api/parameters/color.rst

doc/ide/parameters/direction.rst

@@ -1 +0,0 @@
-.. include:: ../../api/parameters/direction.rst

doc/ide/parameters/index.rst

@@ -1 +0,0 @@
-.. include:: ../../api/parameters/index.rst

doc/ide/parameters/side.rst

@@ -1 +0,0 @@
-.. include:: ../../api/parameters/side.rst

doc/ide/parameters/stop.rst

@@ -1 +0,0 @@
-.. include:: ../../api/parameters/stop.rst

doc/ide/pupdevices/colordistancesensor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/colordistancesensor.rst

doc/ide/pupdevices/colorsensor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/colorsensor.rst

doc/ide/pupdevices/dcmotor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/dcmotor.rst

doc/ide/pupdevices/forcesensor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/forcesensor.rst

doc/ide/pupdevices/index.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/index.rst

doc/ide/pupdevices/infraredsensor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/infraredsensor.rst

doc/ide/pupdevices/light.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/light.rst

doc/ide/pupdevices/motor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/motor.rst

doc/ide/pupdevices/pfmotor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/pfmotor.rst

doc/ide/pupdevices/remote.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/remote.rst

doc/ide/pupdevices/tiltsensor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/tiltsensor.rst

doc/ide/pupdevices/ultrasonicsensor.rst

@@ -1 +0,0 @@
-.. include:: ../../api/pupdevices/ultrasonicsensor.rst

doc/ide/robotics.rst

@@ -1 +0,0 @@
-.. include:: ../api/robotics.rst

doc/ide/signaltypes.rst

@@ -1 +0,0 @@
-.. include:: ../api/signaltypes.rst

doc/ide/start_pup.rst

@@ -1 +0,0 @@
-.. include:: ../api/start_pup.rst

doc/ide/tools/datalog.rst

@@ -1,10 +0,0 @@
-Data logging
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note::
-
-   This functionality is not yet available. It could be added
-   to Powered Up hubs in a future release. If you'd like to see this happen,
-   be sure to ask us on our `support page`_.
-
-.. _support page: https://github.com/pybricks/support/issues/

doc/ide/tools/index.rst

@@ -1 +0,0 @@
-.. include:: ../../api/tools/index.rst

doc/main/conf.py

@@ -0,0 +1,50 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# Pybricks documentation build configuration file
+#
+import os
+
+# General information about the project.
+project = 'pybricks'
+copyright = '2018-2021 The Pybricks Authors'
+author = ''
+
+_TITLE = 'Pybricks Modules and Examples'
+_DISCLAIMER = 'LEGO, the LEGO logo, MINDSTORMS and the MINDSTORMS EV3 logo are\
+               trademarks and/or copyrights of the LEGO Group of companies \
+               which does not sponsor, authorize or endorse this site.'
+
+html_favicon = '../common/images/favicon.ico'
+html_logo = '../common/images/pybricks-logo-rtd.png'
+latex_logo = '../common/images/pybricks-logo-large.png'
+
+# Build main docs for RTD by default.
+# Since tags cannot be passed via the TAG make variable on read the docs,
+# add it manually.
+if os.environ.get('READTHEDOCS', None) == 'True':
+    tags.add('main')  # noqa F821
+
+
+# Addtional configuration of the IDE docs
+if 'ide' in tags.tags:  # noqa F821
+    _DISCLAIMER = ''
+    html_show_copyright = False
+    html_show_sphinx = False
+    html_css_files = ['css/ide.css']
+    html_js_files = ['js/ide.js']
+
+    imgmath_image_format = 'svg'
+    imgmath_use_preview = True  # requires Sphinx v3
+    imgmath_latex_preamble = r'''
+    \usepackage{newtxsf}
+    '''
+
+exec(open(os.path.abspath("../common/conf.py")).read())
+
+# Addtional configuration of the IDE docs
+if 'ide' in tags.tags:  # noqa F821
+
+    extensions.remove('sphinx.ext.mathjax')  # noqa F821
+    extensions.append('sphinx.ext.imgmath')  # noqa F821
+    html_theme_options['prev_next_buttons_location'] = None  # noqa F821

doc/main/diagram_source/compat_cityhub_false.svg

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_cityhub_false.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="3.5527137e-15"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/cityhub.png"
+       xlink:href="../images/cityhub.png"
+       style="stroke-width:5.6583333"
+       width="30.908323"
+       height="31.75"
+       preserveAspectRatio="none"
+       id="image1470"
+       x="5.2042809"
+       y="263.16479" />
+    <g
+       id="g862"
+       transform="matrix(0.84064533,0,0,0.84993509,-12.416361,243.07822)"
+       style="stroke-width:1.18304348">
+      <path
+         inkscape:connector-curvature="0"
+         id="path856"
+         d="m 51.33389,24.998882 5.622395,5.622396"
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+      <path
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         d="M 56.956285,24.998882 51.33389,30.621278"
+         id="path858"
+         inkscape:connector-curvature="0" />
+    </g>
+  </g>
+</svg>

doc/main/diagram_source/compat_cityhub_true.svg

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_cityhub_true.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="4.4408921e-16"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/cityhub.png"
+       xlink:href="../images/cityhub.png"
+       style="stroke-width:5.6583333"
+       width="30.908323"
+       height="31.75"
+       preserveAspectRatio="none"
+       id="image1470"
+       x="5.2042809"
+       y="263.16479" />
+    <path
+       style="fill:none;stroke:#84ba4c;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 31.147057,265.82725 1.011052,2.9815 3.622948,-4.60003"
+       id="path854"
+       inkscape:connector-curvature="0" />
+  </g>
+</svg>

doc/main/diagram_source/compat_inventorhub_false.svg

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_inventorhub_false.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="0"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/inventorhub.png"
+       xlink:href="../images/inventorhub.png"
+       style="stroke-width:5.92592621"
+       width="34.915073"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1481"
+       x="2.6458333"
+       y="261.28122" />
+    <g
+       id="g862"
+       transform="matrix(0.84064533,0,0,0.84993509,-12.416361,243.07822)"
+       style="stroke-width:1.18304348">
+      <path
+         inkscape:connector-curvature="0"
+         id="path856"
+         d="m 51.33389,24.998882 5.622395,5.622396"
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+      <path
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         d="M 56.956285,24.998882 51.33389,30.621278"
+         id="path858"
+         inkscape:connector-curvature="0" />
+    </g>
+  </g>
+</svg>

doc/main/diagram_source/compat_inventorhub_true.svg

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_inventorhub_true.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="3.5527137e-15"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/inventorhub.png"
+       xlink:href="../images/inventorhub.png"
+       style="stroke-width:5.92592621"
+       width="34.915073"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1481"
+       x="2.6458333"
+       y="261.28122" />
+    <path
+       style="fill:none;stroke:#84ba4c;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 31.147057,265.82725 1.011052,2.9815 3.622948,-4.60003"
+       id="path854"
+       inkscape:connector-curvature="0" />
+  </g>
+</svg>

doc/main/diagram_source/compat_movehub_false.svg

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_movehub_false.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="3.5527137e-15"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/movehub.png"
+       xlink:href="../images/movehub.png"
+       transform="translate(25.390602,-51.6498)"
+       clip-path="url(#clipPath1545)"
+       style="stroke-width:5.92592621"
+       width="40.183594"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1492"
+       x="-25.506657"
+       y="312.93103" />
+    <g
+       id="g862"
+       transform="matrix(0.84064533,0,0,0.84993509,-12.416361,243.07822)"
+       style="stroke-width:1.18304348">
+      <path
+         inkscape:connector-curvature="0"
+         id="path856"
+         d="m 51.33389,24.998882 5.622395,5.622396"
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+      <path
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         d="M 56.956285,24.998882 51.33389,30.621278"
+         id="path858"
+         inkscape:connector-curvature="0" />
+    </g>
+  </g>
+</svg>

doc/main/diagram_source/compat_movehub_true.svg

@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_movehub_true.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="69.775738"
+     inkscape:cy="79.243654"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="7.1054274e-15"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/movehub.png"
+       xlink:href="../images/movehub.png"
+       transform="translate(25.390602,-51.6498)"
+       clip-path="url(#clipPath1545)"
+       style="stroke-width:5.92592621"
+       width="40.183594"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1492"
+       x="-25.506657"
+       y="312.93103" />
+    <path
+       style="fill:none;stroke:#84ba4c;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 31.147057,265.82725 1.011052,2.9815 3.622948,-4.60003"
+       id="path854"
+       inkscape:connector-curvature="0" />
+  </g>
+</svg>

doc/main/diagram_source/compat_primehub_false.svg

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_primehub_false.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="0"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/primehub.png"
+       xlink:href="../images/primehub.png"
+       style="stroke-width:5.92592621"
+       width="34.915073"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1503"
+       x="2.6458333"
+       y="261.28122" />
+    <g
+       id="g862"
+       transform="matrix(0.84064533,0,0,0.84993509,-12.416361,243.07822)"
+       style="stroke-width:1.18304348">
+      <path
+         inkscape:connector-curvature="0"
+         id="path856"
+         d="m 51.33389,24.998882 5.622395,5.622396"
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+      <path
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         d="M 56.956285,24.998882 51.33389,30.621278"
+         id="path858"
+         inkscape:connector-curvature="0" />
+    </g>
+  </g>
+</svg>

doc/main/diagram_source/compat_primehub_true.svg

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_primehub_true.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="0"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/primehub.png"
+       xlink:href="../images/primehub.png"
+       style="stroke-width:5.92592621"
+       width="34.915073"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1503"
+       x="2.6458333"
+       y="261.28122" />
+    <path
+       style="fill:none;stroke:#84ba4c;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 31.147057,265.82725 1.011052,2.9815 3.622948,-4.60003"
+       id="path854"
+       inkscape:connector-curvature="0" />
+  </g>
+</svg>

doc/main/diagram_source/compat_technichub_false.svg

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_technichub_false.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="10.681815"
+     inkscape:cy="89.597718"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1920"
+     inkscape:window-height="1172"
+     inkscape:window-x="1920"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="0"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/technichub.png"
+       xlink:href="../images/technichub.png"
+       style="stroke-width:5.92592621"
+       width="35.71875"
+       height="35.71875"
+       preserveAspectRatio="none"
+       id="image1514"
+       x="2.1503351"
+       y="261.28122" />
+    <g
+       id="g862"
+       transform="matrix(0.84064533,0,0,0.84993509,-12.416361,243.07822)"
+       style="stroke-width:1.18304348">
+      <path
+         inkscape:connector-curvature="0"
+         id="path856"
+         d="m 51.33389,24.998882 5.622395,5.622396"
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+      <path
+         style="fill:none;stroke:#e2302f;stroke-width:1.18304348;stroke-linecap:round;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         d="M 56.956285,24.998882 51.33389,30.621278"
+         id="path858"
+         inkscape:connector-curvature="0" />
+    </g>
+  </g>
+</svg>

doc/main/diagram_source/compat_technichub_true.svg

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="150"
+   height="135"
+   viewBox="0 0 39.687499 35.718751"
+   version="1.1"
+   id="svg887"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="compat_technichub_true.svg">
+  <defs
+     id="defs881">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath1545">
+      <rect
+         style="fill:#fe2020;fill-opacity:0.48022599;stroke:none;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+         id="rect1547"
+         width="39.6875"
+         height="35.71875"
+         x="-25.390602"
+         y="312.93103" />
+    </clipPath>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#fcfcfc"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:zoom="3.959798"
+     inkscape:cx="51.592993"
+     inkscape:cy="94.901019"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     units="px"
+     inkscape:window-width="1853"
+     inkscape:window-height="1145"
+     inkscape:window-x="67"
+     inkscape:window-y="27"
+     inkscape:window-maximized="1"
+     inkscape:snap-global="false" />
+  <metadata
+     id="metadata884">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-261.28123)">
+    <rect
+       style="fill:#fcfcfc;fill-opacity:1;stroke:none;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:normal"
+       id="rect819"
+       width="39.6875"
+       height="35.71875"
+       x="0"
+       y="261.28122" />
+    <image
+       sodipodi:absref="../images/technichub.png"
+       xlink:href="../images/technichub.png"
+       y="261.28122"
+       x="2.1503351"
+       id="image1514"
+       preserveAspectRatio="none"
+       height="35.71875"
+       width="35.71875"
+       style="stroke-width:5.92592621" />
+    <path
+       style="fill:none;stroke:#84ba4c;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="m 31.147057,265.82725 1.011052,2.9815 3.622948,-4.60003"
+       id="path854"
+       inkscape:connector-curvature="0" />
+  </g>
+</svg>