ATC_BLE_OEPL¶

There is a firmware for elink TLSR8359 based price tags forked from OpenEPaperLink which has BLE enabled.

Gadgetbridge implements support for this firmware. Tested with V101 through V105

Currently supported features:¶

• get display info
• set the display type
• set the ble advertising interval (set to a higher value to save power)
• enable/disable oepl compatibility (disable to save power)
• send and image to the device

Missing firmware features:¶

• enable/disable clock mode (will be implemented)
• setting custom mac (unsure)
• advanced lowlevel config of pinout (probably better not to expose that, not planned)
• custom config of display controller eg width/height (probably better to just add new display types to the settings, not planned)

Shortcomings¶

• GB pretends the native colors are pefect yellow and perfect red, this is actually not true, and let's the dithering algorithm dither to a color that is a bit off. This should be calibrated, but is hard to do because different models have a diffrent color balance

Preparation¶

Get the firmware¶

wget https://atc1441.github.io/ATC_BLE_OEPL.bin

Prepare the device¶

1. Open it (some are sealed unibody device, try to not damage the battery when cutting/sawing the case)
2. Locate SWS, GND and NRST and solder wires (without battery, also solder a wire to 3V3)
3. Use an USB UART adapter, connect SWS to TXD, GND to GND and NRST to a antother GND pin of your flasher (without battery connect 3V3 to 3V3)

Flash the firmware¶

Connect an USB UART device, use chromium and navigate to here https://atc1441.github.io/ATC_TLSR_Paper_UART_Flasher.html

1. Open the com port of your UART USB Adapter
2. Click Unlock flash, when it says "Activate" in the logs, disconnect NRST from GND
3. Select the downloader ATC_BLE_OEPL.bin
4. reconnect NRST to GND
5. press "Write To Flash"
6. When it says "Activate" in the logs, disconnect NRST from GND again
7. Wait until flashing finishes, you can leave cables connected
8. try to find the device in Gadgetbridge, if it does not show up, connect NRST to GND again and disconnect and try to find it again. It is normal, that you cannot see anything on screen yet

Configure the firmware to match your display type¶

1. Your device being connected to Gadgetbridge, open the device specific settings (cog icon) and select your display
2. The device will reboot and (hopefully) show the "BLE OpenEpaperLink" screen
3. DONE!

Sending an image to the device¶

You can send images to the device by sharing an image from the gallery and opening the Gadgetbridge fw/app installer.

To prevent dithering, use the following colors

• perfect black (000000)
• perfect white (ffffff)
• perfect red (ff0000)
• perfect yellow (ffff00)

It will be scaled to the actual display size.