summaryrefslogtreecommitdiff
path: root/peripheral/libupm/doxy/index.rst
blob: cd91bae87e8bb688177bb7532d09c88be662dd05 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.. UPM Python documentation master file, created by Sisinty Sasmita Patra
   UPM Team on Thu May 14 15:58:46 2015.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

**Welcome to UPM Python Documentation!**
=========================================

.. include:: ../../README.md
  :start-after: ==============
  :end-before: ### Example

``Building UPM``
################

For building UPM, please follow this `link <https://github.com/intel-iot-devkit/upm/blob/master/docs/building.md>`_.

``Examples``
############

Multi-sensor samples for the starter and specialized kits can be found in the `iot-devkit-samples <https://github.com/intel-iot-devkit/iot-devkit-samples>`_
repository.

Individual sensor usage examples for Python are available `here <https://github.com/intel-iot-devkit/upm/tree/master/examples/python>`_.

``IDE Compatibility``
################

While there is no official IDE provided with our Python libraries, we do recommend the web-based IDE Wyliodrin. It can be used with multiple programming
languages, including Python. More information can be found on the Intel Developer Zone IDE page.

.. image:: ../docs/icons/wyliodrin.png
   :target: https://software.intel.com/iot/software/ide

``Making your own UPM Module``
##############################

This `link  <https://github.com/intel-iot-devkit/upm/blob/master/docs/porting.md>`_ has more information on making a new UPM module.

There is also an example available for max31855 `sensor <https://github.com/intel-iot-devkit/upm/blob/master/docs/max31855.md>`_.

``Naming Conventions and Rules for New UPM Contributions``
##########################################################

Before you begin development, please take a look at our naming `conventions <https://github.com/intel-iot-devkit/upm/blob/master/docs/naming.md>`_.

Also, please read the guidelines for contributions to `UPM <https://github.com/intel-iot-devkit/upm/blob/master/docs/contributions.md>`_.

Don't forget to check the documentation `section <https://github.com/intel-iot-devkit/upm/blob/master/docs/documentation.md>`_.

.. note::

   * Make sure you add yourself as an author on every new code file submitted.
   * If you are providing a fix with significant changes, feel free to add yourself as a contributor.
   * Signing-off your commits is mandatory.

``List of Available Sensors Drivers``
######################################

Click on the library prefix below to expand the full list of sensors:

.. toctree::
   :maxdepth: 1

   modules

``Other API Documentation``
###########################

.. image:: ../docs/icons/c++.png
   :target: http://iotdk.intel.com/docs/master/upm
.. image:: ../docs/icons/java.png
   :target: http://iotdk.intel.com/docs/master/upm/java
.. image:: ../docs/icons/python.png
   :target: http://iotdk.intel.com/docs/master/upm/python
.. image:: ../docs/icons/node.png
   :target: http://iotdk.intel.com/docs/master/upm/node

``Version Changelog``
#####################

For our Version Changelog, please see `here <https://github.com/intel-iot-devkit/upm/blob/master/docs/changelog.md>`_.

``Known Limitations``
###################################

For the List of Known Limitations, please see `here <https://github.com/intel-iot-devkit/upm/blob/master/docs/knownlimitations.md>`_.

``Indices and tables``
######################

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`