Commit Graph
354 Commits
Author SHA1 Message Date
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 3e5f552591 api/iodevices: update i2c doc and sample
Reflect that we read one byte by default.

By popular request, also allow a second way to send one byte, by specifying a register with no data.
2020-02-03 10:37:32 +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 c55556a598 config: ignore unused import
These are not used by classes in the docs, but they are used by Sphinx.

Also, this will be used to let autocomplete know that these modules contain a Motor class.
2020-01-28 18:03:18 +01:00
Laurens Valk 9a3d4f88b6 doc/ev3devices, pupdevices: drop catalog id
This will be replaced with a render of the device, included by the RST file, not the docstring.
2020-01-28 18:00:55 +01:00
Laurens Valk e73945d9c5 doc/ev3devices, pupdevices: do not inherit Motor
Just import it. Otherwise, Sphinx does not pick up autoattribute docstrings.
2020-01-28 17:58:54 +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 167cf3ad18 doc/builtins/Speaker: use '' for string settings
Also simplify by not listing all the options twice, and follow style for default argument.
2020-01-27 13:12:57 +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
Laurens Valk a029757b4a doc/robotics: hide non-implemented methods 2020-01-27 12:51:48 +01:00
Laurens Valk 1c801f1520 api/robotics: add tank method
Also, group similar methods together and explain what they do.
2020-01-27 11:20:07 +01:00
Laurens Valk dd39a2e00f api/robotics: update DriveBase API
Make arc a non-blocking function similar to drive. This allows users to drive the robot along an arc until a sensor (e.g. color) is triggered, instead of relying on the rotation sensors only.

This also lets us simplify the language of some other method docstrings.
2020-01-23 17:58:24 +01:00
Laurens Valk f5094cfaba config: use inline math and common characters
Latex errors cannot be parsed by humans, so just use inline math which we had working elsewhere already.

Also use simplified character for ế, for latex compatibility.
2020-01-16 15:03:54 +01:00
Laurens Valk 686a3b8147 doc/media: update to say that these are ev3dev media 2020-01-16 14:31:14 +01:00
Laurens Valk 09a2e3eed9 doc/media/ev3dev: move files back to top
These are the most used. Also add separate heading for images/sounds so they can easily be found through menu.

Also lower currently mixed case rubric titles.

It would still be nice to make these lists shorter, perhaps using a dropdown or table.
2020-01-16 14:30:23 +01:00
Laurens Valk 022f15a437 config/spelling: ignore literals, data directives 2020-01-16 14:22:21 +01:00
Laurens Valk 00f5b9e13b doc/screen: simplify print doc
Only say what it does, not what it doesn't do.

Also delete "on the image" because this is also used for the screen.
2020-01-16 13:48:56 +01:00
Laurens Valk f7ff1e511e api/builtins/ColorLight: remove brightness
Brightness control will not be implemented for the next release, so remove it.
2020-01-16 13:34:18 +01:00
Laurens Valk 90314b3f49 api/ev3.speaker: Fix missing language arg
This was added to the docstring but not the method.
2020-01-16 13:31:04 +01:00
Laurens Valk b6f75eca9c config: ignore literals by regexp and config files
No need to have all of them in the ignore list now.
2020-01-16 13:28:09 +01:00
Laurens Valk 81626bb20d config: more spellchecking and ignoring 2020-01-16 12:02:50 +01:00
Laurens Valk f597ed1f88 config: ignore math during spell check 2020-01-16 11:57:19 +01:00
Laurens Valk 834a2173b4 doc/builtins: fix typos 2020-01-16 11:40:34 +01:00
Laurens Valk efb6d18ff8 doc/ev3.speaker: strings have quotes 2020-01-16 11:39:51 +01:00
Laurens Valk a026e3a12c config: ignore language identifiers 2020-01-16 11:39:08 +01:00
Laurens Valk fe255a9611 config: sort ignored words
No longer have two lists of technical words and regular words.

also add a few more words
2020-01-16 11:31:37 +01:00
Laurens Valk 50a9d36314 api/ev3.speaker: separate language and voice settings 2020-01-16 11:25:13 +01:00
Laurens Valk 3e16ec2ba5 config: use Spell Right for spell checking
Also add initial list of words to ignore
2020-01-16 11:16:39 +01:00
Laurens Valk 8904413084 doc/speaker: Put language under show/hide toggle
This list is rather long, so hide it by default.
2020-01-16 10:34:56 +01:00
Laurens Valk 7a16c637aa doc/speaker: fix typo 2020-01-16 10:27:31 +01:00
David Lechner dc82ccce40 resources renamed to media.ev3dev 2020-01-14 17:32:40 -06:00
Laurens Valk a6e6de28b5 api/nxtdevices: update sound audible argument
rename to audible_only for a more precise description.
2020-01-14 21:27:01 +01:00
Laurens Valk 4546f2b548 doc/signaltype: group units by type
There are now quite a few units, so organize them by physical category.
2020-01-14 21:12:00 +01:00
Laurens Valk c1255e6b95 doc/signaltypes: add temperature conversions 2020-01-14 20:58:55 +01:00