Skip to content

Commit

Permalink
docs/uctypes: Fix API description errors.
Browse files Browse the repository at this point in the history
"Structure class" is its descriptor, encoded as a dictionary. Then,
uctypes.struct() instantiates an actual object, and thus requires memory
address.
  • Loading branch information
Paul Sokolovsky committed Jun 2, 2015
1 parent 0df20da commit f8bce13
Showing 1 changed file with 10 additions and 9 deletions.
19 changes: 10 additions & 9 deletions docs/library/uctypes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -96,10 +96,11 @@ Following are encoding examples for various field types:
Module contents
---------------

.. class:: struct(descriptor, layout_type)
.. class:: struct(descriptor, addr, layout_type-NATIVE)

Create a "foreign data structure" class based on its descriptor (encoded
as a dictionary) and layout type (see below).
Instantiate a "foreign data structure" object based on structure descriptor
(encoded as a dictionary), layout type (see below), and actual structure
address.

.. data:: LITTLE_ENDIAN

Expand Down Expand Up @@ -140,16 +141,16 @@ Module contents
so it can be both written too, and you will access current value
at the given memory address.

Structure classes and instantiating structure objects
Structure descriptors and instantiating structure objects
-----------------------------------------------------

Given structure descriptor and layout type, you can instantiate a
"structure class" using uctypes.struct() factory function. From it,
you can instantiate a specific structure instance at a given
memory address. Memory address usually comes from following sources:
Given a structure descriptor dictionary and its layout type, you can
instantiate a specific structure instance at a given memory address
using uctypes.struct() constructor. Memory address usually comes from
following sources:

* Predefined address, when accessing hardware registers on a baremetal
port. Lookup these addresses in datasheet for a particular MCU/SoC.
system. Lookup these addresses in datasheet for a particular MCU/SoC.
* As return value from a call to some FFI (Foreign Function Interface)
function.
* From uctypes.addressof(), when you want to pass arguments to FFI
Expand Down

0 comments on commit f8bce13

Please sign in to comment.