Skip to main content

ePaper application usage

How does it work?

The ePaper application differs from our Signage application in a way that it is not always connected to a server, rather it wakes up after sleeping for a set amount of time and re-checks on the server if anything has changed in the assigned content.

  • The amount of sleep time is 10 minutes by default, but it is customizable with the Synchronization Configuration advanced configuration of which more information can be found here.

  • While the ePaper device sleeps, it does not receive updates from the server, which means any content or device settings change will only be applied the next time the device wakes up.

Installation

You can install the ePaper application on your device automatically with Wallboard Toolbox or manually using our guides

First time usage

When the ePaper device is first assigned to a server it will display the 4-digit application code and go back to sleep for 2 minutes by default.

  • It will repeat this cycle until it is assigned to a customer on the server and receives its first content.
After assigning and setting up the ePaper device it might seem to be stuck on the screen with the activation code.

This behaviour is normal. Wait for 2 minutes until it wakes up and re-checks everything on the server.

Displaying content on an ePaper screen

You can display content onto ePaper devices by simply assigning a slide, content or a playlist to the screen.

  • You can do so by entering the device settings then selecting the Assign content option.
  • Also you can click the three dots when hovering a device card in devices then selecting the Assign content option.
  • To learn more about contents click here.

wbeink1.png

There are 2 types of displayable content on ePaper devices.

Using Slides/Contents

EPaper supports slides and contents, but since it’s an ePaper display, it can’t show moving media. Instead, it captures a still snapshot of the whole content which has dynamic elements like GIFs or videos.

To learn more about contents click here.

Using playlists

Playlists can be used to display pictures on the ePaper devices.

Important

When creating playlists for ePaper devices makes sure to check the ePaper mode option.

This option will only allow ePpaer supported playlist features and file types.

Supported file types: bmp, png, jpg, jpeg, webp, gif Learn more: ePaper mode playlists.

Device management

Updating the ePaper application

The ePaper application updates itself automatically but supports update management where you can set the version limit and when the device can update.

Learn more: Update management.

Wake-up time configuration

Configuration with Page duration

Use the Settings > Device and Page duration (seconds) to set-up wake-up time.

  • This method fills out advanced configuration with fixed time automatically.

Configuration with fixed time

Use the Settings > Advanced configuration to set-up wake-up time.

{
"configuration": [
{
"type": "CONFIG_SYNCHRONIZATION",
"syncPeriodMillis": 86400000
}
]
}
  • syncPeriodMillis specifies how long the device will sleep in milliseconds. In this case it is set to 86400000 (1 day).

Configuration with cron expression

Use the Settings > Advanced configuration to set-up wake-up time.

{
"configuration": [
{
"type": "CONFIG_SYNCHRONIZATION",
"syncPeriodCron": "0 0 12 ? * * *"
}
]
}
  • syncPeriodCron specifies a cron expression which tells the device when to wake up. In this case it is set to 12:00:00 am every day.

If you want to use a different time period use a cron expression generator to get the desired value.

The device will change Content and Playlist pages at every wake-up.

caution

Do not use both syncPeriodMillis and syncPeriodCron in the same configuration, if both are used then the syncPeriodCron parameter will be used by the application.

Working Hours

Working hours allows you control the operational time of your ePaper device.

Working hours on ePaper devices work the following way:

  • First it calculates the next wake up time based on the Page duration
  • If it is within the set working hours it will wake up at that time.
  • If it is not within the set working hours it will find the very next allowed time and wake up then.

This ensures the device does not wake up at unnecessary times, saving additional energy.

To learn more about working hours click: here.

Offine mode

When the ePaper device cannot connect to the internet or reach the server, it automatically switches to a limited offline mode.

  • Each time the device wakes up and successfully communicates with the server, it stores its current state and other relevant information locally.
  • If the server becomes unreachable for any reason, the device relies on this stored data to continue operating in offline mode.
  • While in offline mode, the device cannot receive new instructions from the server. Instead, it continues functioning based on the most recent information it retrieved.
Please keep in mind that the device will only act upon any changes once it wakes up again after a change.:::