summaryrefslogtreecommitdiffstats
path: root/_site/log/e-reader/index.html
blob: 13b4efa605b72e789e3627aebb5e0f59683489d2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<!DOCTYPE html>
<html>
    <head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>512KB e-reader</title>
  <link rel="stylesheet" href="/assets/css/main.css">
  <link rel="stylesheet" href="/assets/css/skeleton.css">
</head>


  <body>

    <div id="nav-container" class="container">
  <ul id="navlist" class="left">
    
    <li >
      <a href="/" class="link-decor-none">hme</a>
    </li>
    <li >
      <a href="/projects/" class="link-decor-none">poc</a>
    </li>
    <li >
      <a href="/about/" class="link-decor-none">abt</a>
    </li>
    <li>
      <a href="/cgi-bin/find.cgi" class="link-decor-none">lup</a>
    </li>
    <li>
      <a href="/feed.xml" class="link-decor-none">rss</a>
    </li>
  </ul>
</div>



    <main>
      <div class="container">
        <div class="container-2">
          <h2 class="center" id="title">512KB E-READER</h2>
          <h5 class="center">24 OCTOBER 2023</h5>
          <br>
          <div class="twocol justify"><p>First project with e-paper.</p>

<video style="max-width:100%;" controls="" poster="poster.png">
  <source src="ereader.mp4" type="video/mp4" />
</video>

<p>ESP-WROOM-32, 7.5” Waveshare e-paper display, three-button interface
(prev/next/sleep).</p>

<p>Memory: 512KB SRAM + 4MB flash. Internal flash unsuitable for storing books due
to P/E cycle limit. Used HTTP Range requests to stream them on-demand.
Progress saved to RTC memory to survive deep sleep without flash wear.</p>

<p>PDFs are rasterized and stored as sequences of bitmaps on a server. 1 byte = 8
pixels, 1 page = 48KB (display resolution), headerless. Optimized for Range
requests without server-side logic:</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>int r0 = ((page_n - 1) * PAGE_SIZE);
int rn = page_n * PAGE_SIZE - 1;

int n = snprintf(NULL, 0, "bytes=%d-%d", r0, rn) + 1;
char *buf = malloc(sizeof(char) * n);
snprintf(buf, n, "bytes=%d-%d", r0, rn);

esp_http_client_set_header(http_client, "Range", buf);
esp_http_client_perform(http_client);
</code></pre></div></div>

<p>Three pages (prev/current/next) held in a buffer—maximum possible. Upon
request, embedded software cycles the buffer, updates the screen, prefetches
the next page.</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>c_page_num++;
pg.page_num = c_page_num + 2;
pg.page_buf = pages[(c_page_num + 1) % PAGE_LEN];

xSemaphoreGive(mutex);
xQueueSend(http_evt_queue, &amp;pg, portMAX_DELAY);

epd_draw_async(pages[c_page_num % PAGE_LEN], PAGE_SIZE);
epd_draw_await();
</code></pre></div></div>

<p>System isn’t as responsive as I’d hoped. Scheduling GPIO, SPI, and HTTP tasks
on a single thread causes input lag. Pinned GPIO/SPI tasks to one core and the
HTTP task to the other.</p>

<p>Better, but screen updates block user input.</p>

<p>Moved the SPI buffers to DMA and made the transfers async. Few more cycles
saved.</p>

<p>Can’t think of anything else.</p>

<p>Verdict: Functional but limited. Led to <a href="../etlas/">Etlas</a>.</p>

<p>Commit:
<a href="https://git.asciimx.com/esp32-e-reader/commit/?id=7f691c46093933b67aab466c0ca582ace8ab73d4">7f691c4</a></p>
</div>
          <p class="post-author right">by W. D. Sadeep Madurange</p>
        </div>
      </div>
    </main>

    <div class="footer">
  <div class="container">
    <div class="twelve columns right container-2">
      <p id="footer-text">&copy; ASCIIMX - 2026</p>
    </div>
  </div>
</div>


  </body>
</html>