Improve documentation

This commit is contained in:
Radomir Dopieralski 2019-03-01 16:36:29 +01:00
parent 5d85d54026
commit ea78417f7f
1 changed files with 16 additions and 3 deletions

View File

@ -37,17 +37,30 @@
//| .. currentmodule:: _pew //| .. currentmodule:: _pew
//| //|
//| :class:`PewPew` -- LED Matrix driver //| :class:`PewPew` -- LED matrix and button driver
//| ==================================== //| ===============================================
//|
//| This is an internal module to be used by the ``pew.py`` library from
//| https://github.com/pewpew-game/pew-pewpew-standalone-10.x to handle the
//| LED matrix display and buttons on the ``pewpew10`` board.
//| //|
//| Usage:: //| Usage::
//| //|
//| This singleton class is instantiated by the ``pew`` library, and
//| used internally by it. All user-visible interactions are done through
//| that library.
//| //|
//| .. class:: PewPew(buffer, rows, cols) //| .. class:: PewPew(buffer, rows, cols, buttons)
//| //|
//| Initializes matrix scanning routines. //| Initializes matrix scanning routines.
//| //|
//| The ``buffer`` is a 64 byte long ``bytearray`` that stores what should
//| be displayed on the matrix. ``rows`` and ``cols`` are both lists of
//| eight ``DigitalInputOutput`` objects that are connected to the matrix
//| rows and columns. ``buttons`` is a ``DigitalInputOutput`` object that
//| is connected to the common side of all buttons (the other sides of the
//| buttons are connected to rows of the matrix).
//| //|
STATIC mp_obj_t pewpew_make_new(const mp_obj_type_t *type, size_t n_args, STATIC mp_obj_t pewpew_make_new(const mp_obj_type_t *type, size_t n_args,
const mp_obj_t *pos_args, mp_map_t *kw_args) { const mp_obj_t *pos_args, mp_map_t *kw_args) {