David Lechner
0c611fabab
doc/conf.py: add contentui css when building on readthedocs.org
2020-03-13 13:07:08 -05:00
David Lechner
abe24cf289
api/builtin: add missing DCMotor.stop() method
...
This was missing. It also has a different default value
from the Motor class, so Motor overrides this method.
2020-03-12 12:52:27 -05:00
David Lechner
cab16f6af7
api/media/ev3dev: add Image/screen save method
...
This was overlooked previously.
2020-03-06 12:59:42 -06:00
Laurens Valk
ffae01fd0c
config: move project specifics to own conf.py
...
Each target doc build can have it own parameters.
2020-03-05 14:07:31 +01:00
Laurens Valk
a1dce8e50e
config: use doc agnostic paths for images
...
Allow files like messaging .rst to be included without having to copy the images.
2020-03-05 13:05:34 +01:00
Laurens Valk
3c317967af
config: separate make target for diagrams
...
Separate the build step and commit the output to the repository. This way the docs can be built on platforms that do not have inkscape, such as readthedocs.
pipenv run make -C doc diagrams
pipenv run make -C doc html
2020-03-04 11:49:21 +01:00
Laurens Valk
8861be68eb
config: remove diagram builder from common
...
This has no image targets, so remove to avoid confusion.
2020-03-04 11:43:37 +01:00
Laurens Valk
862f881d33
config: rename _images to diagram_source
...
Make it clear what it really is.
2020-03-04 11:40:34 +01:00
Laurens Valk
95ee2fa885
doc: remove unused images
2020-03-04 11:32:37 +01:00
Laurens Valk
921fd74896
doc/messaging: fix typo in server/client diagram
2020-03-02 10:31:23 +01:00
David Lechner
c76395d07f
doc/media/ev3dev: sort images and sounds
...
Put image and sound files in alphabetical order. Exception made for
sorting numbers by numerical order.
2020-02-26 19:06:44 -06:00
Laurens Valk
5288a7e75d
doc/iodevices/Ev3devSensor: add links and examples
2020-02-25 10:29:40 +01:00
Laurens Valk
a426d412bb
doc/iodevices: add preliminary warning
2020-02-20 16:29:13 +01:00
Laurens Valk
a0fba6c2d1
api/builtins/Control: Move stalled to control
...
This is a control status property, so move it to the control class. This way, it is hidden from the common motor methods, and DriveBases will be able to use it too.
2020-02-17 13:55:45 +01:00
Laurens Valk
9db7e95959
api/robotics: DriveBase: rename settings args
...
Make it explicit that these arguments affect only the settings for the corresponding methods.
Also rephrase a few docstrings to make them easier to read or fix typos.
2020-02-17 13:43:48 +01:00
Laurens Valk
9c6d2267bd
api/nxtdevices/ColorSensor: add rgb and light
...
also, remove detection of brown color, because this is not supported
2020-02-14 19:26:05 +01:00
Laurens Valk
0ea4c22670
api/tools: add DataLog
2020-02-14 11:47:43 +01:00
Laurens Valk
250dfc63b5
api/tools: remove print
...
Going forward, we are using the builtin print function.
2020-02-13 17:56:11 +01:00
Laurens Valk
57a44265b8
api/nxtdevices: add VernierAdapter
2020-02-12 12:49:40 +01:00
David Lechner
f8ccbb7896
api/messaging: rename ev3messaging module to messaging
2020-02-12 09:55:28 +01:00
Laurens Valk
37a297cf0d
doc/ev3messaging: add draft network diagram
2020-02-12 09:55:28 +01:00
Laurens Valk
627701d26a
doc/ev3messaging: organize page
...
Group connection related classes under a header and move it to the top.
Avoid duplicating shared methods. This reduces the page length considerably so it is easier to see the bigger picture. Add examples of data types instead.
2020-02-12 09:55:28 +01:00
David Lechner
b1382f02b0
move EV3 mailboxes to ev3messaging module
...
- add separate maibox classes
- drop bluetooth module since it is not considered public API
2020-02-12 09:55:28 +01:00
David Lechner
7acbcbd874
initial EV3 bluetooth mailbox docs
2020-02-12 09:55:28 +01:00
David Lechner
f16876cca9
doc/media/ev3dev/image: use substitution to disambiguate screen/image
2020-02-11 11:49:05 -06:00
David Lechner
d9089bcbae
api/media/ev3dev: update for Image API changes
2020-02-11 11:43:54 -06:00
Laurens Valk
0841899394
api/builtins/Control: expose done method
...
This was added but not yet exposed
2020-02-10 15:57:23 +01:00
Laurens Valk
37de307ef0
doc/motors: add note about controller inactivity
2020-02-09 23:47:35 +01:00
Laurens Valk
f5c3347ba1
doc/signaltypes: fix label
...
This was left behind when grouping labels earlier
2020-02-07 20:13:35 +01:00
Laurens Valk
f1f1ceaac9
api/robotics/DriveBase: add state getter
2020-02-06 14:05:14 +01:00
Laurens Valk
7423161615
api/robotics: simplify API
...
drop methods that will not be implemented for next release and simplify descriptions of methods that will be implemented.
2020-02-05 16:55:03 +01:00
Laurens Valk
6337b6c451
api/iodevices: Separate Ev3devSensor class
...
This is not just an alias for a LUMPDevice because it works differently. On ev3dev, sensor modes are set using strings.
Also, simplify the introductory text and reasons for using it.
2020-02-03 13:54:18 +01:00
Laurens Valk
2bd149a121
doc/iodevices: reorganize TOC
...
Make the heading levels match the module. No subcategories, but say which devices are available on EV3 only.
2020-02-03 11:35:43 +01:00
Laurens Valk
ab6b15f047
doc/media: toggle items by category
...
Make it easier to browse the options.
2020-01-29 14:47:03 +01:00
Laurens Valk
e97423da72
doc/motors: hide status getters
...
These are not yet implemented
2020-01-29 13:38:32 +01:00
Laurens Valk
741af5280a
config: ignore only generated images
...
Make sure we can add other images without doing special things.
2020-01-29 12:57:03 +01:00
Laurens Valk
d923f79506
doc/motor: reduce width of commented text
2020-01-28 20:30:42 +01:00
Laurens Valk
6525fbc98a
doc/frames: hide page
...
This won't be needed until support for accelerometers is added.
2020-01-28 20:28:29 +01:00
Laurens Valk
f3003720ee
doc/parameters: hide unused parameters
...
There is no functionality in the release that uses this yet.
2020-01-28 20:23:55 +01:00
Laurens Valk
5363ff5015
doc/motors: hide unfinished sections
...
make it easier to see what is ready for review
2020-01-28 20:23:01 +01:00
Laurens Valk
71ae6825a0
doc/pupdevices: hide non-implemented device/method
2020-01-28 20:12:19 +01:00
Laurens Valk
4ed787240e
api/builtins: drop motor setting setters
...
this will be done through the control attribute instead
2020-01-28 17:53:11 +01:00
Laurens Valk
6278aeb1b6
doc/builtins: drop simplemotor
...
Now that we have reduced the complexity of the docstrings and after moving the control settings to a separate page, it is no longer necessary to have simplified motor docs.
2020-01-28 17:51:23 +01:00
Laurens Valk
1ba961b29c
doc/builtins: simplify motor docs
...
Reduce unnecessary details for motor methods
2020-01-28 17:41:36 +01:00
Laurens Valk
2bb1fe2cb7
doc/motors: move Control class to dedicated place.
...
This way the DriveBase can refer to it too.
2020-01-28 17:09:21 +01:00
Laurens Valk
36a393c927
api/builtins/Control: introduce Control class
...
This is a generic class to interact with PID Controllers. A Motor has one control instance (for angle) and a drivebase will have two (one for heading, one for distance).
This will replace the motor specific settings
2020-01-28 16:25:53 +01:00
Laurens Valk
4faa5d3df8
doc/hubs.EV3Brick: toggle note specs
...
This condenses long lists that are not frequently used.
2020-01-27 13:25:42 +01:00
Laurens Valk
aac25bb050
doc/media/ev3dev: fix ' in docstring
...
Also update todo note.
2020-01-27 13:07:51 +01:00
Laurens Valk
4bff13b5ca
doc: drop separate sound page
...
The sound is not independently useable, and it is already documented for the speaker.
2020-01-27 13:03:41 +01:00
Laurens Valk
08e63e69ca
api/builtins/DCMotor: drop settings
...
These settings are control properties, so they cannot be altered on DC Motors.
2020-01-27 12:56:47 +01:00