Update documentation

debiatan · Nov 25, 2014 · 1d9ee3a · 1d9ee3a
1 parent e5455d6
commit 1d9ee3a
Show file tree

Hide file tree

Showing 18 changed files with 312 additions and 42 deletions.
diff --git a/archives.html b/archives.html
@@ -49,22 +49,27 @@ <h1><a href="http://blog.debiatan.net/archives.html">Posts</a></h1>
 <div class="row-fluid">
     <div class="span10 offset2">
         <div class="blog-archives">
+            <h2 id="2015"><a href="#2015">2015</a></h2>
+            <article class="last-entry-of-year">
+            <a href="http://blog.debiatan.net/oscilloscope.html">Oscilloscope  <small> Who needs yet another Arduino oscilloscope? </small>  </a>
+            <time pubdate="pubdate" datetime="2015-11-25T18:00:00+01:00">Wed 25 November 2015</time>
+            </article>
             <h2 id="2014"><a href="#2014">2014</a></h2>
             <article>
             <a href="http://blog.debiatan.net/guybrush.html">Distortion Vector Field  <small> Guybrush materializes </small>  </a>
-            <time pubdate="pubdate" datetime="2014-08-25T08:00:00">Mon 25 August 2014</time>
+            <time pubdate="pubdate" datetime="2014-08-25T08:00:00+02:00">Mon 25 August 2014</time>
             </article>
             <article>
             <a href="http://blog.debiatan.net/utbp.html">Unit-Test-Based Programming  <small> SIGBOVIK 2014 </small>  </a>
-            <time pubdate="pubdate" datetime="2014-04-01T10:00:00">Tue 01 April 2014</time>
+            <time pubdate="pubdate" datetime="2014-04-01T10:00:00+02:00">Tue 01 April 2014</time>
             </article>
             <article>
             <a href="http://blog.debiatan.net/gradius-meets-twister.html">Gradius meets Twister  <small> Global Game Jam 2014 </small>  </a>
-            <time pubdate="pubdate" datetime="2014-01-27T20:00:00">Mon 27 January 2014</time>
+            <time pubdate="pubdate" datetime="2014-01-27T20:00:00+01:00">Mon 27 January 2014</time>
             </article>
             <article class="last-entry-of-year">
             <a href="http://blog.debiatan.net/xrobot.html">xrobot  <small> Python X11 event automation library </small>  </a>
-            <time pubdate="pubdate" datetime="2014-01-02T10:00:00">Thu 02 January 2014</time>
+            <time pubdate="pubdate" datetime="2014-01-02T10:00:00+01:00">Thu 02 January 2014</time>
             </article>
         </div>
     </div>

diff --git a/categories.html b/categories.html
@@ -64,7 +64,7 @@ <h1><a href="http://blog.debiatan.net/categories.html">Categories</a></h1>
                     <div class="accordion-inner">
                         <ul class="list-articles-category">
 
-                            <li><span><time pubdate="pubdate" datetime="2014-01-27T20:00:00">Mon 27 January 2014</time></span> <a href="http://blog.debiatan.net/gradius-meets-twister.html">Gradius meets Twister  <small> Global Game Jam 2014 </small>  </a></li>
+                            <li><span><time pubdate="pubdate" datetime="2014-01-27T20:00:00+01:00">Mon 27 January 2014</time></span> <a href="http://blog.debiatan.net/gradius-meets-twister.html">Gradius meets Twister  <small> Global Game Jam 2014 </small>  </a></li>
                         </ul>
                     </div>
                 </div>
@@ -79,24 +79,26 @@ <h1><a href="http://blog.debiatan.net/categories.html">Categories</a></h1>
                     <div class="accordion-inner">
                         <ul class="list-articles-category">
 
-                            <li><span><time pubdate="pubdate" datetime="2014-08-25T08:00:00">Mon 25 August 2014</time></span> <a href="http://blog.debiatan.net/guybrush.html">Distortion Vector Field  <small> Guybrush materializes </small>  </a></li>
+                            <li><span><time pubdate="pubdate" datetime="2014-08-25T08:00:00+02:00">Mon 25 August 2014</time></span> <a href="http://blog.debiatan.net/guybrush.html">Distortion Vector Field  <small> Guybrush materializes </small>  </a></li>
                         </ul>
                     </div>
                 </div>
             </div>
             <div class="accordion-group">
                 <div class="accordion-heading">
                     <a class="accordion-toggle list-of-categories" data-toggle="collapse" data-parent="#accordion2" href="#tools-ref">
-                        tools<span>2</span>
+                        tools<span>3</span>
                     </a>
                 </div>
                 <div id="tools-ref" class="accordion-body collapse">
                     <div class="accordion-inner">
                         <ul class="list-articles-category">
 
-                            <li><span><time pubdate="pubdate" datetime="2014-04-01T10:00:00">Tue 01 April 2014</time></span> <a href="http://blog.debiatan.net/utbp.html">Unit-Test-Based Programming  <small> SIGBOVIK 2014 </small>  </a></li>
+                            <li><span><time pubdate="pubdate" datetime="2015-11-25T18:00:00+01:00">Wed 25 November 2015</time></span> <a href="http://blog.debiatan.net/oscilloscope.html">Oscilloscope  <small> Who needs yet another Arduino oscilloscope? </small>  </a></li>
 
-                            <li><span><time pubdate="pubdate" datetime="2014-01-02T10:00:00">Thu 02 January 2014</time></span> <a href="http://blog.debiatan.net/xrobot.html">xrobot  <small> Python X11 event automation library </small>  </a></li>
+                            <li><span><time pubdate="pubdate" datetime="2014-04-01T10:00:00+02:00">Tue 01 April 2014</time></span> <a href="http://blog.debiatan.net/utbp.html">Unit-Test-Based Programming  <small> SIGBOVIK 2014 </small>  </a></li>
+
+                            <li><span><time pubdate="pubdate" datetime="2014-01-02T10:00:00+01:00">Thu 02 January 2014</time></span> <a href="http://blog.debiatan.net/xrobot.html">xrobot  <small> Python X11 event automation library </small>  </a></li>
                         </ul>
                     </div>
                 </div>

diff --git a/feeds/all.atom.xml b/feeds/all.atom.xml
@@ -1,5 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom"><title>Transition Dreams</title><link href="http://blog.debiatan.net/" rel="alternate"></link><link href="http://blog.debiatan.net/feeds/all.atom.xml" rel="self"></link><id>http://blog.debiatan.net/</id><updated>2014-08-25T08:00:00+02:00</updated><entry><title>Distortion Vector Field</title><link href="http://blog.debiatan.net/guybrush.html" rel="alternate"></link><updated>2014-08-25T08:00:00+02:00</updated><author><name>Miguel Lechón</name></author><id>tag:blog.debiatan.net,2014-08-25:guybrush.html</id><summary type="html">&lt;p&gt;Just to keep the blog rolling, I'm posting this ten-second clip of Guybrush Threepwood coming into existence from some sort of primordial soup of pixels.&lt;/p&gt;
+<feed xmlns="http://www.w3.org/2005/Atom"><title>Transition Dreams</title><link href="http://blog.debiatan.net/" rel="alternate"></link><link href="http://blog.debiatan.net/feeds/all.atom.xml" rel="self"></link><id>http://blog.debiatan.net/</id><updated>2015-11-25T18:00:00+01:00</updated><entry><title>Oscilloscope</title><link href="http://blog.debiatan.net/oscilloscope.html" rel="alternate"></link><updated>2015-11-25T18:00:00+01:00</updated><author><name>Miguel Lechón</name></author><id>tag:blog.debiatan.net,2015-11-25:oscilloscope.html</id><summary type="html">&lt;p&gt;It seems that building an oscilloscope on top of an Arduino board is some sort of rite of passage. Do a &lt;a class="reference external" href="https://duckduckgo.com/?q=arduino+oscilloscope"&gt;duckduckgo&lt;/a&gt; search and you will see that all the good names for this kind of project are already taken, so I have decided to name mine just &lt;em&gt;oscilloscope&lt;/em&gt;. In my defense, I'll say that I have written mine because I needed the most basic of oscilloscopes and it's just easier to build one from scratch than to adapt some already existing code.&lt;/p&gt;
+&lt;p&gt;I've written my oscilloscope code it in order to inspect a single-channel periodic signal with a frequency close to 250 Hz. My first trivial attempt at the task already recorded the signal at 5 kHz and transmitted it over USB without the need to buffer data in the RAM of the microcontroller, so I haven't bothered speeding it up.&lt;/p&gt;
+&lt;p&gt;The main bottleneck in my case is the serial transmission. Trying to collect more than 5800 samples per second will likely result in the loss of some of them. I've written some extra code that checks for missing samples, but it never detects problems at 5 kHz and, frankly, I'm OK with twenty samples per cycle.&lt;/p&gt;
+&lt;p&gt;All in all, putting together the &lt;tt class="docutils literal"&gt;C&lt;/tt&gt; firmware and the &lt;tt class="docutils literal"&gt;Python&lt;/tt&gt; client, the project takes less than 130 lines. The program that checks for periodicity, finds the frequency and aligns the cycles to display them adds 90 extra lines. The output of this program looks like this:&lt;/p&gt;
+&lt;div class="figure align-center"&gt;
+&lt;img alt="Jiggling periodic wave" src="images/oscilloscope.gif" style="width: 406.0px; height: 306.0px;" /&gt;
+&lt;p class="caption"&gt;Visualization of several cycles of a PWM signal at 250 Hz after going through a simple RC circuit.&lt;/p&gt;
+&lt;/div&gt;
+&lt;p&gt;Here's the &lt;a class="reference external" href="https://github.com/debiatan/oscilloscope"&gt;link to the github repository&lt;/a&gt;.&lt;/p&gt;
+</summary><category term="arduino"></category><category term="oscilloscope"></category></entry><entry><title>Distortion Vector Field</title><link href="http://blog.debiatan.net/guybrush.html" rel="alternate"></link><updated>2014-08-25T08:00:00+02:00</updated><author><name>Miguel Lechón</name></author><id>tag:blog.debiatan.net,2014-08-25:guybrush.html</id><summary type="html">&lt;p&gt;Just to keep the blog rolling, I'm posting this ten-second clip of Guybrush Threepwood coming into existence from some sort of primordial soup of pixels.&lt;/p&gt;
 &lt;div class="flex-video widescreen" style="margin: 0 auto;text-align:center;"&gt;
 &lt;iframe src="//player.vimeo.com/video/104247325" frameborder="0" title="Guybrush materializes" webkitallowfullscreen mozallowfullscreen allowfullscreen&gt;&lt;/iframe&gt;
 &lt;/div&gt;

diff --git a/feeds/miguel-lechon.atom.xml b/feeds/miguel-lechon.atom.xml
@@ -1,5 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom"><title>Transition Dreams</title><link href="http://blog.debiatan.net/" rel="alternate"></link><link href="http://blog.debiatan.net/feeds/miguel-lechon.atom.xml" rel="self"></link><id>http://blog.debiatan.net/</id><updated>2014-08-25T08:00:00+02:00</updated><entry><title>Distortion Vector Field</title><link href="http://blog.debiatan.net/guybrush.html" rel="alternate"></link><updated>2014-08-25T08:00:00+02:00</updated><author><name>Miguel Lechón</name></author><id>tag:blog.debiatan.net,2014-08-25:guybrush.html</id><summary type="html">&lt;p&gt;Just to keep the blog rolling, I'm posting this ten-second clip of Guybrush Threepwood coming into existence from some sort of primordial soup of pixels.&lt;/p&gt;
+<feed xmlns="http://www.w3.org/2005/Atom"><title>Transition Dreams</title><link href="http://blog.debiatan.net/" rel="alternate"></link><link href="http://blog.debiatan.net/feeds/miguel-lechon.atom.xml" rel="self"></link><id>http://blog.debiatan.net/</id><updated>2015-11-25T18:00:00+01:00</updated><entry><title>Oscilloscope</title><link href="http://blog.debiatan.net/oscilloscope.html" rel="alternate"></link><updated>2015-11-25T18:00:00+01:00</updated><author><name>Miguel Lechón</name></author><id>tag:blog.debiatan.net,2015-11-25:oscilloscope.html</id><summary type="html">&lt;p&gt;It seems that building an oscilloscope on top of an Arduino board is some sort of rite of passage. Do a &lt;a class="reference external" href="https://duckduckgo.com/?q=arduino+oscilloscope"&gt;duckduckgo&lt;/a&gt; search and you will see that all the good names for this kind of project are already taken, so I have decided to name mine just &lt;em&gt;oscilloscope&lt;/em&gt;. In my defense, I'll say that I have written mine because I needed the most basic of oscilloscopes and it's just easier to build one from scratch than to adapt some already existing code.&lt;/p&gt;
+&lt;p&gt;I've written my oscilloscope code it in order to inspect a single-channel periodic signal with a frequency close to 250 Hz. My first trivial attempt at the task already recorded the signal at 5 kHz and transmitted it over USB without the need to buffer data in the RAM of the microcontroller, so I haven't bothered speeding it up.&lt;/p&gt;
+&lt;p&gt;The main bottleneck in my case is the serial transmission. Trying to collect more than 5800 samples per second will likely result in the loss of some of them. I've written some extra code that checks for missing samples, but it never detects problems at 5 kHz and, frankly, I'm OK with twenty samples per cycle.&lt;/p&gt;
+&lt;p&gt;All in all, putting together the &lt;tt class="docutils literal"&gt;C&lt;/tt&gt; firmware and the &lt;tt class="docutils literal"&gt;Python&lt;/tt&gt; client, the project takes less than 130 lines. The program that checks for periodicity, finds the frequency and aligns the cycles to display them adds 90 extra lines. The output of this program looks like this:&lt;/p&gt;
+&lt;div class="figure align-center"&gt;
+&lt;img alt="Jiggling periodic wave" src="images/oscilloscope.gif" style="width: 406.0px; height: 306.0px;" /&gt;
+&lt;p class="caption"&gt;Visualization of several cycles of a PWM signal at 250 Hz after going through a simple RC circuit.&lt;/p&gt;
+&lt;/div&gt;
+&lt;p&gt;Here's the &lt;a class="reference external" href="https://github.com/debiatan/oscilloscope"&gt;link to the github repository&lt;/a&gt;.&lt;/p&gt;
+</summary><category term="arduino"></category><category term="oscilloscope"></category></entry><entry><title>Distortion Vector Field</title><link href="http://blog.debiatan.net/guybrush.html" rel="alternate"></link><updated>2014-08-25T08:00:00+02:00</updated><author><name>Miguel Lechón</name></author><id>tag:blog.debiatan.net,2014-08-25:guybrush.html</id><summary type="html">&lt;p&gt;Just to keep the blog rolling, I'm posting this ten-second clip of Guybrush Threepwood coming into existence from some sort of primordial soup of pixels.&lt;/p&gt;
 &lt;div class="flex-video widescreen" style="margin: 0 auto;text-align:center;"&gt;
 &lt;iframe src="//player.vimeo.com/video/104247325" frameborder="0" title="Guybrush materializes" webkitallowfullscreen mozallowfullscreen allowfullscreen&gt;&lt;/iframe&gt;
 &lt;/div&gt;

diff --git a/feeds/miguel-lechon.rss.xml b/feeds/miguel-lechon.rss.xml
@@ -1,5 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Transition Dreams</title><link>http://blog.debiatan.net/</link><description></description><atom:link href="http://blog.debiatan.net/feeds/miguel-lechon.rss.xml" rel="self"></atom:link><lastBuildDate>Mon, 25 Aug 2014 08:00:00 +0200</lastBuildDate><item><title>Distortion Vector Field</title><link>http://blog.debiatan.net/guybrush.html</link><description>&lt;p&gt;Just to keep the blog rolling, I'm posting this ten-second clip of Guybrush Threepwood coming into existence from some sort of primordial soup of pixels.&lt;/p&gt;
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Transition Dreams</title><link>http://blog.debiatan.net/</link><description></description><atom:link href="http://blog.debiatan.net/feeds/miguel-lechon.rss.xml" rel="self"></atom:link><lastBuildDate>Wed, 25 Nov 2015 18:00:00 +0100</lastBuildDate><item><title>Oscilloscope</title><link>http://blog.debiatan.net/oscilloscope.html</link><description>&lt;p&gt;It seems that building an oscilloscope on top of an Arduino board is some sort of rite of passage. Do a &lt;a class="reference external" href="https://duckduckgo.com/?q=arduino+oscilloscope"&gt;duckduckgo&lt;/a&gt; search and you will see that all the good names for this kind of project are already taken, so I have decided to name mine just &lt;em&gt;oscilloscope&lt;/em&gt;. In my defense, I'll say that I have written mine because I needed the most basic of oscilloscopes and it's just easier to build one from scratch than to adapt some already existing code.&lt;/p&gt;
+&lt;p&gt;I've written my oscilloscope code it in order to inspect a single-channel periodic signal with a frequency close to 250 Hz. My first trivial attempt at the task already recorded the signal at 5 kHz and transmitted it over USB without the need to buffer data in the RAM of the microcontroller, so I haven't bothered speeding it up.&lt;/p&gt;
+&lt;p&gt;The main bottleneck in my case is the serial transmission. Trying to collect more than 5800 samples per second will likely result in the loss of some of them. I've written some extra code that checks for missing samples, but it never detects problems at 5 kHz and, frankly, I'm OK with twenty samples per cycle.&lt;/p&gt;
+&lt;p&gt;All in all, putting together the &lt;tt class="docutils literal"&gt;C&lt;/tt&gt; firmware and the &lt;tt class="docutils literal"&gt;Python&lt;/tt&gt; client, the project takes less than 130 lines. The program that checks for periodicity, finds the frequency and aligns the cycles to display them adds 90 extra lines. The output of this program looks like this:&lt;/p&gt;
+&lt;div class="figure align-center"&gt;
+&lt;img alt="Jiggling periodic wave" src="images/oscilloscope.gif" style="width: 406.0px; height: 306.0px;" /&gt;
+&lt;p class="caption"&gt;Visualization of several cycles of a PWM signal at 250 Hz after going through a simple RC circuit.&lt;/p&gt;
+&lt;/div&gt;
+&lt;p&gt;Here's the &lt;a class="reference external" href="https://github.com/debiatan/oscilloscope"&gt;link to the github repository&lt;/a&gt;.&lt;/p&gt;
+</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Miguel Lechón</dc:creator><pubDate>Wed, 25 Nov 2015 18:00:00 +0100</pubDate><guid>tag:blog.debiatan.net,2015-11-25:oscilloscope.html</guid><category>arduino</category><category>oscilloscope</category></item><item><title>Distortion Vector Field</title><link>http://blog.debiatan.net/guybrush.html</link><description>&lt;p&gt;Just to keep the blog rolling, I'm posting this ten-second clip of Guybrush Threepwood coming into existence from some sort of primordial soup of pixels.&lt;/p&gt;
 &lt;div class="flex-video widescreen" style="margin: 0 auto;text-align:center;"&gt;
 &lt;iframe src="//player.vimeo.com/video/104247325" frameborder="0" title="Guybrush materializes" webkitallowfullscreen mozallowfullscreen allowfullscreen&gt;&lt;/iframe&gt;
 &lt;/div&gt;