收銀台(POSBox) 配置向導

 

先決條件

在開始設置您的POSBox之前, 確保你准備好了一切。 你會需要 :

• POSBox

• 2A電源適配器

• 一台帶最新的Web瀏覽器的計算機或平板電腦。

• 可用的的SaaS或已安裝零售的Odoo

• 設置了DHCP(這是默認設置)的本地網絡

• 一個RJ45以太網電纜或兼容Linux的USB Wi-Fi適配器

• 一台 Epson USB TM-T20 打印機或其他兼容的 ESC/POS 打印機 (官方的 POS 硬件支持列表)

• 霍尼韋爾的Eclipse USB條碼掃描儀或其他兼容的掃描儀

• 愛普生兼容錢箱

一步一步的安裝指南

POSBox的當前版本(2015年以來)

 

連接外圍設備

官方支持的硬件列在POS硬件頁<https ://www.odoo.com/page/pos-ipad-android-hardware>上 [UNKNOWN NODE problematic]_, 但其他硬件可能也能正常工作。

• Printer: Connect an ESC/POS printer to a USB port 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 behave as a keyboard and must be configured in US QWERTY. It also 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.
• Ethernet: If you do not wish to use Wi-Fi, plug in the Ethernet cable. Make sure this will connect the POSBox to the same network as your POS device.
• Wi-Fi: If you do not wish to use Ethernet, plug in a Linux compatible USB Wi-Fi adapter. Most commercially available Wi-Fi adapters are Linux compatible. Officially supported are Wi-Fi adapters with a Ralink 5370 chipset. Make sure not to plug in an Ethernet cable, because all Wi-Fi functionality will be bypassed when a wired network connection is available.

POSBox通電

將電源適配器插入POSBox, 紅色的狀態燈應該亮起。

確保POSBox已准備就緒

一旦供電, POSBox需要一段時間才能啟動。一旦POSBox准備就緒, 就應該打印帶IP地址的狀態條。另外, LED狀態指示燈, 旁邊的紅色電源指示燈應常亮綠色。

設置零售點

要設置在銷售點的POSBox, 請訪問 :菜單選擇: 零售點 - >配置 - > 設置 [UNKNOWN NODE problematic]並選擇您的銷售點。向下滾動到" 硬件代理/ POSBox "部分並激活您想要通過POSBox使用硬件的選項。推薦指定POSBox的IP(印在啟動后的POSBox后打印收據上)。如果未指定IP, 銷售點會試圖在本地網絡上尋找。

如果您在同一POSBox運行多個銷售點, 確保只有其中一個零售店了激活遠程掃描/條碼掃描槍。

如果在你的網絡中固定POSBox的IP地址, 是個比較好的注意。請參閱您的路由器文檔就如何實現這一目標。

啟動銷售點

如果沒有在配置指定POSBox的IP地址, POS將需要一些時間來執行網絡掃描來尋找POSBox。這種掃描只進行一次。

銷售點已經連接到POSBox, 你的硬件應該可以使用。

Wi-Fi 配置

POSBox是支持WiFi的。為了使用它, 你會需要一個Linux兼容的USB Wi-Fi適配器。大多數商用的Wi-Fi適配器兼容Linux。官方支持的是具有Ralink5370芯片組的Wi-Fi適配器。

確保不要插以太網電纜插頭, 因為當有線網絡連接可用時所有Wi-Fi相關的功能將被禁用。

當POSBox使用Wi-Fi適配器啟動時, 將以您可以連接到的被稱為“Posbox" 的自己的Wi-Fi接入點開始。POSBox啟動時的收據打印將反映這一點。為了使POSBox連接到已有的Wi-Fi網絡, 轉到POSBox的主頁(在收據上已標明), 並進入Wi-Fi配置頁面。在那里, 你可以選擇網絡連接。請注意, 我們只支持開放式和WPA(2)-PSK網絡。當連接到一個WPA保護的網絡, 填寫密碼字段。該POSBox將嘗試連接到指定的網絡, 連接后將打印新的POSBox狀態條。

如果你打算永久設置POSBox 為Wi-Fi連接, 你可以在Wi-Fi配置頁上選擇復選框為“一直" 。這將在重新啟動時網絡選擇一直選擇WIFI。這意味着, 在啟動后它將始終嘗試連接到指定的網絡而不是自己的“Posbox "網絡。

當POSBox無法連接到網絡時, 它將退回到開始了自己的“Posbox" 接入點。如果與Wi-Fi網絡丟失, POSBox會嘗試自動重新建立連接。

多POS 設置

建議設置多個零售點的商店是每個零售點一個POSBox. 在這個例子中, 必須為每個POSBox手動指定IP 地址.你還必須配置你的網絡保證每個POSBox 的IP 地址不會改變。請參考你的路由文檔。

沒有POSBox的指南(高級)

如果您運行在基於Debian的Linux的銷售點, 你可以不用POSBox, 你可以運行本地軟件。然而安裝過程並不是萬無一失的。你必須知道如何安裝和運行Odoo.你也許會遇到關於版本的, 或特定設置和硬件配置的問題。

Odoo模塊提供了對於不同類型的硬件的驅動支持。事實上, POSBox運行Odoo的銷售點通信。在POSBox運行Odoo是一個和“真正的" Odoo有很大的不同的例子。它不處理任何 [UNKNOWN NODE problematic]業務數據(如POS訂單), 僅僅是作為銷售點和硬件之間的網關。

本節的目標是要建立一個當地Odoo演示數據, 模擬在POSBox 上運行。

鏡像建立過程

我們生成正規的POSBox 鏡像使用如下腳本https ://github.com/odoo/odoo/tree/8.0/addons/point_of_sale/tools/posbox. 更加具體的話, 運行 [UNKNOWN NODE problematic]posbox_create_image.sh<https: //github.com/odoo/odoo/blob/8.0/addons/point_of_sales/tools/posbbox/posbox_create_image.sh>'.建立一個叫" posbox.img"的鏡像, 我們壓縮並上傳到'nightly.odoo.com<https ://nightly.odoo.com>'_供用戶下載。

在此目錄中的腳本對於你碰到問題或想了解更多是很有用的。

映像創建過程總結

鏡像創建進程通過下載最新 [UNKNOWN NODE title_reference] _鏡像開始。然后, 它在本地掛載這個鏡像, 復制一些文件和腳本, 這將使Raspbian鏡像把自己變成一個POSBox在啟動時。這些腳本將更新Raspbian, 刪除非必要的包和安裝所需的軟件包。為了引導Raspbian我們用QEMU, 其能夠提供ARM仿真。在此之后, 仿真Raspbian操作系統將自行關閉。然后, 我們再一次在本地掛載鏡像, 刪除被用來初始化在啟動鏡像的腳本, 我們復制了一些額外的配置文件。所產生的鏡像, 然后可以被用來進行測試和使用。

先決條件

• 基於Debian內核的Linux 版本(Debian, Ubuntu, Mint, etc)

• 一個運行的Odoo來裝載零售點

• 你必須卸載任何ESC/POS 打印機驅動, 因為它會和Odoo內置的驅動沖突。

一步一步的安裝指南

額外的依賴

由於Odoo在Python2上運行, 你需要檢查你需要使用的PIP的版本。

# pip --version

如果它返回例如 :

pip 1.5.6 from /usr/local/lib/python3.3/dist-packages/pip-1.5.6-py3.3.egg (python 3.3)

你需要PIP2

如果它返回例如 :

pip 1.4.1 from /usr/lib/python2.7/dist-packages (python 2.7)

使用 pip 工具.

驅動模塊需要安裝新的python模塊

# pip install pyserial

# pip install pyusb==1.0.0b1

# pip install qrcode

訪問權

驅動需要獲得打印機和條碼掃描儀設備的原始訪問。這樣做需要一點系統管理。首先我們要創建一個訪問USB設備的組

# groupadd usbusers

然后, 我們添加誰將會運行OpenERP的服務器" USB users "用戶

# usermod -a -G usbusers 用戶名

允許“usbusers“自動訪問USB設備, 需要創建一個udev規則。為此, 在``/etc/udev/rules.d/`` 下直接創建一個名為“99 - usbusers的文件, 文件包含以下內容:

SUBSYSTEM=="usb", GROUP="usbusers", MODE="0660" SUBSYSTEMS=="usb", GROUP="usbusers", MODE="0660" 

然后你需啊重啟你的機器。

開始本地Odoo實例。

我們必須用正確的設置啟動Odoo服務器

$ ./odoo.py --load=web,hw_proxy,hw_posbox_homepage,hw_posbox_upgrade,hw_scale,hw_scanner,hw_escpos

測試實例。

請將所有的硬件設備插到機器的USB端口, 然后轉到" http ://localhost: 8069/hw_proxy/status "" 刷新頁面幾次, 看看是否所有的設備都顯示為 連接 。錯誤的可能來源是 :linux上的路徑和驅動所期望的路徑不同, 另一個進程已經搶到了設備的獨占訪問時, udev規則不適用或他被人取代。

自動啟動Odoo

你必須確保Odoo 安裝是在啟動后自動開始。有多種方式可以實現, 如何做取決於你的特定設置.使用你的操作系統提供的安裝系統可能使最簡單的方式。

設置零售點

在POS的IP地址字段必須配置" 127.0.0.1 "or" localhost ", 如果你將在作為零售點的Odoo 服務器的機器上運行, 你也可以留空。

POSBox 技術文檔

技術總覽

收銀機(POSBox) 硬件

該POSBox的硬件是基於 [UNKNOWN NODE title_reference] _, 一個普遍的單片機。Raspberry PI 2使用2A微型USB電源適配器。需要提供2A的足夠電源給條碼掃描器。軟件安裝在8G的10級或更高的SD卡。所有這些硬件都很容易從世界性的獨立供應商處獲得。

兼容外設

官方支持的硬件, 列在'POS硬件頁<https ://www.odoo.com/page/pos-ipad-android-hardware> [UNKNOWN NODE problematic]_上。

收銀機(POSBox) 軟件

該POSBox運行一個重大的修改Raspbian Linux, 是Raspberry Debian的衍生物。它還可以運行Odoo的准系統安裝, 提供網絡服務器和驅動程序。硬件驅動被作為為Odoo模塊。這些模塊都前綴" [UNKNOWN NODE problematic] * ", 他們是POSBox運行的唯一模塊。 Odoo僅用於所提供的框架。沒有業務數據被處理或存儲在POSBox。該Odoo實例是" 8.0 "克隆。

POSBox上的根分區是只讀的,確保SD卡不會寫太多, 同時還確保文件系統不被削減。Linux應用程序期望能寫些目錄。所以, 我們提供了虛擬盤 / etc和/ var (Raspbian自動提供 了/tmp)。在``/etc/init.d/rcS``中運行腳本前, 需在``setup_ramdisks.sh``設置虛擬盤。虛擬磁盤命名為/ etc_ram和/ var_ram。大多數從/ etc、/ var出來的數據將復制到tmpfs虛擬盤。為了限制虛擬盤的大小,我們不復制這些數據(如, 相關數據)。然后將數據與原來的目錄綁定。當應用程序寫入/etc/foo/bar時, 其實是寫入/ etc_ram / foo / bar。我們也將mount / 綁定 /root_bypass_ramdisks, 以便在開發中能得到真正的/ etc、/ var。

Odoo服務器的運行Log可以在如下地方找到 :

" /var/log/odoo/odoo.log "

各種在POSBox運行的相關的腳本(如無線網絡相關的腳本)將記錄到/ var / log / syslog上, 那些消息都標有" [UNKNOWN NODE problematic] * "。

訪問POSBox

本地訪問

如果你插入一個QWERTY USB的鍵盤到POSBox的USB端口中, 如果你的計算機顯示器連接到 * HDMI * 的POSBox的端口, 你可以使用它作為一個小的GNU / Linux計算機並執行各種管理任務, 如查看一些日志。

POSBox 將自動登入作為默認終端設備。

遠程訪問

如果你有POSBox的IP地址和SSH客戶端, 你可以遠程訪問POSBox的系統。登錄憑據" pi "/" raspberry "。

升級POSBox 軟件

當你遇到問題或想要使用新實施的功能升級POSBox。

更新POSBox軟件的最好方法是下載鏡像的新版本, 並更新SD卡。該操作的詳細描述在 [UNKNOWN NODE title_reference] _, 只需用最新一期的'官方POSBox鏡像頁面找到替換的標准Raspberry Pi 鏡像<http: //nightly.odoo.com/master/posbox/> [UNKNOWN NODE problematic]_。這種升級方法將確保您正在運行最新版本的POSBox軟件。

升級的第二個方法是通過內置的升級界面訪問POSBox主頁。這樣升級的好處是, 你不必換一個新鏡像。這種升級方法受限於有些不能做。例如不能更新安裝配置文件(/etc/hostapd.conf)。它只能升級 :

• 內部Odoo應用

• 腳本在文件夾" odoo/addons/point_of_sale/tools/posbox/configuration/ "

如有疑問, 一定要使用升級的第一個方法。

疑難解答

該POS無法連接到POSBox

• 最簡單的方法確保POSBox是正確的設置, 是把它與打印機插入, 因為它會在POSBox的IP地址設置成功的情況下打印收據顯示任何遇到的錯誤。如果不打印收據, 請執行下列步驟 :

• 確保POSBox是通電的, 明亮的紅色狀態指示燈亮。

• 確保POSBox已經准備好, 這是由一個紅色電源狀態指示燈后面的綠色狀態指示燈指示。在啟動后的POSBox應該准備〜2分鍾。

• 確保POSBox連接到POS設備的相同網絡。無論是設備和POSBox應該在你的網絡中路由器連接的設備的列表中可見。

• 確保你的局域網已用DHCP設置,並賦予IP地址范圍 192.168.0.X, 192.168.1.X, 10.0.0.X. 如果不能這樣設置, 那就手動設置POSBox的IP地址。

• 如果你在配置中指定POSBox的IP地址, 確保它符合POSBox上的收據打印需求。

• 確認 POS 部分未開啟 HTTPS 訪問.

• Firefox的HTTP實施時的一個故障可防止自動運行。使用火狐瀏覽器時, 你應在POS配置中手動設置POSBox 的IP地址。

條碼槍不能使用

• 在US QWERTY中配置條形碼掃描儀, 掃碼后輸入。這是大多數條形碼掃描儀的默認配置。有關更多信息,請參閱條形碼文檔。

• POSBox需要2A電源和一些條形碼掃描儀。如果你不使用提供的電源,確保你使用電源的功率。

• 一些條形碼掃描儀將需要超過2A的電源, 有時即使提供了電源也不可靠。在這些情況下,你可以把條形碼掃描器連接在自供電的USB集線器上。

• 一些簡陋的條形碼掃描儀是作為usb鍵盤, 而不是條形碼掃描儀, 這將不被POSBox認可。

條碼槍確實不能使用

• 確保不超過一個設備同時與'Scan via Proxy'/'Barcode Scanner'連接到POSBox使用。

打印小票太慢

• 打印前有稍許延遲是正常的, POSBox接下來會做一些預處理加快打印。如果之后再有延遲, 很可能是POS和POSBox之間網絡連接的問題。

收據上打印出來的字母有些錯誤

• POSBox不支持所有的語言和文字。基於日語的支持, 目前支持拉丁文和斯拉夫語。

打印機處於離線

• 確保打印機是連接, 有電源,有足夠的紙, 它的蓋子是關閉的, 並且沒有報告錯誤。如果錯誤出現, 請聯系技術支持。

錢箱無法打開

• 現金盒應該連到打印機, 在POS中應將設置激活