8722ea902e
Since odoo/documentation#903, the guideline for the location of new resource (images, downloadable files, RST includes...) files is to place those inside the directory of the RST page that references them. For example, if `doc1.rst` has a reference to `image.png` and to `download.zip`, the file structure should look like this: ├── parent_doc/ │ └── doc1/ │ │ └── image.png │ │ └── download.zip │ └── doc1.rst │ └── doc2.rst ├── parent_doc.rst Before this commit, most of the resource files were still located inside 'media' directories holding all the resource files referenced by RST pages located at the same level as these directories. In the example above, a single 'media' directory would hold all the resource files referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from figuring out easily which resource file was referenced by which RST page and, thus, lead to unused resource files piling up in the repository. It also made it more complicated to define codeowners regex rules because a team could not simply be assigned to `/some_page.*` but needed to be assigned to both `/some_page\.rst` and to the location of 'media'. In order to help new content writers figure out the guideline when taking examples from other RST pages, this commit retroactively applies the guideline to existing resource files and 'media' directories. The left-over resource files that are not referenced by any RST page are removed. task-2497965 Part-of: odoo/documentation#2068
69 lines
2.2 KiB
ReStructuredText
69 lines
2.2 KiB
ReStructuredText
===========================
|
|
Use the IoT Box for the PoS
|
|
===========================
|
|
|
|
.. image:: pos/pos01.png
|
|
:align: center
|
|
|
|
Prerequisites
|
|
~~~~~~~~~~~~~
|
|
|
|
Before starting, make sure you have the following:
|
|
|
|
- An IoT Box, with its power adapter.
|
|
|
|
- A computer or tablet with an up-to-date web browser
|
|
|
|
- A running SaaS or Odoo instance with the Point of Sale and IoT apps
|
|
installed
|
|
|
|
- A local network setup with DHCP (this is the default setting)
|
|
|
|
- An RJ45 Ethernet Cable (optional, WiFi is built in)
|
|
|
|
- Any of the supported hardware (receipt printer, barcode scanner,
|
|
cash drawer, payment terminal, scale, customer display, etc.).
|
|
The list of supported hardware can be found on the `POS Hardware
|
|
page <https://www.odoo.com/page/point-of-sale-hardware>`__
|
|
|
|
Set Up
|
|
~~~~~~~
|
|
|
|
To connect hardware to the PoS, the first step is to connect an IoT Box
|
|
to your database. For this, follow this
|
|
:doc:`documentation <connect>`.
|
|
|
|
Then, you have to connect the peripheral devices to your IoT Box.
|
|
|
|
- **Printer**: Connect a supported receipt printer to a USB port or to
|
|
the network and power it on.
|
|
|
|
- **Cash drawer**: The cash drawer should be connected to the printer
|
|
with an RJ25 cable.
|
|
|
|
- **Barcode scanner**: Connect your barcode scanner. In order for your
|
|
barcode scanner to be compatible it must end barcodes with an Enter
|
|
character (keycode 28). This is most likely the default configuration
|
|
of your barcode scanner.
|
|
|
|
- **Scale**: Connect your scale and power it on.
|
|
|
|
- **Customer Display**: Connect a monitor to the IoT Box using an HDMI
|
|
cable. You can also access the Customer Display from any other computer
|
|
by accessing the IoT Box homepage and clicking on the *POS Display*
|
|
button.
|
|
|
|
- **Payment terminal**: The connection process depends on the terminal,
|
|
please refer to the :doc:`payment terminals documentation
|
|
</applications/sales/point_of_sale/payment>`.
|
|
|
|
Once it's done, you can connect the IoT Box to your PoS. For this, go in
|
|
:menuselection:`Point of Sale --> Configuration --> PoS`, tick *IoT Box*
|
|
and select the devices you want to use in this Point of Sale. Save the
|
|
changes.
|
|
|
|
.. image:: pos/pos02.png
|
|
:align: center
|
|
|
|
Set up is done, you can launch a new PoS Session.
|