Changes

The following install guide details the steps from a fresh Ubuntu 2022.04 install to a fully running GNU Radio + USRP B200 , HackRF, AirSpy and RTL-SDR frequency hopping spread spectrum setup needed to capture smart meter data. The guide will be updated/broken out as additional SDR's like the HackRF and RTL-SDR are added.

'''This video shows the overall process but using a prior version of GNURadio. Instructions below are the latest.''' <youtube width="320" height="240">fUK8tcFQwpo</youtube> '''For other Linux distributions please see:''' [[Gr-smart meters Setup on other distros]] '''For Windows Subsystem for Linux (WSL) please see:''' [[Gr-smart meters on WSL]] ==Install Ubuntu 2022.04===There is nothing special about Ubuntu, it was chosen because it works well across different computers and has a familiar interface. Likely these instructions can be used as a rough guide for what is needed with other distro's. See also [[Gr-smart meters Setup on other distros]]

<syntaxhighlight lang="bash"pre>

===Install dependencies=For flavors other than Ubuntu or depending on your window environment you may need:====The block at the top is standard from the GNU Radio install guide. The two additional below are vim so you get nice colors in your editor and liborc which is needed for the additional GNU Radio blocks that will be installed.<syntaxhighlight lang="bash">sudo add apt -get install git cmake g++ libboost-all-dev libgmp-dev swig python3-numpy python3-mako python3-sphinx python3-lxml doxygen libfftw3-dev libsdl1.2-dev libgsl-dev libqwt-qt5-dev libqt5opengl5-dev python3-pyqt5 liblog4cpp5-dev libzmq3-dev python3-yaml python3-click python3-click-plugins python3-zmq python3-scipy python3-gi python3-gi-cairo y gobject-introspection gir1.2-gtk-3.0</syntaxhighlight><code>sudo apt install liborc-0.4-dev vim</code>

===Install GNU Radio 3.8=10==This guide and the blocks used here are all dependent on GNU Radio The version packaged with Ubuntu (3.810. As 3.9 1 as of 12-30-2022) works fine, has been released for a while more blocks and packages are getting support so this guide may be updated in the future tested up to support 3.910.5<syntaxhighlight lang="bash">sudo add-apt-repository ppa:gnuradio/gnuradio-releases-3.8sudo apt updatesudo apt get install gnuradio

===For USRP B200 SDR Hardware Support===This is specific to the USRP B200 software defined radio, if you are using another SDR this will not be necessary. ====Install necessary packages====<code>sudo apt-get install libuhd-dev libuhd3.15.0 uhd-host</code>

====Download firmware needed for different USRP devices=All support is now native in GNURadio 3.10.===If this doesn't work your files may have been installed in /usr/local/lib instead of /usr/lib

====Configure USB and test USRP B200====<syntaxhighlight lang="bash">cd /usr/lib/uhd/utils/sudo cp uhd-usrp.rules /etc/udev/rules.d/sudo udevadm control --reload-rulessudo udevadm triggeruhd_usrp_probe</syntaxhighlight> ===For HackRF Support===<br />===For RTL-SDR Support===<br />===Install Frequency Hopping Utilities===

====Create a folder to organize them====

====Install PDU Utilities====

git checkout maint-3.810

cd ../..

====Install FHSS Sandia Utilities====

git clone https://github.com/sandialabs/gr-fhss_utilssandia_utils.gitcd gr-fhss_utilssandia_utils/git checkout maint-3.810

cd ../..

====Install Timing Utilities====

git checkout maint-3.810

cd ../..

====Install Sandia FHSS Utilities====

git clone https://github.com/sandialabs/gr-sandia_utilsfhss_utils.gitcd gr-sandia_utilsfhss_utils/git checkout maint-3.810mkdir buildcd build/cmake ..make -j8sudo make installsudo ldconfigcd ../..</syntaxhighlight> ===Finish up===Close all open terminal windows and then open a new one. ==Setup gr-smart_meters==This contains the GridStream block that will be used to decode Landis+Gyr Smart Meter data along with pre-configured flowgraphs for USRP B200, HackRF and RTL-SDR and a script to decode GPS data transmitted in some cases. ===Install gr-smart_meters===<syntaxhighlight lang="bash">git clone https://github.com/BitBangingBytes/gr-smart_meters.gitcd gr-smart_meters/git checkout maint-3.10

===Setup PYTHONPATHInstall python packages needed for Google Maps and Google Earth===If pip isn't installed: <pre> sudo apt install python3-pip </pre>Then:<syntaxhighlight lang="bash">pip install gmplot simplekml</syntaxhighlight> ===Start GNU Radio from a terminal window===<code>gnuradio-companion will give </code>===Open flowgraph for your SDR===In GNU Radio open a flowgraph and navigate to the gr-smart_meters/examples folder. If you have installed everything above you errors if should be able to run it and see smart meter data!==Determining your power providers CRC==CRC check is set to false in the sample flowgraphs so you will see data but can't find your python libraries that were just installedbe sure there aren't any errors. Also highly suggest starting gnuradio-companion from Every power provider is assigned a terminal as opposed unique CRC so neighboring smart meter systems do not interfere with each other. To determine this you need to capture at least 4 good packets and use reveng to reverse the icon CRC.===Install reveng===It's on sourceforge: https://reveng.sourceforge.io/Documentation is at: https://reveng.sourceforge.io/readme.htmDownload the .zip in Ubuntuthe latest releases folder: https://sourceforge. It gives you a nice net/projects/reveng/files/2.1.1/Follow instructions to make===Provide reveng four good packets===I find the easiest way to see console output do this is to limit the '''Packet Type''' to 0x55 and you have to configure path variables in other places '''Packet Length''' to 0x23. Edit the GridStream block and make those changes then run gnuradio-companion with the iconflowgraph making sure '''CRC Enable''' is set to False.  You will get data that looks like this below.

<code>/usr/local/lib/python3/dist00FF2A550023 <-packages- Discard | 30FFFFFFFFFFFF50CF5DD9E2C0B80065F5D1A483F0FBBC6F01001E6C043B517E90B286</code>

You can easily confirm by using "ls" Now provide four samples to show all the files there, if you see folder names corresponding to the packages installed above you have the correct folder. If not, try searching for other occurrences of "dist-packages" on your system where they may have been placed.reveng

====Edit .bashrc and add PYTHONPATH====Add the following to the end of your .bashrc if there is no PYTHONPATH variable<code>./reveng -w 16 -s 30FFFFFFFFFFFF50CF5DD9E2C0B80065F5D1A483F0FBBC6F01001E6C043B517E90B286 30FFFFFFFFFFFF50CF2DD9E560560065F5D5A483F0C000650100176C033FF77E901766 30FFFFFFFFFFFF50CF95D9E5E01A0065F5D9A483F0515A0201001E6C042A177E90BDA4 30FFFFFFFFFFFF50CF8DD9E6A0F00065F5EBA483F0EBFD4A0100206C0433A97E90B04C</code>

<code>width=16 poly=0x1021 init=0x5fd6 refin=Finish upfalse refout=false xorout=0x0000 check=0x139e residue=Close all open terminal windows and then open a new one.0x0000 name=(none)</code>

===Start GNU Radio The init value is what you enter into the GridStream block, you can now enable the CRC and open FHSS Flowgraph===ToDo: know you have correct data!