Insert The following install guide details the steps from a fresh Ubuntu 22.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. '''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 22.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 setting what is needed with other distro's. See also [[Gr-smart meters Setup on other distros]] For now, this step is to install a base version of Ubuntu 20.04, mine was a minimal install. After finishing your install ensure you update everything. <pre>sudo apt updatesudo apt upgrade</pre>Also install the following<syntaxhighlight lang="bash">sudo apt install libsndfile1-dev cmake</syntaxhighlight> ====For flavors other than Ubuntu or depending on your window environment you may need:====<syntaxhighlight lang="bash">add apt-get install -y gobject-introspection gir1.2-gtk-3.0</syntaxhighlight> ==Install GNU Radio 3.10==The version packaged with Ubuntu (3.10.1 as of 12-30-2022) works fine, has been tested up to 3.10.5<syntaxhighlight lang="bash">sudo apt-get install gnuradio</syntaxhighlight> ==SDR Hardware Support== ===All support is now native in GNURadio 3.10.=== *UHD can be used for Ettus USRP hardware*Soapy Custom Source is used for HackRF, AirSpy, BladeRF and RTL-SDR ==Install Frequency Hopping Spread Spectrum capture Utilities==If you already have GNU Radio and your SDR setup you should start here to install the Sandia Laboratories out of tree (OOT) modules. Four different OOT modules are needed. #[https://github.com/sandialabs/gr-pdu_utils PDU Utilities]#[https://github.com/sandialabs/gr-timing_utils Timing Utilities]#[https://github.com/sandialabs/gr-sandia_utils Sandia Utilities]#[https://github.com/sandialabs/gr-fhss_utils FHSS Utilities] ===Create a folder to organize them===<syntaxhighlight lang="bash">cdmkdir FHSS_Utilscd FHSS_Utils</syntaxhighlight> ===Install PDU Utilities===<syntaxhighlight lang="bash">git clone https://github.com/sandialabs/gr-pdu_utils.gitcd gr-pdu_utils/git checkout maint-3.10mkdir buildcd buildcmake ..make -j8sudo make installsudo ldconfigcd ../..</syntaxhighlight> ===Install Sandia Utilities===<syntaxhighlight lang="bash">git clone https://github.com/sandialabs/gr-sandia_utils.gitcd gr-sandia_utils/git checkout maint-3.10mkdir buildcd build/cmake ..make -j8sudo make installsudo ldconfigcd ../..</syntaxhighlight> ===Install Timing Utilities===<syntaxhighlight lang="bash">git clone https://github.com/sandialabs/gr-timing_utils.gitcd gr-timing_utils/git checkout maint-3.10mkdir buildcd buildcmake ..make -j8sudo make installsudo ldconfigcd ../..</syntaxhighlight> ===Install FHSS Utilities===<syntaxhighlight lang="bash">git clone https://github.com/sandialabs/gr-fhss_utils.gitcd gr-fhss_utils/git checkout maint-3.10mkdir 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.10mkdir buildcd build/cmake ..make -j8sudo make installsudo ldconfig</syntaxhighlight> ===Install 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 Radiofrom a terminal window===<code>gnuradio-companion</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 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 be sure there aren't any errors. Every power provider is assigned a 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 CRC.===Install reveng===It's on sourceforge: https://reveng.sourceforge.io/Documentation is at: https://reveng.sourceforge.io/readme.htmDownload the .zip in the latest releases folder: https://sourceforge.net/projects/reveng/files/2.1.1/Follow instructions to make===Provide reveng four good packets===I find the easiest way to do this is to limit the '''Packet Type''' to 0x55 and '''Packet Length''' to 0x23. Edit the GridStream block and make those changes then run the flowgraph making sure '''CRC Enable''' is set to False. You will get data that looks like this below. <code>00FF2A55002330FFFFFFFFFFFF50CF5DD9E2C0B80065F5D1A483F0FBBC6F01001E6C043B517E90B286</code> You need to remove the first 6 bytes and provide the rest as inputs to reveng, CRC isn't calculated on those bytes. <code>00FF2A550023 <-- Discard | 30FFFFFFFFFFFF50CF5DD9E2C0B80065F5D1A483F0FBBC6F01001E6C043B517E90B286</code> Now provide four samples to reveng <code>./reveng -w 16 -s 30FFFFFFFFFFFF50CF5DD9E2C0B80065F5D1A483F0FBBC6F01001E6C043B517E90B286 30FFFFFFFFFFFF50CF2DD9E560560065F5D5A483F0C000650100176C033FF77E901766 30FFFFFFFFFFFF50CF95D9E5E01A0065F5D9A483F0515A0201001E6C042A177E90BDA4 30FFFFFFFFFFFF50CF8DD9E6A0F00065F5EBA483F0EBFD4A0100206C0433A97E90B04C</code> You should get the following output below if you used this data to test <code>width=16 poly=0x1021 init=0x5fd6 refin=false refout=false xorout=0x0000 check=0x139e residue=0x0000 name=(none)</code> The init value is what you enter into the GridStream block, you can now enable the CRC and know you have correct data! {{#widget:CRCprefix}}