Jon Thomasson's Build Log


That board (and that render!) look fantastic!

Is that a custom shield/can on top?

Also I assume from the part number you’re jumping into the LoRa world!


Thanks Chris! The shield is an off the shelf variety from Wurth Electronics. It has two parts, the frame and the cover. One feature I liked about this shield is that the outer cover can be removed if necessary to gain access to the RF components underneath. It was also one of the only shields I could find with decent documentation and test results matching the frequency and power rating of my transceiver.

Although this transceiver is made by Semtech who produces the LoRa transceivers, I opted to not use a LoRa transceiver for this project. One of the main reasons for this was I wanted a transceiver with a higher data rate for possibly sending digital voice or video. If this works out though, I have a few project ideas for where I could use LoRa in the future.

If anyone is interested, here is a link to the github repo for this project.


Very cool! I’ve never designed in a shield before, though i’m sure some of my designs could have benefitted from one :smiley:

It’s like making a quiet little room for your sensitive electronics!


Is the 3D render from KiCad? If so, how did you model the shield?


Yep, the 3D render is all done in Kicad. A lot of times the distributor will have CAD files that go along with the component. For example on Digikey they had the .step file available from the shield page where I could just click on it and download it.

You can also use the parametric search on Digikey to search for components that have CAD or EDA models. Sometimes if I have 2 components that have all the same specs/price, but one has access to the 3D model, I’ll choose the one with the model so I can use it in the PCB.
enter image description here

If the distributor doesn’t have them, a lot of times the product manufacturer will have something available on their website. Or you can also download models from online repositories like or

Once you have the model file, you can attach it to a footprint in Kicad by opening up the Footprint Editor for the component and navigate to Edit-> Edit Properties. Then click Add 3D Shape in the 3D Settings tab to add the model you downloaded.

You may need to adjust some of the rotation/offset parameters to get the model to line up on your footprint. Then to view the model on the finished pcb, in pcbnew you would go to View->3D Viewer (or Alt+3). By default the viewer is set to render with OpenGL, but to get the really sharp, detailed renders I use Raytracing. To set Raytracing go to Preferences->Render Engine and select Raytracing.


Cool, thanks! I didn’t realize that sort of model was available through digikey.


Trace Parts Online also has a lot of parts. Not sure how many electrical parts they would have, but they do have a lot of connectors/plates/etc.

Digikey is certainly adding more, which is a great idea. Used them while I was doing a simple rebuild/redesign of a board for a customer and it was nice to check the connector fit to a front panel with step exports :slight_smile:


I was able to make a little bit of progress on the SX1238 rf transceiver module recently. I have to admit that I was nervous just thinking about hand soldering these boards, given the close proximity of several small 0402 components and the large ground pad under the transceiver chip. For this reason I thought it would be a good time to try out a solder paste stencil. After seeing how well @Steve_Mayze’s boost regulator project turned out I decided to give oshstencils a test run.

Since I hadn’t done a stencil before, there was a bit of a learning curve. I found some resources that helped me get started. The first was this page from rheingold heavy which introduced some of the parameters needed, such as the solder paste clearance, to get the gerber files ready to send to oshstencil. The second resource was from this forum post by @ChrisGammell on the forums. Specifically this picture helped me visualize how the pad mask parameters in Kicad worked :slight_smile: :
enter image description here

The first step for me was to determine which pads on the PCB required a stencil. At first I was thinking about just including all the SMD components. But after giving it some more thought I opted to leave out the SMA connector and shield, since I wanted to be able to test the circuit out first before sealing it in its metal house. And the SMA connector would require some hand soldering to get a good connection.

Now that I knew which SMD pads I wanted to exclude from the stencil, I took those pads out of the stencil by unchecking the F. Paste layer (the front solder paste layer) from the Technical Layers area of the Footprint Editor. This disassociates the pad from the front solder paste layer. It looks like F. Paste is checked by default whenever you create a new SMD pad.

The next thing I learned was that there should be a little bit of clearance between the solder paste and the edge of the pad. This clearance is aptly named “Solder Paste Clearance” and is illustrated on the picture above. This property can be adjusted on a per pad level on the pad properties page, or on a global level. To set the clearance for the entire PCB you navigate to Dimensions -> Pads Mask Clearance from the Pcbnew screen.


On the Pads Mask Clearance screen, there are 2 options for adjusting the solder paste clearance. You can either choose to set the clearance a fixed amount from the edge of the pad, or you can set the clearance to be a ratio based on the size of the pad. I chose to give the clearance a ratio of -5%. After adjusting these properties, the only thing left to do was to generate the gerber files which will be sent to oshstencils. When you go to generate the gerbers, you only need to select the solder paste layer as well as the edge cuts layer, since those are the layers that oshstencils care about.

I was surprised at how quickly I received the stencil back. It seemed like it only took 2-3 days from the time of order to having the stencil in my hand! Besides the stencil, I also ordered a little jig to hold the stencil in position while applying the paste. I found out you can also just use unpopulated PCB’s to fashion your own jig. Here’s a pic of what I came up with:

Once the jig and PCB are in place, you lay the stencil over the PCB until all the pads match up and are visible through the appropriate cutouts of the stencil. Then you tape the stencil down on one side.

From here, my pictures were a little too blurry to share, but I basically followed the same procedure for applying the paste presented in this Sparkfun video. The important thing I learned from all of this was to make sure to clean up the solder paste from the stencil and anything else you want to keep right away. Otherwise it really gets tough to clean up, and it manages to get everywhere!

To reflow the solder paste after I had placed the components I simply used a hot air rework gun. I did have some solder bridges around one of the transceiver chips, but nothing a little drag soldering couldn’t fix. Here’s the finished boards (with a quarter for size reference):

Edit: I noticed that the image for this post went missing. So I uploaded it again.


Just as a fun little aside, I was completely fascinated by the tiny 0402 sized inductors for the RF transceiver. If you look close enough on the board you can kinda see little windings of copper wire. So I thought it would be fun to borrow my daughters microscope and get a closer look at one.

This is blown up about 40x magnification. This one obviously isn’t connected to the board. It’s on its side in this picture. You can see the copper wire bonded to the pads on either end. And some kind of translucent blue goop covering the top. I don’t know, I just thought it was cool. :slight_smile:

Edit: I noticed that the image for this post went missing. So I uploaded it again.


The RF transceiver boards passed the initial magic smoke test. I brought the boards up with a current controlled power supply and to my surprise no magic smoke escaped! After that I wired up the SPI bus to an 3.3v Arduino pro mini to see if I could communicate with the transceiver.

I wrote a simple sketch that reads/writes to various registers. The idea here is that if the SPI bus isn’t working, it’s pointless to do any further testing until that can get sorted out. The sketch simply reads the register data to a serial console so I can check it with the default parameters of the datasheet. Here’s the results from the SPI testing:

It looks like the register values match! Cool, so onto transmitter testing next…


Awesome! Are you going to borrow from the Radiohead library? I’ve used that in the past for LoRa stuff. I’m a bit of two minds about it. I feel like having a feel for the registers is very important…but I’m also very lazy :smiley:


Thanks Chris! There doesn’t seem to be a library currently available that’s tailored specifically for the transceiver that I’m using (the SX1238). Although I have been working on adapting code from this library from low power lab.

The low power lab library is built around the SX1231 transceiver, but it seems to be very similar to the SX1238. The main difference is the SX1238 has an extra LNA on the receive and an extra power amp on the transmit. They do share a lot of the same registers, but most of them have different addresses, and a few registers have been added or removed.

I do agree though, ideally I would use a prebuilt library for something like this. The low power lab library I think will give me a lot of what I need. And the rest will be a bit of a treasure hunt. It does feel like I’m in a bit of uncharted territory, which is both exciting and terrifying at the same time. :slight_smile:


Ah, didn’t realize the Radiohead library was for the SX12xx family of parts. Cool, well keep us updated on how it goes! Hopefully it’s well documented on the chip side of things.


That Radiohead library looks like it will come in handy in the future. It seems like it’s a little easier to understand than the one I’ve been working with. Thanks again!


I’ve been working more on writing firmware to test the SX1238 transceiver modules. In my last post the modules had passed the magic smoke and initial communications test. The next step was to see if they could learn to talk to each other.

Although I couldn’t locate any ready made libraries to drive this particular IC, there were a few none the less that helped to guide me in the right direction. Those libraries were the RF69 library by Lowpower Lab, as well as the Radiohead library which @ChrisGammell suggested. These libraries interfaced with a similar model transceiver, the SX1231, which was also designed by Semtech.

One of the features of the SX1238 that intrigued me was that it included not one, but two low noise amplifiers on its receive, as well as two power amplifiers on its transmit. These added amplifiers should not only make it easier to detect weak signals, but should also give the transceiver a theoretical longer range as compared to the SX1231. Here is a view of the block diagram for the SX1238 showing how the internals are laid out.

These added amplifiers, PA2 and LNA1, are turned on/off through three front end control pins, TXEN, RXEN, and MODE. The operation of these pins through the different transmit/receive modes can be seen here:


Interfacing with these pins was of course just a matter of connecting the appropriate pins on the transceiver module to the arduino and then toggling them during the transmit and receive sequence.

To test the transmitter I used a cheap RTL-SDR dongle and the free SDR Sharp software. I just wrote a simple sketch which transmits a packet once a second and looked for the signal to show up somewhere on the FFT plot. It was a thrill to see the signal pop up on the screen for the first time! It was alive!


After this euphoria, I thought setting up the receiver would be the easy part. Boy was I wrong! The firmware for the receiver was setup to simply listen for incoming packets from the transmitter, and then print those packets out to the serial monitor. The excitement was nearly unbearable the first time I uploaded the firmware to the receiver. Expecting to see a rush of packets fill the serial monitor screen, instead there was nothing. Just a blank screen. The roller coaster thrill ride came crashing down and hit with reality.

There was an onslaught of doubt in my mind after this initial test. Maybe there was something wrong with the pcb, or perhaps there was a faulty solder connection somewhere. It was obvious that something was being transmitted since the signals were being picked up by the SDR Sharp software. However, maybe the actual transmission was just garbage.

After taking a break for a bit and getting some air, I decided to dig through the datasheet again and analyze my code a bit more. This digging led me to discover a peculiar register named RegFifoThresh that had as one of its variable names TxStartCondition. TxStartCondition, as its name implies, determines the state at which the transmitter would begin transmitting packets from the FIFO. By default this register was set to only transmit after a specified FIFO threshold had been passed. Since I wanted the transmitter to transmit whenever there was a new packet in the FIFO, I changed this default value to allow the transmitter to transmit whenever the FIFO was not empty. After making this modification and uploading the firmware once again, I started to see a few packets being received and printed out on the monitor. However, the packets weren’t consistent, and the data wasn’t recognizable. But it was progress!

I ended up experimenting for some time with all the various filters and frequency shaping registers. It was fascinating just to make some changes to a few registers and see how it affected the look of the signal in SDR Sharp. I finally cleared the registers pertaining to the frequency deviation of the signal, and reset it to its default parameter. And low and behold, I started receiving packets! I had modified these register values when porting some of the code from the other libraries into my own. It’ll require a bit more experimentation to see what the optimal frequency deviation will for various bit rates, but for now at least I know the design works!

As with all projects, you tend to learn more from the things that don’t work the first time. And this project was no exception. I’d like to think that I have a new appreciation for RF, and just how delicate a balance it can be to get things to behave just right. My oldest daughter and I are in the process of studying for our HAM radio licenses (I currently hold a Novice class) and it was educational for us to see the correlation between these things (frequency deviation, bandwidth, side band) we’re reading about, and viewing them live via the SDR software. It was also reassuring to know that the 5 rules for RF board layout and design that Michael Ossmann gave proved reliable at least for this small project.


Nice write up Jon. You are right about learning when things don’t work. I have made the same experience.
I have been working on some a remote sensor project (write up to follow), but I opted to skip the RF side and use some XBee modules. I wanted to get the end-to-end story happening first before dealing with the RF side properly. It looks like you have simply jumped into the deep end. Well done!


Thank you Steve. There were definitely some moments when I was sure I would drown in the deep end :smile:. Without the help of the open source community and RF giants like Michael Ossmann I think this project would have met a tragic end.


This is great, I really like that you were putting your RTL SDR to good use. It acts as a great sanity check for what’s actually getting pumped out of the transceiver. What’s next?


Thanks Chris. Yeah the RTL SDR stuff is pretty cool. It’s almost like an oscilloscope for radio waves. I knew it was transmitting something, just not sure what it was transmitting :grin:. Next I’m going to finish up the library and publish it on github so others can hopefully make some use of it. I have a few project ideas, but I’ll have to do some more testing to see what these things are truly capable of first. Now that I know the design works I may end up building one or two more to have some spares.


Continuing from my last post, the SX1238 transceivers were built and tested. Now I wanted to do more field testing to find a suitable application. I have a little less than 2 acres of wooded property so I thought it might be a nice test in range to see if the transceivers could communicate at opposite sides of the property. The transceivers had no trouble communicating at that range, even through buildings. This made me think that these might be perfect for building a small sensor network.

The SX1238 allows for communication for up to 254 devices on one network. I figure that should be plenty for my needs. My plan right now is to build a sensor node PCB that connects into the transceiver. The PCB would have a low power microcontroller for communicating between the transceiver and the sensor. It would also need to be battery powered, or at least have that option since they would most likely be deployed in areas away from power outlets. The sensor nodes would then communicate to a hub (maybe a raspberry pi?) which would act as the brains of the operation and perform whatever tasks needed based on the incoming sensor data.

To save power, the battery operated sensor nodes would most likely be in a sleep or standby state until woken up by either a timer or interrupt from the sensor. At that point they would perform whatever action was needed, transmit that data back to the hub, and then go back to sleep.

For the microcontroller, I’m considering either the STM32L0 or the Microchip ATSAML21 series. Both of these offer ultra low power options that would fit the needs of this project. At this point I’m leaning slightly more towards using the STM32L0 because it seems to have the most community support and since this would be my first venture into ARM, I may need the added support.

For battery power, I’m looking at possibly the CR123A or rechargeable equivalent. They’re approximately half the size of an 18650 and would fit nicely next to the transceiver PCB.

When looking at enclosures, I want something that would obviously stand up to the elements and have the appropriate IP and NEMA ratings. It would be nice to have built in mounting bosses for attaching the PCB. Maybe something like this.

For the antenna, I could either keep the antenna inside the enclosure, or I may end up using something like this IP68 rated SMA coupling and a short length of coax to connect the antenna to the outside world. This would have the benefit of better reception and a smaller possible enclosure. Plus it might just look cool.

To help me stay on course, I’ve come up with a few learning objectives for this project. First I would like to become familiar with programming ARM based microcontrollers. Second, I want to gain understanding in working with and optimizing for low power. Third, to learn to choose and design around an enclosure. And last but not least I would like to learn how to write code for and interface with an embedded Linux system such as the Raspberry Pi. This may be overly ambitious for me, but even if I meet just a few of these goals it would be of great benefit.