====== Customer Display Screen ======

===== Requirements =====

CloudHQ4 Mobile POS Account

Stable internet connection

  * Does not require same internet connection as POS as both systems talk to an external server

Android tablet

  * Android version: 5.1 or greater
  * Screen size: 7" or greater (smaller screens may work but are untested)

===== Installation =====

Visit the Google Play Store and search for 'cloudhq4'

The 'CloudHQ4 Display Screen' app will be available if your device is suitable. Install as usual.

https://play.google.com/store/apps/details?id=com.cloudhq4.display_screen

===== Configuration =====

==== Mobile POS Settings ====

Sign on as a user that has access to the settings screen

Click the cog icon at the top of the screen to access the settings

{{:start:add_ons:mobile_pos:mobile_pos_-_settings_icon.png|}}

Click on the General Tab

If the 'Display Screen' option is unticked, tick it

{{:start:add_ons:mobile_pos:mobile_pos_-_general_tab_-_display_screen_disabled.png|}}

Take note of the display screen code as you will need to enter this in the Display Screen app

{{:start:add_ons:mobile_pos:mobile_pos_-_general_tab_-_display_screen_enabled.png|}}

Ensure the status field says 'Connected' otherwise check your internet connection

Once completed, click the save button in the bottom right corner to save the settings

==== Display Screen Connection ====

Open the app on the tablet. If this is the first time the app has been run, then you should be presented with the following screen.

{{:start:add_ons:mobile_pos:display_screen_-_empty_connection.png?600|}}

If you need to reset the connection, just double tap in the top left corner of the screen and this should bring up the settings screen and you can then click on the orange 'Connection' button

Enter in the linking code from the Mobile POS settings (as discussed above) and then click connect. If there is internet connection and the POS software is running, the screen should now link up and start downloading any images that have been set.

{{:start:add_ons:mobile_pos:display_screen_-_connection_in_progress.png?600|}}

Lastly, test everything is working correctly by selling an item on the POS, it should appear on the display like below

{{:start:add_ons:mobile_pos:display_screen_-_testing_communication.png?600|}}
==== Display Screen Settings ====

{{:start:add_ons:mobile_pos:display_screen_-_settings.png?600|}}

Display Type:

  * Customer Display - will show items when a transaction on the POS is taking place
  * Advertising screen - ignores transactions and only shows advertising at all times

Screen Number:

  * Advertising screen only - used to determine which screen images to display in a multi screen environment

Image Rotation Timer:

  * How many seconds to display each image

Decimal Places:

  * When showing transaction information, how many decimal places to display for qty information (more may be required when displaying weighable items)

Show Images In Sale:

  * Split advertising and sale details (when ticked) or use fullscreen to display sale information (not ticked)

Show Discount Information:

  * Show discount information (ie, orig price & discount price)