<?xml version="1.0"?>
<!-- name="generator" content="blosxom/2.0" -->
<!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">

<rss version="0.91">
  <channel>
    <title>Collin R. Mulliner   </title>
    <link>https://www.mulliner.org/blog/blosxom.cgi</link>
    <description>...stuff I do and things I like... </description>
    <language>en</language>

  <item>
 <title>Fluxboard (or how I learned to make PCBs)</title>
 <pubDate>Sun, 21 Feb 2021 18:00:00 GMT</pubDate>
 <link>https://www.mulliner.org/blog/blosxom.cgi/2021/02/21#fluxboard</link>
 <description>
First off, I'm a software person. I make my living with software.
Most of my embedded projects (personal or professional) are
software only projects and I sometimes get to solder 
an adapter cable and similar easy &lt;i&gt;electronics&lt;/i&gt; things.
&lt;br&gt;&lt;br&gt;
This blog post is a small recap on how I went about learning
to make Fluxboard. This should not be seen as a guide since
I'm in no way a professional electrical engineer.&lt;br&gt;&lt;br&gt;

&lt;b&gt;First steps&lt;/b&gt;
&lt;br&gt;&lt;br&gt;
I started out by trying to get my hands on as many ESP32 board
schematics as I could find to study them and compare them.
Since I started out with the Adafruit Huzzah32 I started looking 
at the Huzzah32 schematic first but there are really an
endless amount of schematics for ESP32 boards.
&lt;br&gt;&lt;br&gt;
The result was I had kind of an idea about what the required
circuits are. Specifically: USB Serial, power and battery charging,
the ESP32, and the RFM95 (LoRa radio).
I basically went and compared what all of the designs I looked at
did different. From my understanding it basically comes down to:
&lt;ul&gt;
&lt;li&gt;
USB serial converter IC (everybody uses a different one for some reason)
&lt;/li&gt;
&lt;li&gt;
battery charging (lots of boards without battery or no battery charging), many different charging ICs
&lt;/li&gt;
&lt;li&gt;
power (lots of different LDOs - those are tricky!)
&lt;/li&gt;
&lt;/ul&gt;

So overall it did not look to bad. Or at least thats what I thought.
&lt;br&gt;&lt;br&gt;
&lt;b&gt;EDA Software&lt;/b&gt;
&lt;br&gt;&lt;br&gt;
There are a number of Electronic Design Automation (EDA) tools available
for hobbyists. I've started with &lt;a href=&quot;https://www.autodesk.com/products/eagle/overview&quot;&gt;Eagle&lt;/a&gt;
but was not supper happy.
I was told to checkout &lt;a href=&quot;https://kicad.org&quot;&gt;KiCad&lt;/a&gt; since it is open source and used by a lot of hobbyists but
also ended up not liking it.
My issue with both tools was that I got super stuck once I went from circuit design
to PCB layout. The issue was the parts. I had no good way of knowing if specific parts are available
and also finding parts and footprints and so on. This really stressed me out and I spent weeks
to learn the software, download footprint libraries and so on.
I saw a tweet about &lt;a href=&quot;https://easyeda.com&quot;&gt;EasyEDA&lt;/a&gt; and checked it out since it sounded like a solution
to my components problem. It turned out it was.
&lt;br&gt;&lt;br&gt;
EasyEDA integrates with a components vendor and PCB manufacturer that also supports
Surface-mount technology (SMT). This means you can pick components that are actually available 
and supported (by the PCB manufacturer) right in the EDA tool.
&lt;br&gt;&lt;br&gt;

&lt;b&gt;EasyEDA&lt;/b&gt;
&lt;br&gt;&lt;br&gt;
Once I switched to EasyEDA I &lt;i&gt;just&lt;/i&gt; re-created the design I previously done in the other tools.
I basically looked at the printout and re-draw it by hand (compared to importing the design). 
This was pretty effective to learn EasyEDA.
Picking available components was much easier now but still hell for a newbie like me.
I spend weeks again looking at what is available and what I can use. It turns out their 
components search interface is pretty bad and can't easily show you all parts that are available to
you. Basically you have to go to &lt;a href=&quot;https://lcsc.com/&quot;&gt;LCSC&lt;/a&gt; search for the component to get its ID and
search in EasyEDA using the ID. Boom!
&lt;br&gt;&lt;br&gt;

&lt;b&gt;First Board&lt;/b&gt;
&lt;br&gt;&lt;br&gt;
My first board was actually design number three (0.3). I ordered it in
late September 2020. It arrived two weeks later.
The board generally worked but had a &lt;b&gt;number of issues&lt;/b&gt;.
Below a picture of the board. I had to hand solder the micro USB port,
the ESP32, the RFM95W, and the antenna connector. In this design I had through-holes
for spare GPIOs, UART 2, and the spare 3.3V pin. You can see the unsoldered through-holes
on the left of the ESP and the soldered UART 2 on the right side.
&lt;br&gt;&lt;br&gt;
&lt;img src=&quot;/images/03_top.JPEG&quot; width=&quot;80%&quot;&gt;
&lt;br&gt;&lt;br&gt;
Let's talk about issues!
&lt;br&gt;&lt;br&gt;
The main issue is very clearly visible in the picture.
I forgot the pull-up resistors for the ESP32. This probably happened since I was
hyper focused on all the other things that I just forgot to add the pull-ups. 
Without the pull-ups the ESP32 does not even start. &lt;b&gt;*YAY*&lt;/b&gt;.
Once I realized what I (didn't) do I added the pull-ups. Lucky me that I added
the spare 3.3V pad in a location that is easy to reach. (Yes, there are lots of
places to get 3.3V from but I was happy about the pad.) With that fix the board
actually fully worked. Well Kinda.
I also thought I had to add the capacitor, turns out that you don't 
(this was me still not fully understanding things).
&lt;br&gt;&lt;br&gt;
The LDO was the next issue. I tried to get components with a low 
&lt;a href=&quot;https://www.maximintegrated.com/en/glossary/definitions.mvp/term/Quiescent/gpk/1009&quot;&gt;quiescent current&lt;/a&gt;.
I picked a HT73xx LDO with only 4uA but turns out 250mA are not enough if you
decide to use Wifi on the ESP32. This resulted in consistent brown outs.
&lt;br&gt;&lt;br&gt;
Conclusions from the first board.
&lt;br&gt;&lt;br&gt;
Overall this wasn't as bad as I thought it was gonna be. Yes, I spent many month
to get to the point where I actually had a board with my name on it into my hands.
The boards (I got 5 PCBs - the minimum oder quantity) actually worked after I added
the pull-ups. I found out that not all of the boards could detect the
external 32khz crystal. I determined this by writing a board test program. In the end
I was extremely happy. I basically had designed some electronics 
and now I was holding it in my hands and it worked!
&lt;br&gt;&lt;br&gt;
&lt;b&gt;Second Board&lt;/b&gt;
&lt;br&gt;&lt;br&gt;
Designing the second version (v0.4) was much easier since I most of the
first board worked. I basically just added the missing pull-ups. Replaced 
the LDO with one that can deliver 500mA. Once that was done I looked into
some more fun changes. I started with replacing one of the green LEDs with
a red LED. I also added USB (power) detection via a voltage divider.
I removed all through-hole connectors (but the battery connector) 
and replaced them with pads.
At the end I also replaced most resistors and capacitors with smaller
&lt;a href=&quot;https://www.topline.tv/sizechart.html&quot;&gt;footprint&lt;/a&gt; versions (I went from 1206 to 0805).
This allowed me to make the board a little smaller.
&lt;br&gt;&lt;br&gt;
Below a picture of the v0.4 board as I received it from JLCPCB. You can see all of the components
they soldered with just the USB connector, ESP32, RFM95, and antenna connector missing. JLCPCB
just does not support those components in their prototyping SMT service.
&lt;br&gt;&lt;br&gt;
&lt;img src=&quot;/images/04_top.JPEG&quot; width=&quot;80%&quot;&gt;
&lt;br&gt;&lt;br&gt;
Once I got all the components soldered the board worked as expected. I did most of the soldering
for the v0.4 boards using reflow soldering with a hot air gun. I gained some experience
with the hot air gun while soldering and re-working some of the v0.3 boards. I broke the very first
v0.4 board because I didn't check the soldering on the USB connector. I had a short with
the 5V and fried the USB serial IC. Four boards left.
&lt;br&gt;&lt;br&gt;
Lets talk about the final design.&lt;br&gt;&lt;br&gt;
One of my original goals was to make a board that is capable of low power standby and sleep.
The &lt;a href=&quot;https://lastminuteengineers.com/esp32-sleep-modes-power-consumption/&quot;&gt;ESP32 has multiple sleep modes&lt;/a&gt;
that help to decrease energy consumption and thus increase runtime on battery. 
Low power consumption is so much more besides the ESP sleep modes.
From my understanding overall this requires a number of design choices. Things such
as picking components with low quiescent current. Being able to completely turn off components
that are not needed, e.g. the USB serial converter. In this design the USB serial IC is powered by 
USB VBus, this means if USB is not connected the IC is not active. It is not connected to the battery.
This makes sense since you only need serial when connected to USB. At least for this specific board.
The battery measurement circuit is another one that can lead to unwanted battery drainage.
I found this &lt;a href=&quot;https://en.ovcharov.me/2020/02/29/how-to-measure-battery-level-with-esp32-microcontroller/&quot;&gt;battery measurement&lt;/a&gt;
circuit as an example of how you can measure battery voltage without draining the battery too much.
&lt;br&gt;&lt;br&gt;
For the RFM95W (LoRa modem) it is important to connect the DIO PINs as they are used as IRQs.
Using IRQ instead of polling allows us to put the ESP into sleep and have the LoRa modem wake it up.
&lt;br&gt;&lt;br&gt;
The &lt;a href=&quot;https://github.com/crmulliner/fluxnode/blob/main/docs/fluxboard_0.4.pdf&quot;&gt;schematic for Fluxboard v0.4&lt;/a&gt; 
shows all of the circuits I mentioned. The 32khz crystal is required to if you want to use ESP32's dynamic power
saving mode while using BLE.
&lt;br&gt;&lt;br&gt;
Of course the second board is not flawless. The red and green LED are very different in their 
brightness. Apparently that is normal (I didn't know). I foolishly tried to design the board to always
require a battery to be connected since VBus only inputs into the USB serial IC and the battery
charging IC. In a new revision I would try to avoid that and be able to power the entire device via USB 
(in addition to a battery).
&lt;br&gt;&lt;br&gt;
&lt;b&gt;Conclusions&lt;/b&gt;
&lt;br&gt;&lt;br&gt;
I really learned a lot going thru the exercise of design a board, 
making a revision, and having them produced. 
Working on the revision was much easier todo and much more fun.
Below you can look at both board side by side, you can clearly see the progress
from v0.3 - v0.4.&lt;br&gt;&lt;br&gt;
&lt;img src=&quot;/images/0304_top.JPEG&quot; width=&quot;80%&quot;&gt;
&lt;br&gt;&lt;br&gt;
&lt;img src=&quot;/images/0304_bottom.JPEG&quot; width=&quot;80%&quot;&gt;
&lt;br&gt;&lt;br&gt;
Also one thing to be very clear about. I basically ONLY learned how to make
a custom ESP32 board. I don't think I could easily make something completely different
without spending a similar amount of time on it. The progress of this projects
was definitely driven by using a popular SoC that many people before me used for their
own projects. To some degree it felt like software development that mainly uses stackoverflow
answers to questions other people asked before you. Instead of software you build circuits. 
Like: &lt;i&gt;how do I measure the battery voltage without draining the battery?&lt;/i&gt;
&lt;br&gt;&lt;br&gt;
Many thanks to &lt;a href=&quot;https://twitter.com/idanwarsawski&quot;&gt;Idan Warsawski&lt;/a&gt; for
giving me tips and directions for learning PCB design and providing feedback on my schematics.
&lt;br&gt;&lt;br&gt;</description>
 </item>
  <item>
 <title>Introducing FluxN0de</title>
 <pubDate>Thu, 11 Feb 2021 02:22:00 GMT</pubDate>
 <link>https://www.mulliner.org/blog/blosxom.cgi/2021/02/11#fluxnode_initial</link>
 <description>
Today I'm releasing &lt;a href=&quot;https://github.com/crmulliner/fluxnode&quot;&gt;FluxN0de&lt;/a&gt; a 
personal project I have been working on for about 1 year (nights and weekends).
The project ended up being quite a bit different compared to when I started it. 
&lt;br&gt;&lt;br&gt;
What is FluxN0de?
&lt;br&gt;&lt;br&gt;
FluxN0de is a platform (for me) to play with &lt;a href=&quot;https://en.wikipedia.org/wiki/LoRa&quot;&gt;LoRa&lt;/a&gt;
and &lt;a href=&quot;https://lora-alliance.org/about-lorawan/&quot;&gt;LoRaWAN&lt;/a&gt;. Originally I bought a &lt;i&gt;Adafruit Feather M0 with RFM95 
LoRa Radio - 900MHz - RadioFruit&lt;/i&gt; in mid 2019 but had little joy with it and almost stopped caring. In late 2019/very early 2020
I gave it another try and bought a ESP32-based Huzzah32 board also from Adafruit and wired it up to a LoRa Feather. Using that
combination I played with the various LoRa and LoRaWAN libraries that are available for the ESP32 platform.
&lt;br&gt;&lt;br&gt;
When NYC was shutdown in March 2020 I suddenly had a lot of time on my hands.
&lt;br&gt;&lt;br&gt;
Using the Huzzah+LoRa combination (see picture below) I basically tried to learn everything about ESP32 development,
LoRa, and LoRaWAN. I ended up building a massive web application written in C that runs on the ESP32. This included
things like JSON marshaling (where I ended up writing a code generator in go that emits C code). In recent years
I hadn't had much exposure to low level development dealing with GPIOs, SPI, and so on, so that was a good refresher.
Learning a little more about FreeRTOS and LWIP was also fun.
I never really wrote any web apps so learning JavaScript and websockets was good.
&lt;br&gt;
&lt;img width=&quot;30%&quot; src=&quot;/images/huzzah1.jpeg&quot;&gt;
&lt;br&gt;&lt;br&gt;
After several month I was quite happy with my software but got frustrated with the Huzzah board. So my plan developed 
towards building my own board to &lt;i&gt;fix&lt;/i&gt; all the issues I saw with the Huzzah board and by issues I mostly mean
adding some features. Basically I had more time on my hands than I knew what to do with. For the next couple of month
I tired to learn everything that would allow me to understand and finally build my own ESP32-based board that had
a LoRa radio on the same PCB. It was quite a journey but I ended up with a working (and decent looking) &lt;i&gt;Fluxboard&lt;/i&gt;.
&lt;br&gt;
&lt;img width=&quot;50%&quot; src=&quot;/images/fluxboard1.jpeg&quot;&gt;
&lt;br&gt;&lt;br&gt;
So now that I have nice(r) hardware I looked more closely at my software. I grew a bit frustrated with the slow progress
I made due to having to write everything in C and (of course) always had to flash and debug stupid mistakes I made.
Having recently learned JavaScript (to write the web app for the early software stack) I thought it would be worth
investigating various JavaScript engines and if I could integrate one of those into my software. Turns out 
&lt;a href=&quot;https://duktape.org/&quot;&gt;Duktape&lt;/a&gt; works great on the ESP32. I ended up re-architecturing my entire project
around running JavaScript applications.
&lt;br&gt;&lt;br&gt;
So what is FluxN0de?
&lt;br&gt;&lt;br&gt;
FluxN0de is a platform that executes applications written in JavaScript.
The &lt;a href=&quot;https://github.com/crmulliner/fluxnode/blob/main/docs/platform.md&quot;&gt;platform&lt;/a&gt;
exposes APIs to control the hardware itself and to interact with the LoRa modem.
The software stack hides a lot of complexity in regards to LoRa, Wifi, WebSockets, and BLE while still providing
lots of control over (relevant) settings. The end result allows you to build applications and deploy them 
via a &lt;a href=&quot;https://github.com/crmulliner/fluxnode/blob/main/docs/webservice.md&quot;&gt;HTTP API&lt;/a&gt;
without need to flash the board. I ended up writing a 
&lt;a href=&quot;https://github.com/crmulliner/fluxnode/blob/main/docs/lorawanlib.md&quot;&gt;LoRaWAN library in JavaScript&lt;/a&gt;
that provides lots of flexibility while still being easy to use.
&lt;br&gt;&lt;br&gt;
&lt;p&gt;
&lt;i&gt;
The very original idea was
to build a LoRa based messaging device that is connected to your smartphone via BLE. I had the idea
when I saw some article about building a full-on LoRa pager with keyboard and display. I thought that was silly
since your smartphone can do both of those functions a million times better. That is the main reason why
my setup supports BLE and is designed to run on battery.
&lt;/i&gt;
&lt;/p&gt;
&lt;br&gt;
&lt;br&gt;
In summary: The whole project was a fantastic learning experience. Especially going thru multiple iterations
of the software stack paired with different hardware configurations. I have planned to write a number of follow up posts about
various parts of this project. This will likely include my experience of learning how to design Fluxboard. How I went
about it and what tools I used. Spoiler I ended up using &lt;a href=&quot;https://easyeda.com/&quot;&gt;EasyEDA&lt;/a&gt; for the design 
and JLCPCB for the manufacturing. I also built a basic setup to measure the power/battery consumption of my boards.
One of the most fun things is seeing how your software design impacts battery runtime, I will definitely write a
blog post about that. I will probably start with a short post on how to develop apps for the FluxN0de environment.
&lt;br&gt;&lt;br&gt;
Checkout the GitHub page for detailed documentation, examples, build instructions, and more.&lt;br&gt;&lt;br&gt;
GitHub: &lt;a href=&quot;https://github.com/crmulliner/fluxnode&quot;&gt;github.com/crmulliner/fluxnode&lt;/a&gt;
&lt;br&gt;</description>
 </item>
  </channel>
</rss>