[ADD] iot: new docs about connecting devices (#449)

[ADD] iot: new docs about connecting devices

iot/devices.rst

@@ -6,4 +6,7 @@ Configuration
    :titlesonly:
    :glob:
 
-   devices/measurement_tool
+   devices/measurement_tool
+   devices/camera
+   devices/footswitch
+   devices/printer

iot/devices/camera.rst

@@ -0,0 +1,55 @@
+================
+Connect a Camera
+================
+
+When using your *IoT Box* in Odoo, you could need to use a camera. As
+it can be done in a few steps, this device is really easy to configure.
+Then, you can use it in your manufacturing process and link it to a
+control point. Doing so will allow you to take pictures when you reach
+the chosen quality control point.
+
+Connection
+==========
+
+To connect the camera to the *IoT Box*, simply combine the two by
+cable.
+
+.. note::
+		In some cases, a serial to USB adapter could be needed.
+
+If your camera is a `*supported
+one* <https://www.odoo.com/page/iot-hardware>`__, there is no need to
+set up anything as it will be detected as soon as it is connected.
+
+.. image:: media/camera_01.png
+   :align: center
+
+In some cases, you could need to restart the box and download your
+camera’s drivers from the box. To do so, go to your *IoT Box Home
+Page* and click on *drivers list*. Then, click on load drivers.
+
+.. image:: media/camera_02.png
+   :align: center
+
+Link a Camera to a Quality Control Point
+========================================
+
+With the Manufacturing app
+--------------------------
+
+In your *Quality app*, you can setup the device on a *Quality Control
+Point*. Go to the *Control Points* menu, under *Quality Control*
+and open the control point you want to link with the camera.
+
+Now, you can edit the control point and select the device from the
+dropdown list. Now, hit save.
+
+.. image:: media/camera_03.png
+   :align: center
+
+Then, your camera can be used with the picked *Control Point*. During
+the manufacturing process, reaching the *Quality Control Point* you
+chose before will allow you to take a picture.
+
+.. image:: media/camera_04.png
+   :align: center

iot/devices/footswitch.rst

@@ -0,0 +1,53 @@
+====================
+Connect a Footswitch
+====================
+
+When working, it is always better to have your two hands available.
+Using Odoo’s *IoT Box* and a footswitch will allow it.
+
+In fact, you will be able to go from one screen to another by using your
+foot and the footswitch. Really convenient, it can be configured in a
+few steps.
+
+Connection
+==========
+
+Connecting the footswitch to the *IoT Box* is easy, you just have to
+combine the two by cable.
+
+.. note::
+		In some cases, a serial to USB adapter may be needed.
+
+If your footswitch is a `supported
+one <https://www.odoo.com/page/iot-hardware>`__, there is no need to
+set up anything since it will be automatically detected when connected.
+
+.. image:: media/footswitch_01.png
+   :align: center
+
+If it is not a supported one, you may need to restart the box and
+download your footswitch’s drivers from the box. To do so, go to the
+*IoT Box Home Page* and click on *drivers list*. Then, click on load
+drivers.
+
+.. image:: media/footswitch_02.png
+   :align: center
+
+Link a Footswitch to a Workcenter
+=================================
+
+To link the footswitch to an action, it needs to be configured on a
+workcenter. Go to the workcenter you want to use the footswitch in and
+add the device in the *IoT Triggers* tab. Then, you can link it to an
+action and also add a key to trigger it.
+
+.. image:: media/footswitch_03.png
+   :align: center
+
+Note that the one that is first in the list will be chosen. So, the
+order matters! In the picture above, using the footswitch will, for
+example, automatically skip the current part of the process you work on.
+
+.. note::
+		When you are on the work order screen, a status button indicates if you
+		are correctly connected to the footswitch.

iot/devices/measurement_tool.rst

@@ -1,11 +1,10 @@
 ==========================
-Connect a measurement tool
+Connect a Measurement Tool
 ==========================
 
 With Odoo’s *IoT Box*, it is possible to connect measurement tools to
 your database. Find the list of supported devices here: `Supported
-devices
-<`*https://www.odoo.com/page/iot-hardware* <https://www.odoo.com/page/iot-hardware>`__>`__,.
+devices <https://www.odoo.com/page/iot-hardware>`__,.
 
 Connect in USB
 ==============

iot/devices/printer.rst

@@ -0,0 +1,138 @@
+=================
+Connect a Printer
+=================
+
+When using your *IoT Box* in Odoo, you could need to use a printer.
+Doing so is easy and convenient as it can be done in a few steps. Then,
+you can use it to print receipts, orders or even reports in different
+Odoo apps.
+
+Connection
+==========
+
+To connect the printer to the *IoT Box*, you just have to combine the
+two by cable.
+
+.. note::
+         Sometimes, a serial to USB adapter may be needed.
+
+If your printer is a `supported
+one <https://www.odoo.com/page/iot-hardware>`__, there is no need to set up anything
+because it will be automatically detected as soon as it is connected.
+
+.. note::
+         The printer can take up to two minutes to appear in your devices list.
+
+.. image:: media/printer_01.png
+   :align: center
+
+In some cases, you may need to restart the box and download your
+printer’s drivers from the box. To do so, go to the *IoT Box Home
+Page* and click on *drivers list*. Then, click on load drivers.
+
+.. image:: media/printer_02.png
+   :align: center
+
+Link the Printer
+================
+
+To Work Orders
+--------------
+
+You can link *Work Orders* to printers via a *Quality Control Point*
+to print labels for manufactured products.
+
+To do so, you need to create a *Quality Control Point* from the
+*Quality* app. Then, you can select the correct manufacturing
+operation and the work order operation. In type, choose *Print Label*
+and hit save.
+
+.. image:: media/printer_03.png
+   :align: center
+
+Now, each time you reach the quality control point for the chosen
+product, a *Print Label* button will appear.
+
+.. image:: media/printer_04.png
+   :align: center
+
+To Reports
+----------
+
+You can also link a type of report to a certain printer. In the *IoT*
+app, go to the *Devices* menu and select the printer you want to set
+up.
+
+.. image:: media/printer_05.png
+   :align: center
+
+Now, go to the *Printer Reports* tab.
+
+.. image:: media/printer_06.png
+   :align: center
+
+Hit edit and then, click on *Add a line*. In the window that shows up,
+check all the types of reports that should be linked to this printer.
+Click on select and save.
+
+.. image:: media/printer_07.png
+   :align: center
+
+Now, each time you click on *Print* in the control panel, instead of
+downloading a PDF, it will send it to the selected printer and
+automatically print it.
+
+Print Receipts from the PoS
+---------------------------
+
+You can link a printer to your *Point of Sale* app so you can print
+receipts directly from your *PoS*.
+
+Doing so is really easy. Go to your *Point of Sale* app and open your
+*PoS* settings, under *Configuration*. There, click on *Edit* and
+check the *IoT Box* feature. Then, enable the *Receipt Printer*.
+
+.. image:: media/printer_08.png
+   :align: center
+
+Now, on your *PoS* view, you will be able to print different kinds of
+tickets: **receipts**, **sale details** and **bills**.
+
+For the receipt, it will be printed once the order is validated. The
+process is automated when you enable the feature in your *PoS*.
+
+Sales details can be printed by clicking on the printer icon on the
+navbar at the top of the *PoS*. It will print the details of the sales
+of the current day.
+
+.. image:: media/printer_09.png
+   :align: center
+
+As for the bill, it is only available in restaurant mode. In your
+restaurant settings, activate bills and a *Bill* button will appear in
+the left panel. Click on it and it will print the bill.
+
+.. image:: media/printer_10.png
+   :align: center
+
+Print Orders in the kitchen
+---------------------------
+
+In restaurant mode, you can send order tickets to the kitchen.
+
+To do so, go to the *PoS* app and open your *PoS* settings. Then,
+tick *Order Printer*.
+
+.. image:: media/printer_11.png
+   :align: center
+
+Now, go to the *Printers* menu. Hit create and select the *IoT Box*
+with all the categories of product that should be printed in the
+*Printer Product Categories* field.
+
+.. image:: media/printer_12.png
+   :align: center
+
+In the *PoS*, when you add or remove a product from one of the
+selected categories, the button *Order* will be green. If you click on
+it, a ticket will be printed.