Aide au dépannage¶
Connexion à l’IoT box¶
Je ne trouve pas le code d’appariement pour connecter l’IoT box¶
Le code d’appariement doit être imprimé sur les imprimantes de reçu connectées à l”IoT box et doit également s’afficher sur les moniteurs connectés.
The pairing code does not show under the following circumstances:
L”IoT box est déjà connectée à une base de données Odoo.
L”IoT box n’est pas connectée à Internet.
The code is only valid for 5 minutes after the IoT box has started. It is automatically removed from connected displays when this time has expired.
The version of the IoT box image is too old. If the IoT box image is from an earlier version, then the SD card of the IoT box needs to be re-flashed to update the image (see Flashing the SD Card).
If none of the cases listed above correct the issue, then make sure the IoT box has correctly started, by checking that a fixed green LED is showing next to the power port.
IoT box is connected but it is not showing in the database¶
When an IoT box connects to a database, it may restart. If so, it can take up to five minutes before appearing in the database. If the IoT box is still not showing after five minutes, make sure that the IoT box can reach the database and that the server does not use a multi-database environment.
Pour accéder à la base de données à partir de l”:IoT (Internet of Things)
box, ouvrez un navigateur et tapez l’adresse de la base de données.
L’IoT box est connectée à la base de données Odoo, mais n’est pas accessible¶
Assurez-vous que l”IoT box et l’ordinateur exécutant le navigateur se trouvent sur le même réseau, car l”IoT box n’est pas accessible en dehors du réseau local.
The HTTPS certificate does not generate¶
Afin de générer un certificat HTTPS, un abonnement IoT box est nécessaire pour l”IoT box. La connexion de l”IoT box avant la configuration d’un abonnement IoT pour la base de données et l”IoT box avec le gestionnaire de compte entraînera un connexion non sécurisée.
De plus, un pare-feu peut également empêcher la génération correcte du certificat HTTPS. Dans ce cas, désactivez le pare-feu jusqu’à ce que le certificat est généré avec succès. Notez également que certains périphériques, tels qu’un router avec un pare-feu intégré, peuvent empêcher la génération du certificat HTTPS.
Pour plus d'infos
Imprimante¶
L’imprimante n’est pas détectée¶
If a printer does not appear in the devices list, go to the IoT box homepage and make sure that it is listed under Printers.
If the printer is not present on the IoT box homepage, click Printers Server, go to the Administration tab and click on Add Printer. If the printer is not present in the list, it is likely not connected properly.
L’imprimante produit un texte aléatoire¶
Pour la plupart des imprimantes, le bon pilote est automatiquement détecté et sélectionné. Cependant, dans certains cas, il se peut que le mécanisme de détection automatique ne soit pas suffisant et que, si aucun pilote n’est trouvé, l’imprimante puisse imprimer des caractères aléatoires.
The solution is to manually select the corresponding driver. On the IoT box homepage, click on Printers Server, go to the Printers tab and select the printer in the list. In the Administration drop-down menu, click on Modify Printer. Follow the steps and select the make and model corresponding to the printer.
Note
Les imprimantes de reçu Epson et Star et les imprimantes d’étiquettes Zebra n’ont pas besoin de pilote pour fonctionner. Assurez-vous qu’aucun pilote n’est sélectionné pour ces imprimantes.
Cas particulier de la configuration Epson¶
La plupart des imprimantes Epson prennent en charge l’impression de reçus dans Odoo PdV à l’aide de la commande GS v 0
. Cependant, les modèles d’imprimantes Epson suivants ne prennent pas en charge cette commande :
TM-U220
TM-U230
TM-P60
TMP-P60II
Contournez ce problème en configurant l’imprimante pour qu’elle utilise plutôt la commande ESC *
.
Processus pour forcer la commande ESC *¶
Compatibilité de l’imprimante Epson¶
La première étape consiste à vérifier si l’imprimante n’est pas incompatible avec la commande GS v 0
.
Pour plus d'infos
Documentation Epson GS v 0 pour les imprimantes compatibles avec
GS v 0
.Documentation Epson ESC * pour les imprimantes compatibles avec
ESC *
.
Si l’imprimante n’est pas compatible avec la commande ESC *
, le processus suivant n’est pas possible. Si l’imprimante est compatible avec la commande ESC *
pour imprimer, suivez cette procédure pour configurer l’imprimante avec l”IoT box.
Configuration de l’IoT box pour ESC *¶
Pour configurer l”IoT box pour qu’elle utilise la commande ESC *
pour imprimer, allez à la page d’accueil de l”IoT box en allant à l’application . Cliquez ensuite sur l”adresse IP et vous serez redirigé vers la page d’accueil de l”IoT box.
Choix de l’imprimante
Cliquez maintenant sur le bouton Serveur d’imprimantes. Le navigateur sera redirigé vers la page CUPS. Allez ensuite à , choisissez l’imprimante qui doit être modifiée et cliquez sur Continuer.
Astuce
Si le nom de l’imprimante n’est toujours pas connu, suivez les étapes suivantes :
Prenez note des imprimantes répertoriées sur la page CUPS.
Éteignez l’imprimante et actualisez la page.
Voyez maintenant s’il y a une différence avec la première liste pour voir quelle imprimante a disparu.
Remettez l’imprimante sous tension et actualisez à nouveau la page.
Vérifiez à nouveau la liste pour voir si l’imprimante réapparaît.
L’imprimante qui disparaît et qui réapparaît dans la liste des imprimantes est le nom de l’imprimante en question.
Note
Il peut s’agir d”Inconnu dans Imprimantes locales.
Convention d’appellation de CUPS
CUPS
will prompt the administrator for three pieces of information: the Name,
Description and the Location. The last two pieces of information do not need
to be specific, however, the Name should follow a particular convention to work with the
ESC *
command.
Le Nom doit correspondre à cette convention : <printer_name>__IMC_<param_1>_<param_2>_..._<param_n>__
Détail de la convention d’appellation :
printer_name
: Il s’agit du nom de l’imprimante. Il peut être composé de n’importe quel caractère tant qu’il ne contient pas_
,/
,#
, or ` ` (caractère espace).IMC
: C’est l’abréviation d”Image Mode Column (nom simplifié deESC *
).param_1
: Il s’agit du paramètre spécifique :SCALE<X>
: Échelle de l’image (avec le même rapport d’aspect).X
doit être un entier décrivant le pourcentage d’échelle à utiliser.Example
100
est la taille originale,50
est la moitié de la taille et200
est le double de la taille.LDV
: Faible densité verticale (sera défini sur Densité verticale élevée si ce n’est pas précisé).LDH
: Faible densité horizontale (sera défini sur Densité horizontale élevée si ce n’est pas précisé).Note
Il se peut que les paramètres de densité doivent être configurés d’une manière particulière en fonction du modèle d’imprimante.
Pour plus d'infos
Consultez la documentation d’Epson relative à ESC * et cliquez sur le modèle d’imprimante dans le tableau ci-dessus pour voir si l’imprimante doit définir ces paramètres.
Example
Voici des exemples de formatage de nom correct et incorrect :
Formatage de nom correct :
EPSONTMm30II__IMC__
EPSON_TM_U220__IMC_LDV_LDH_SCALE80__
Formatage de nom incorrect (cela n’empêche pas l’impression, mais le résultat risque de ne pas être celui attendu) :
EPSON TMm 30II
-> The name cannot have spaces.EPSONTMm30II
-> The name itself is correct, but it will not useESC *
.EPSONTMm30II__IMC
-> Il manque la fin__
à ce nom.EPSONTMm30II__IMC_XDV__
-> Le paramètreXDV
ne correspond à aucun paramètre existant.EPSONTMm30II__IMC_SCALE__
-> Il manque la valeur d’échelle du paramètreSCALE
.
Terminer l’ajout d’une imprimante
Après avoir configuré le nom de l’imprimante avec la bonne convention d’appellation, cliquez sur Continuer. Définissez ensuite la valeur Marque sur Raw et la valeur Modèle sur Raw Queue (en).
Après avoir complété ces étapes, cliquez sur Ajouter une imprimante. Si la configuration a été faite correctement, la page devrait rediriger vers la page Bannières.
À ce stade, l’imprimante doit être créée. Il suffit maintenant que l”IoT la détecte et se synchronise avec le serveur Odoo (cela peut prendre quelques minutes).
Ajout de l’imprimante à Odoo PdV
Once the printer is visible on the Odoo database, do not forget to choose it in the PoS printer. Navigate to
.Note
Si l’imprimante a été mal configurée (elle imprime toujours un texte aléatoire ou le reçu imprimé est trop grand ou trop petit), elle ne peut pas être modifiée via le nom de l’imprimante avec CUPS. En revanche, vous pouvez répéter la procédure susmentionnée pour configurer une autre imprimante à partir de zéro et en créer une avec des paramètres modifiés.
Exemple de configuration de l’imprimante Epson TM-U220B à l’aide de ESC
Voici un exemple de processus de dépannage pour un modèle d’imprimante TM-U220B à l’aide de la commande ESC *
. Le reçu suivant est un exemple de reçu qui s’imprime correctement grâce à un formatage adéquat (en théorie) :
Essayer d’imprimer le reçu immédiatement avant le formatage correct ne fonctionnera pas, car le modèle d’imprimante TM-U220B ne prend pas en charge GS v 0
. Il imprimera plutôt des caractères aléatoires :
Pour correctement configurer le formatage pour le modèle Epson TM-U220B, suivez les étapes suivantes :
Après avoir consulté le site web d’Epson pour vérifier la compatibilité des deux commandes : GS v 0 et ESC *, vous pouvez voir que le modèle TM-U220B n’est pas compatible avec GS v 0
, mais qu’il l’est avec ESC *
.
Lors de l’ajout de l’imprimante, CUPS demande quelle imprimante doit être ajoutée :
Dans ce cas, l’imprimante est connectée via USB et ne fait donc pas partie des Imprimantes réseau découvertes. Elle fait probablement partie de la sélection Inconnu dans Imprimantes locales. En débranchant le câble USB de l’imprimante de l”IoT box et en actualisant la page, l’imprimante Inconnu disparaît. En la rebranchant, l’imprimante réapparaît, donc on peut confirmer qu’il s’agit de l’imprimante en question.
For the naming convention, since it needs to print using the ESC *
command, it is imperative to
add __IMC
. Reference the printer model on Epson’s ESC * site to find out more
about the density parameters.
Pour ce modèle en particulier, TM-U220, m
doit être égal à 0 ou 1. En se référant à la Description sous l’encadré rose dans l’image ci-dessus, les valeurs m
doivent être 0, 1, 32 ou 33. Donc dans le cas de cette imprimante, la valeur m
ne peut PAS être 32 ou 33 (sinon, des caractères aléatoires seront imprimés).
Le tableau comprend les valeurs numériques : 32 et 33, qui se produisent toutes deux si le Nombre de bits pour les données verticales est défini sur 24. Ceci signifie que la densité verticale est élevée. Dans le cadre de la configuration de l’imprimante Epson TM-U220, la faible densité verticale doit être forcée, car ce modèle d’imprimante ne prend pas en charge la densité verticale élevée pour cette commande ESC *
.
Pour ajouter une Faible densité verticale, ajoutez le paramètre LDV
à la convention d’appellation.
Cliquez sur Continuer pour continuer. Définissez ensuite la valeur Marque sur Raw et la valeur Modèle sur Raw Queue (en).
However, when trying to print with the naming convention: EpsonTMU220B__IMC_LDV__
, it prints
the receipt, but it is too big and outside the margin. To resolve this, add a new printer (and
naming convention) with the SCALE<X>
parameter to adapt to our receipt size.
Voici quelques exemples :
Convention d’appellation de l’imprimante |
|
|
|
|
---|---|---|---|---|
DYMO LabelWriter print issue¶
The DYMO LabelWriter has a known issue in printing with the IoT box. The OpenPrinting CUPS server installs the printer using Local RAW Printer drivers. In order to print anything, the correct Make and Model needs to be set, so the correct driver is referenced when using the device.
Additionally, a new printer needs to be added to reduce a print delay that occurs after updating the driver.
Important
The DYMO LabelWriter 450 DUO printer is the recommended DYMO printer for use with Odoo and the IoT box. It must already be connected to, and recognized on, the IoT box.
The DYMO LabelWriter 450 DUO printer contains two printers in one: a label printer and a tape printer. Choosing the correct model (either DYMO LabelWriter 450 DUO Label (en) or DYMO LabelWriter 450 DUO Tape (en)) is crucial when configuring the following processes.
To keep things consistent, both of the following processes detail the configuration for the DYMO LabelWriter 450 DUO Label (en) model. Change the model when needed.
DYMO LabelWriter not printing¶
In the case where the DYMO LabelWriter is not printing anything, a new driver needs to be installed.
First, open the OpenPrinting CUPS console by clicking Maintenance in the first drop-down menu. Then, select Modify Printer in the second drop-down menu.
at the bottom of the IoT box homepage. Next, click on in the top menu. Click into the printer in question, and selectNext, select the specific network connection/printer that the modification should be made on. Click Continue.
On the next page, click Continue to proceed to set the Make of the printer.
Under Make select DYMO from the menu. Click on Continue to set the Model.
On the following page, set the Model to DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used). Click on Modify Printer to complete setting the new driver, a confirmation page will appear.
After being redirected to a confirmation page, acknowledging a successful update, click on the
button in the top menu.All the printers installed on the OpenPrinting CUPS server appear, including the newly updated: DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used). Click into the printer that was just updated.
To print a test label, click on the Maintenance drop-down menu to the left of the Administration drop-down menu, and select Print Test Page. The test label will print out with a ten-second delay if the driver update was successful.
To reduce this delay a new printer will need to be added, follow the process below.
DYMO LabelWriter print delay¶
To resolve the delay issue after modifying the driver, the printer must be reinstalled. To reinstall the printer, open the OpenPrinting CUPS administration page by clicking Add a Printer.
, at the bottom of the IoT box homepage. Then, click on in the top menu, then clickAstuce
If the DYMO LabelWriter 450 DUO printer is not printing at all, or is not recognizable (has a RAW driver type), then update the drivers on the device. See DYMO LabelWriter not printing.
On the next screen, in the Local Printers section, select the DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label) (or whichever DYMO printer model is being used) pre-installed printer. Click Continue.
On the following screen, modify the Name to something recognizable, as the original printer will still be present. Click Continue to be taken to the next screen.
Next, choose the Model. Select DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used), and finally, click Add Printer to complete the installation.
After being redirected to a confirmation page, acknowledging a successful installation, click on the
button in the top menu.All the printers installed on the OpenPrinting CUPS server appear, including the newly installed: DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used). Click into the printer that was just installed.
To print a test label, click on the Maintenance drop-down menu to the left of the Administration drop-down menu, and select Print Test Page. The test label should print out immediately (one-to-two seconds delay).
The Zebra printer does not print anything¶
Les imprimantes Zebra sont très sensibles au format du code Zebra Programming Language (ZPL) qui est imprimé. Si l’imprimante n’imprime rien ou des étiquettes vierges, essayez de modifier le format du rapport qui est envoyé à l’imprimante en accédant aux mode développeur et recherchez le modèle correspondant.
enPour plus d'infos
Consultez les instructions de Zebra relatives à l’impression des fichiers ZPL ici.
Lecteur de codes-barres¶
The characters read by the barcode scanner do not match the barcode¶
Par défaut, la plupart des lecteurs de codes-barres sont configurés au format QWERTY américain. Si le lecteur de codes-barres utilise une disposition différente, allez à la vue formulaire de l’appareil (
) et sélectionnez le bon format.Rien ne se passe lorsqu’un code-barres est scanné¶
Assurez-vous que vous avez sélectionné le bon périphérique dans la configuration du ENTER
(keycode 28) à la fin de chaque code-barres. Pour ce faire, allez à l’application .
Le lecteur de codes-barres est détecté comme un clavier¶
Important
Certains lecteurs de codes-barres ne s’affichent pas comme des lecteurs de codes-barres, mais comme des claviers USB et ne seront pas reconnus par l”IoT box.
Vous pouvez manuellement modifier le type de périphérique en allant à sa fiche (Est un lecteur.
) et en activant l’optionBarcode scanner processes barcode characters individually¶
When accessing the mobile version of Odoo from a mobile device, or tablet, paired with a barcode scanner, via the IoT box, the scanner may process each barcode character as an individual scan. In this case, the Keyboard Layout option must be filled out with the appropriate language of the barcode scanner on the Barcode Scanner form page.
Astuce
Access the barcode scanner form page by navigating to
.The Keyboard Layout is language based, and the options available vary, depending on the device and the language of the database. For example: English (UK), English (US), etc.
Tiroir caisse¶
Le tiroir caisse ne s’ouvre pas¶
Le tiroir caisse doit être connecté à l’imprimante et la case de Tiroir caisse doit être cochée dans la configuration du PdV. Pour ce faire, naviguez à l’application .
Balance¶
Scales play a crucial role in the checkout process, especially for products sold by weight, rather than fixed pricing.
Set up Ariva S scales¶
Odoo has determined that a specific setting in Ariva S series scales (manufactured by Mettler-Toledo, LLC.) needs modification, and a dedicated Mettler USB-to-proprietary RJ45 cable is required for the scale to function with Odoo’s IoT box.
To correctly configure the scale for recognition by the IoT box, follow this setup process for the Ariva S series scales.
Important
It is crucial to use the official Mettler USB-to-RJ45 cable during this process.
Cable¶
The Mettler part number is 72256236 - USB-to-POS cable. Contact Mettler, or a partner, to purchase an authentic cable. Note that no other cable outside of this Mettler cable works for this configuration. Using a serial-only cable attached to a serial-to-USB adapter is not effective.
Configuration¶
Refer to Mettler’s Setup Guide for Ariva S series scales during the following configuration: Ariva Checkout Scale User’s Guide.
To begin, go to page 17 in the above manual for Setup. This guide lists potential settings for the Ariva S series scales.
Follow the instructions, along with the following process, to set the scale to setup mode. First, hold the >T< button for eight seconds, or until CONF appears.
Next, press >T< until GRP 3 appears, then press >0< to confirm.
Under 3.1, ensure the setting is set to 1 (USB Virtual COM ports). Press >T< to cycle through the options under group 3.1.
Once 3.1 is set to 1, press >0< to confirm the selection. Continue to press >0< until GRP 4 appears.
Now, press >T< until EXIT appears.
Important
Do not make any other changes unless otherwise needed.
Once EXIT appears, press >0<. Following this, press >0< again to SAVE. Now the scale restarts.
Finally, restart the IoT box to recognize the changes made on the
scale’s configuration. After restarting, the scale appears as Toledo 8217
, as opposed to the
previous display, where it appeared as Adam Equipment Serial
.