OVERVIEW

usec-133-linux-usb-example is a ready to use app example and fast, free and fully portable C library for linux-based computers and Unisystem USEC/USEM e-paper controllers equipped with 13.3-inch display.

LIBRARY API

usec_dev.c and usec_dev.h files provide minimal set of optimized functions for performing common tasks like e-paper module intialization, uploading new content and updating display:

usec_ctx *
usec_init                    (const uint8_t  *dev_path);

void
usec_deinit                  (usec_ctx       *ctx);

uint8_t
usec_get_temp                (usec_ctx       *ctx,
                              uint8_t        *temp_val);

uint8_t
usec_get_vcom                (usec_ctx       *ctx,
                              uint16_t       *vcom_val);

uint8_t
usec_img_upload              (usec_ctx       *ctx,
                              uint8_t        *img_data,
                              size_t          img_size,
                              uint8_t         img_bpp,
                              uint32_t        img_pos_x,
                              uint32_t        img_pos_y,
                              uint32_t        img_width,
                              uint32_t        img_height);

uint8_t
usec_img_update              (usec_ctx       *ctx,
                              uint32_t        area_pos_x,
                              uint32_t        area_pos_y,
                              uint32_t        area_width,
                              uint32_t        area_height,
                              uint8_t         update_mode,
                              uint8_t         update_wait);

MINIMAL USAGE EXAMPLE

Thanks of highly-optimized API, fully working example needs only few lines of code:

int
main()
{
  usec_ctx *ctx;
  uint8_t status;

  /* initialize controller */
  ctx = usec_init();
  if (ctx == NULL)
    {
      printf ("[error] cannot initialize e-ink controller\n\r");
      return;
    }

  usec_img_upload(...)
  usec_img_update(...)

  /* cleanup */
  usec_deinit(ctx);

  return EXIT_SUCCESS;
}

APP COMPILATION

[1] Clone usec-133-linux-usb-example repository:

cd ~
git clone https://github.com/UnisystemDisplays/usec-133-linux-usb-example.git

[2] [optional] Install provided 99-UniEPDC133BWN0.rules udev file - thanks of that e-paper controller always will be visible in system as /dev/eink_usec_133BWN0 device:

cd usec-133-linux-usb-example
sudo cp 99-UniEPDC133BWN0.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

[3] Build and run demo application:

make
sudo ./usec-133-linux-usb-example

GETTING HELP

Please contact Unisystem support - lukasz.skalski@unisystem.com or jacek.marcinkowski@unisystem.com

LICENSE

See LICENSE.txt file for details.