I/O Tutorial
============

Before getting into machine vision topics we're going to talk about I/O pin
control on your znzpi Cam. It's important you know how to toggle I/O pins,
transmit and receive serial data, and put your znzpi Cam to sleep so that you
can create a system that's able to "sense", "plan", and "act" in one package.

First, let's take a look at your znzpi Cam's pinout below:

.. image:: ../board_infor_a.jpg
    :alt: znzpi Cam Pinout
    :width: 700px

.. image:: ../board_infor_b.jpg
    :alt: znzpi Cam Pinout
    :width: 700px

.. image:: ../RV1106_io_v2.png
    :alt: znzpi Cam io Pinout
    :width: 700px

.. image:: ../lcd_gpio_v2.png
    :alt: znzpi Cam lcd Pinout
    :width: 700px

Depending on the model of your znzpi Cam you have 9-10 general purpose I/O pins
available which can be used for low-speed digital input and output. Note that we
use RV1106 processors which have 5V tolerant I/O pins so you can hookup your
znzpi Cam directly to an Arduino or other 5V device without worry. The I/O pins
are quite beefy too and can source or sink up to 25 mA each.

Anyway, different I/O pins have different special functions. P0-P3, for example,
are your znzpi Cam's SPI bus pins which you can use to control SPI devices.
P4-P5 are your znzpi Cam's Asynchronous Serial or I2C bus bins to talk serial
or I2C. P6 is your znzpi Cam's ADC/DAC pin for 0V to 3.3V input and output. And
P7-P8 (or P7-P9) are your znzpi Cam's Auxiliary I/O pins.

The PYB Module
--------------

All microcontroller I/O functionality is available from the `pyb` (Python
Board) module. You just need to ``import pyb`` in your script to get access to
it. Once imported you'll have access to the ADC, CAN, DAC, I2C, Pin, Servo, SPI,
and UART classes along with being able to control the board's power consumption.

.. toctree::

   led_control.rst
   gpio_control.rst
   analog_io.rst
   uart_control.rst

.. note::

    The tutorial is not complete at right now. Please see the quick reference
    and library for more documentation.