summaryrefslogtreecommitdiffstats
path: root/_site/projects/etlas/index.html
blob: 32995cdeb322ff53a74d36026c875cd0fd6ae49e (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
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>Etlas: e-paper dashboard</title>

    <head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Etlas: e-paper dashboard</title>
  <link rel="stylesheet" href="/assets/css/main.css">
  <link rel="stylesheet" href="/assets/css/skeleton.css">
</head>



  </head>
  <body>

    <div class="container">
  <ul id="navlist" class="left">
    
    <li >
      <a href="/" class="link-decor-none">hme</a>
    </li>
    <li >
      <a href="/archive/" class="link-decor-none">blg</a>
    </li>
    <li class="active">
      <a href="/projects/" class="link-decor-none">poc</a>
    </li>
    <li >
      <a href="/about/" class="link-decor-none">abt</a>
    </li>
    <li><a href="/feed.xml" class="link-decor-none">rss</a></li>
  </ul>
</div>



    <main>
      <div class="container">
        <h2 class="center" id="title">ETLAS: E-PAPER DASHBOARD</h2>
        <h6 class="center">05 SEPTEMBER 2024</h5>
        <br>
        <div class="twocol justify"><p>Etlas is a news, stock market, and weather tracker powered by an ESP32 NodeMCU
D1, featuring a 7.5-inch <a href="https://www.waveshare.com/" class="external" target="_blank" rel="noopener noreferrer">Waveshare</a> e-paper display and a
DHT22 sensor module.</p>

<table style="border: none;">
  <tr style="border: none;">
    <td style="border: none;"><img src="dash.jpg" alt="front" style="width: 100%" /></td>
    <td style="border: none;"><img src="pcb.jpg" alt="back" style="width: 100%" /></td>
  </tr>
</table>

<p>The top left panel displays the end-of-day stock prices from the <a href="https://polygon.io/" class="external" target="_blank" rel="noopener noreferrer">Polygon.io</a> API, relayed through my own
FastCGI-wrapped Flask app hosted on a VPS. The stock symbols can be configured
through the Flask app’s application settings. The server.fcgi script enclosed
in the tarball at the end of the page contains the Flask app.</p>

<p>The following diagram outlines this system architecture.</p>

<p><img src="etlas_arch.png" alt="architecture" /></p>

<p>Unlike my <a href="/projects/e-reader">e-reader</a>, which worked with raster images,
Etlas downloads time series data as CSV and computes the price curves on the
ESP32.</p>

<p>The more prominent panel on the right of the e-paper display shows local
(Singapore) and world news from the <a href="https://www.channelnewsasia.com/" class="external" target="_blank" rel="noopener noreferrer">Channel News Asia</a>
RSS feed. The MCU downloads and parses XML data from the RSS feed directly
before rendering it to the display. Although I did it this way to avoid writing
server code, it limits the feeds from which Etlas can receive data. In a future
version, I will relay the RSS feed through a server (like the stock prices) to
make it more flexible.</p>

<p>The bottom panels (middle and right) display the temperature and relative
humidity from a DHT22 sensor. The DHT22 driver, arguably the most interesting
part of the software, reads real-time sensor data by comparing relative pulse
widths. The pulses themselves are too quick for the ESP32 to reliably measure
directly. I ported <a href="https://github.com/Fonger/ESP8266-RTOS-DHT" class="external" target="_blank" rel="noopener noreferrer">this</a>
implementation for ESP8266 modules to my ESP32. All credit for the algorithm
belongs to them.</p>

<p>Much of the heavy lifting of acquiring, interpreting, and rendering data from
different data sources is performed on the microcontroller using less than 512
KB of memory. The embedded software that makes that possible is written in C
using the ESP-IDF v5.2.1. My e-paper display driver is a port of Waveshare <a href="https://github.com/waveshareteam/e-Paper" class="external" target="_blank" rel="noopener noreferrer">examples</a> for Arduino
and STM32 platforms.</p>

<p>I’ve been using Etlas daily (for a couple of hours on weekdays and all day on
weekends) since August 2024. As of October 2025, it’s been running reliably for
over a year. If you are interested in an e-paper display like this, drop me an
email at the address on my home page.</p>

<p>Files: <a href="source.tar.gz">source.tar.gz</a></p>
</div>
        <p class="post-author right">by Wickramage Don Sadeep Madurange</p>
      </div>
    </main>

  </body>
</html>