docs: Change "Micro Python" to "MicroPython" in all places in docs.
This commit is contained in:
parent
601cfea6a3
commit
3eece29807
10
docs/conf.py
10
docs/conf.py
|
@ -1,7 +1,7 @@
|
||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
#
|
#
|
||||||
# Micro Python documentation build configuration file, created by
|
# MicroPython documentation build configuration file, created by
|
||||||
# sphinx-quickstart on Sun Sep 21 11:42:03 2014.
|
# sphinx-quickstart on Sun Sep 21 11:42:03 2014.
|
||||||
#
|
#
|
||||||
# This file is execfile()d with the current directory set to its
|
# This file is execfile()d with the current directory set to its
|
||||||
|
@ -50,7 +50,7 @@ source_suffix = '.rst'
|
||||||
master_doc = 'index'
|
master_doc = 'index'
|
||||||
|
|
||||||
# General information about the project.
|
# General information about the project.
|
||||||
project = 'Micro Python'
|
project = 'MicroPython'
|
||||||
copyright = '2014, Damien P. George'
|
copyright = '2014, Damien P. George'
|
||||||
|
|
||||||
# The version info for the project you're documenting, acts as replacement for
|
# The version info for the project you're documenting, acts as replacement for
|
||||||
|
@ -213,7 +213,7 @@ latex_elements = {
|
||||||
# (source start file, target name, title,
|
# (source start file, target name, title,
|
||||||
# author, documentclass [howto, manual, or own class]).
|
# author, documentclass [howto, manual, or own class]).
|
||||||
latex_documents = [
|
latex_documents = [
|
||||||
('index', 'MicroPython.tex', 'Micro Python Documentation',
|
('index', 'MicroPython.tex', 'MicroPython Documentation',
|
||||||
'Damien P. George', 'manual'),
|
'Damien P. George', 'manual'),
|
||||||
]
|
]
|
||||||
|
|
||||||
|
@ -243,7 +243,7 @@ latex_documents = [
|
||||||
# One entry per manual page. List of tuples
|
# One entry per manual page. List of tuples
|
||||||
# (source start file, name, description, authors, manual section).
|
# (source start file, name, description, authors, manual section).
|
||||||
man_pages = [
|
man_pages = [
|
||||||
('index', 'micropython', 'Micro Python Documentation',
|
('index', 'micropython', 'MicroPython Documentation',
|
||||||
['Damien P. George'], 1),
|
['Damien P. George'], 1),
|
||||||
]
|
]
|
||||||
|
|
||||||
|
@ -257,7 +257,7 @@ man_pages = [
|
||||||
# (source start file, target name, title, author,
|
# (source start file, target name, title, author,
|
||||||
# dir menu entry, description, category)
|
# dir menu entry, description, category)
|
||||||
texinfo_documents = [
|
texinfo_documents = [
|
||||||
('index', 'MicroPython', 'Micro Python Documentation',
|
('index', 'MicroPython', 'MicroPython Documentation',
|
||||||
'Damien P. George', 'MicroPython', 'One line description of project.',
|
'Damien P. George', 'MicroPython', 'One line description of project.',
|
||||||
'Miscellaneous'),
|
'Miscellaneous'),
|
||||||
]
|
]
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
Micro Python documentation contents
|
MicroPython documentation contents
|
||||||
===================================
|
==================================
|
||||||
|
|
||||||
.. only:: port_pyboard
|
.. only:: port_pyboard
|
||||||
|
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
Micro Python documentation and references
|
MicroPython documentation and references
|
||||||
=========================================
|
========================================
|
||||||
|
|
||||||
.. only:: port_pyboard
|
.. only:: port_pyboard
|
||||||
|
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
Micro Python libraries
|
MicroPython libraries
|
||||||
======================
|
=====================
|
||||||
|
|
||||||
Functionality specific to the Micro Python implementation is available in
|
Functionality specific to the MicroPython implementation is available in
|
||||||
the following library.
|
the following library.
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
@ -12,7 +12,7 @@ the following library.
|
||||||
Python standard libraries
|
Python standard libraries
|
||||||
-------------------------
|
-------------------------
|
||||||
|
|
||||||
The following standard Python libraries are built in to Micro Python.
|
The following standard Python libraries are built in to MicroPython.
|
||||||
|
|
||||||
For additional libraries, please download them from the `micropython-lib repository
|
For additional libraries, please download them from the `micropython-lib repository
|
||||||
<https://github.com/micropython/micropython-lib>`_.
|
<https://github.com/micropython/micropython-lib>`_.
|
||||||
|
@ -33,7 +33,7 @@ Python micro-libraries
|
||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
The following standard Python libraries have been "micro-ified" to fit in with
|
The following standard Python libraries have been "micro-ified" to fit in with
|
||||||
the philosophy of Micro Python. They provide the core functionality of that
|
the philosophy of MicroPython. They provide the core functionality of that
|
||||||
module and are intended to be a drop-in replacement for the standard Python
|
module and are intended to be a drop-in replacement for the standard Python
|
||||||
library.
|
library.
|
||||||
|
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
:mod:`micropython` -- access and control Micro Python internals
|
:mod:`micropython` -- access and control MicroPython internals
|
||||||
===============================================================
|
==============================================================
|
||||||
|
|
||||||
.. module:: micropython
|
.. module:: micropython
|
||||||
:synopsis: access and control Micro Python internals
|
:synopsis: access and control MicroPython internals
|
||||||
|
|
||||||
Functions
|
Functions
|
||||||
---------
|
---------
|
||||||
|
|
|
@ -38,7 +38,7 @@ To check if there is anything to be read, use::
|
||||||
|
|
||||||
uart.any() # returns True if any characters waiting
|
uart.any() # returns True if any characters waiting
|
||||||
|
|
||||||
*Note:* The stream functions ``read``, ``write``, etc. are new in Micro Python v1.3.4.
|
*Note:* The stream functions ``read``, ``write``, etc. are new in MicroPython v1.3.4.
|
||||||
Earlier versions use ``uart.send`` and ``uart.recv``.
|
Earlier versions use ``uart.send`` and ``uart.recv``.
|
||||||
|
|
||||||
Constructors
|
Constructors
|
||||||
|
|
|
@ -39,7 +39,7 @@ Constants
|
||||||
|
|
||||||
.. data:: platform
|
.. data:: platform
|
||||||
|
|
||||||
The platform that Micro Python is running on. This is "pyboard" on the
|
The platform that MicroPython is running on. This is "pyboard" on the
|
||||||
pyboard and provides a robust way of determining if a script is running
|
pyboard and provides a robust way of determining if a script is running
|
||||||
on the pyboard or not.
|
on the pyboard or not.
|
||||||
|
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
Micro Python license information
|
MicroPython license information
|
||||||
================================
|
===============================
|
||||||
|
|
||||||
The MIT License (MIT)
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
|
|
@ -1,12 +1,12 @@
|
||||||
Inline assembler
|
Inline assembler
|
||||||
================
|
================
|
||||||
|
|
||||||
Here you will learn how to write inline assembler in Micro Python.
|
Here you will learn how to write inline assembler in MicroPython.
|
||||||
|
|
||||||
**Note**: this is an advanced tutorial, intended for those who already
|
**Note**: this is an advanced tutorial, intended for those who already
|
||||||
know a bit about microcontrollers and assembly language.
|
know a bit about microcontrollers and assembly language.
|
||||||
|
|
||||||
Micro Python includes an inline assembler. It allows you to write
|
MicroPython includes an inline assembler. It allows you to write
|
||||||
assembly routines as a Python function, and you can call them as you would
|
assembly routines as a Python function, and you can call them as you would
|
||||||
a normal Python function.
|
a normal Python function.
|
||||||
|
|
||||||
|
@ -23,7 +23,7 @@ Let's start with the simplest example::
|
||||||
You can enter this in a script or at the REPL. This function takes no
|
You can enter this in a script or at the REPL. This function takes no
|
||||||
arguments and returns the number 42. ``r0`` is a register, and the value
|
arguments and returns the number 42. ``r0`` is a register, and the value
|
||||||
in this register when the function returns is the value that is returned.
|
in this register when the function returns is the value that is returned.
|
||||||
Micro Python always interprets the ``r0`` as an integer, and converts it to an
|
MicroPython always interprets the ``r0`` as an integer, and converts it to an
|
||||||
integer object for the caller.
|
integer object for the caller.
|
||||||
|
|
||||||
If you run ``print(fun())`` you will see it print out 42.
|
If you run ``print(fun())`` you will see it print out 42.
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
.. _tutorial-index:
|
.. _tutorial-index:
|
||||||
|
|
||||||
Micro Python tutorial
|
MicroPython tutorial
|
||||||
=====================
|
====================
|
||||||
|
|
||||||
This tutorial is intended to get you started with your pyboard.
|
This tutorial is intended to get you started with your pyboard.
|
||||||
All you need is a pyboard and a micro-USB cable to connect it to
|
All you need is a pyboard and a micro-USB cable to connect it to
|
||||||
|
|
|
@ -24,7 +24,7 @@ As long as you take care of the hardware, you should be okay. It's almost
|
||||||
impossible to break the software on the pyboard, so feel free to play around
|
impossible to break the software on the pyboard, so feel free to play around
|
||||||
with writing code as much as you like. If the filesystem gets corrupt, see
|
with writing code as much as you like. If the filesystem gets corrupt, see
|
||||||
below on how to reset it. In the worst case you might need to reflash the
|
below on how to reset it. In the worst case you might need to reflash the
|
||||||
Micro Python software, but that can be done over USB.
|
MicroPython software, but that can be done over USB.
|
||||||
|
|
||||||
Layout of the pyboard
|
Layout of the pyboard
|
||||||
---------------------
|
---------------------
|
||||||
|
|
|
@ -23,7 +23,7 @@ For circuit schematics and datasheets for the components on the skin see :ref:`h
|
||||||
Using the LCD
|
Using the LCD
|
||||||
-------------
|
-------------
|
||||||
|
|
||||||
To get started using the LCD, try the following at the Micro Python prompt.
|
To get started using the LCD, try the following at the MicroPython prompt.
|
||||||
Make sure the LCD skin is attached to the pyboard as pictured at the top of this page. ::
|
Make sure the LCD skin is attached to the pyboard as pictured at the top of this page. ::
|
||||||
|
|
||||||
>>> import pyb
|
>>> import pyb
|
||||||
|
|
|
@ -44,7 +44,7 @@ Next we will set up an infinite loop that cycles through each of the LEDs turnin
|
||||||
|
|
||||||
Here, n keeps track of the current LED and every time the loop is executed we cycle to the next n (the % sign is a modulus operator that keeps n between 0 and 3.) Then we access the nth LED and toggle it. If you run this you should see each of the LEDs turning on then all turning off again in sequence.
|
Here, n keeps track of the current LED and every time the loop is executed we cycle to the next n (the % sign is a modulus operator that keeps n between 0 and 3.) Then we access the nth LED and toggle it. If you run this you should see each of the LEDs turning on then all turning off again in sequence.
|
||||||
|
|
||||||
One problem you might find is that if you stop the script and then start it again that the LEDs are stuck on from the previous run, ruining our carefully choreographed disco. We can fix this by turning all the LEDs off when we initialise the script and then using a try/finally block. When you press CTRL-C, Micro Python generates a VCPInterrupt exception. Exceptions normally mean something has gone wrong and you can use a try: command to "catch" an exception. In this case it is just the user interrupting the script, so we don't need to catch the error but just tell Micro Python what to do when we exit. The finally block does this, and we use it to make sure all the LEDs are off. The full code is::
|
One problem you might find is that if you stop the script and then start it again that the LEDs are stuck on from the previous run, ruining our carefully choreographed disco. We can fix this by turning all the LEDs off when we initialise the script and then using a try/finally block. When you press CTRL-C, MicroPython generates a VCPInterrupt exception. Exceptions normally mean something has gone wrong and you can use a try: command to "catch" an exception. In this case it is just the user interrupting the script, so we don't need to catch the error but just tell MicroPython what to do when we exit. The finally block does this, and we use it to make sure all the LEDs are off. The full code is::
|
||||||
|
|
||||||
leds = [pyb.LED(i) for i in range(1,5)]
|
leds = [pyb.LED(i) for i in range(1,5)]
|
||||||
for l in leds:
|
for l in leds:
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
Getting a Micro Python REPL prompt
|
Getting a MicroPython REPL prompt
|
||||||
==================================
|
=================================
|
||||||
|
|
||||||
REPL stands for Read Evaluate Print Loop, and is the name given to the
|
REPL stands for Read Evaluate Print Loop, and is the name given to the
|
||||||
interactive Micro Python prompt that you can access on the pyboard. Using
|
interactive MicroPython prompt that you can access on the pyboard. Using
|
||||||
the REPL is by far the easiest way to test out your code and run commands.
|
the REPL is by far the easiest way to test out your code and run commands.
|
||||||
You can use the REPL in addition to writing scripts in ``main.py``.
|
You can use the REPL in addition to writing scripts in ``main.py``.
|
||||||
|
|
||||||
|
@ -59,11 +59,11 @@ or use sudo).
|
||||||
Using the REPL prompt
|
Using the REPL prompt
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
Now let's try running some Micro Python code directly on the pyboard.
|
Now let's try running some MicroPython code directly on the pyboard.
|
||||||
|
|
||||||
With your serial program open (PuTTY, screen, picocom, etc) you may see a blank
|
With your serial program open (PuTTY, screen, picocom, etc) you may see a blank
|
||||||
screen with a flashing cursor. Press Enter and you should be presented with a
|
screen with a flashing cursor. Press Enter and you should be presented with a
|
||||||
Micro Python prompt, i.e. ``>>>``. Let's make sure it is working with the obligatory test::
|
MicroPython prompt, i.e. ``>>>``. Let's make sure it is working with the obligatory test::
|
||||||
|
|
||||||
>>> print("hello pyboard!")
|
>>> print("hello pyboard!")
|
||||||
hello pyboard!
|
hello pyboard!
|
||||||
|
@ -93,7 +93,7 @@ Resetting the board
|
||||||
-------------------
|
-------------------
|
||||||
|
|
||||||
If something goes wrong, you can reset the board in two ways. The first is to press CTRL-D
|
If something goes wrong, you can reset the board in two ways. The first is to press CTRL-D
|
||||||
at the Micro Python prompt, which performs a soft reset. You will see a message something like ::
|
at the MicroPython prompt, which performs a soft reset. You will see a message something like ::
|
||||||
|
|
||||||
>>>
|
>>>
|
||||||
PYB: sync filesystems
|
PYB: sync filesystems
|
||||||
|
|
|
@ -101,5 +101,5 @@ on the right edge.
|
||||||
When you press RST the green LED will flash quickly, and then the blue
|
When you press RST the green LED will flash quickly, and then the blue
|
||||||
LED should turn on and stay on.
|
LED should turn on and stay on.
|
||||||
|
|
||||||
Congratulations! You have written and run your very first Micro Python
|
Congratulations! You have written and run your very first MicroPython
|
||||||
program!
|
program!
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
/* custom CSS for Micro Python docs
|
/* custom CSS for MicroPython docs
|
||||||
*/
|
*/
|
||||||
|
|
||||||
.admonition-difference-to-cpython {
|
.admonition-difference-to-cpython {
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
{% extends "defindex.html" %}
|
{% extends "defindex.html" %}
|
||||||
{% block body %}
|
{% block body %}
|
||||||
|
|
||||||
<h1>Micro Python documentation</h1>
|
<h1>MicroPython documentation</h1>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
{{ _('Welcome! This is the documentation for Micro Python') }}
|
{{ _('Welcome! This is the documentation for MicroPython') }}
|
||||||
v{{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}.
|
v{{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
@ -21,7 +21,7 @@
|
||||||
{% endfor %}.
|
{% endfor %}.
|
||||||
</p-->
|
</p-->
|
||||||
|
|
||||||
<p><strong>Documentation for Micro Python and the pyboard:</strong></p>
|
<p><strong>Documentation for MicroPython and the pyboard:</strong></p>
|
||||||
|
|
||||||
<table class="contentstable"><tr>
|
<table class="contentstable"><tr>
|
||||||
<td width="40%" style="padding-left:2em;">
|
<td width="40%" style="padding-left:2em;">
|
||||||
|
@ -41,7 +41,7 @@
|
||||||
{% endif %}
|
{% endif %}
|
||||||
<p class="biglink">
|
<p class="biglink">
|
||||||
<a class="biglink" href="{{ pathto("library/index") }}">Library Reference</a><br/>
|
<a class="biglink" href="{{ pathto("library/index") }}">Library Reference</a><br/>
|
||||||
<span class="linkdescr">Micro Python libraries, including the <a href="{{ pathto("library/pyb") }}">pyb module</a></span>
|
<span class="linkdescr">MicroPython libraries, including the <a href="{{ pathto("library/pyb") }}">pyb module</a></span>
|
||||||
</p>
|
</p>
|
||||||
</td>
|
</td>
|
||||||
<td width="40%" style="padding-left:2em;">
|
<td width="40%" style="padding-left:2em;">
|
||||||
|
@ -57,7 +57,7 @@
|
||||||
{% endif %}
|
{% endif %}
|
||||||
<p class="biglink">
|
<p class="biglink">
|
||||||
<a class="biglink" href="{{ pathto("license") }}">License</a><br/>
|
<a class="biglink" href="{{ pathto("license") }}">License</a><br/>
|
||||||
<span class="linkdescr">Micro Python license information</span>
|
<span class="linkdescr">MicroPython license information</span>
|
||||||
</p>
|
</p>
|
||||||
</td>
|
</td>
|
||||||
</tr></table>
|
</tr></table>
|
||||||
|
@ -87,17 +87,17 @@
|
||||||
<table class="contentstable"><tr>
|
<table class="contentstable"><tr>
|
||||||
<td width="40%" style="padding-left:2em;">
|
<td width="40%" style="padding-left:2em;">
|
||||||
<p class="biglink">
|
<p class="biglink">
|
||||||
<a class="biglink" href="http://micropython.org">Micro Python homepage</a><br/>
|
<a class="biglink" href="http://micropython.org">MicroPython homepage</a><br/>
|
||||||
<span class="linkdescr">the official Micro Python site</span>
|
<span class="linkdescr">the official MicroPython site</span>
|
||||||
</p>
|
</p>
|
||||||
<p class="biglink">
|
<p class="biglink">
|
||||||
<a class="biglink" href="http://forum.micropython.org">Micro Python forum</a><br/>
|
<a class="biglink" href="http://forum.micropython.org">MicroPython forum</a><br/>
|
||||||
<span class="linkdescr">community discussion for all things related to Micro Python</span>
|
<span class="linkdescr">community discussion for all things related to MicroPython</span>
|
||||||
</p>
|
</p>
|
||||||
</td>
|
</td>
|
||||||
<td width="40%" style="padding-left:2em;">
|
<td width="40%" style="padding-left:2em;">
|
||||||
<p class="biglink">
|
<p class="biglink">
|
||||||
<a class="biglink" href="https://github.com/micropython">Micro Python on GitHub</a><br/>
|
<a class="biglink" href="https://github.com/micropython">MicroPython on GitHub</a><br/>
|
||||||
<span class="linkdescr">contribute to the source code on GitHub</span>
|
<span class="linkdescr">contribute to the source code on GitHub</span>
|
||||||
</p>
|
</p>
|
||||||
</td>
|
</td>
|
||||||
|
|
Loading…
Reference in New Issue