• References

    Christoph Tack09/16/2020 at 19:43 0 comments

    Prior art

    1. Long Range Arduino Based Walkie Talkie using nRF24L01 : many similar projects, all using the RF24Audio library.
    2. Walkie Talkie Duino using RFM12B "open source" (only to the Kickstarter backers).
    3. DRA818V analog FM module (lots of harmonics, will need a license to operate)

  • Hardware choices

    Christoph Tack09/15/2020 at 18:09 0 comments

    Platform

    nRF52 implementation

    64MHz

    github : Implements codec2 on a Adafruit Feather nRF52 Bluefruit LE.

    Codec2 has been modified so that it can be built using Arduino framework.

    STM32 implementation

    STM32 Discovery

    168MHz

    Rowetel/Dragino Tech SM1000

    Audio IO

    I²S

    As we're only processing low quality 8kHz speech here, a high-end audio codec like the SGTL5000 is not necessary.  The SparkFun I2S Audio Breakout - MAX98357A is more suitable.

    PWM & ADC

    The SM1000 contains the analog circuitry we need.

    Application to demonstrate PWM audio functionality on nRF52

  • Text to speech to text

    Christoph Tack08/28/2020 at 19:16 0 comments

    Using a speech codec, data transmission can be brought down to about 1200bps.  But how can we reduce data even further.  Let's take a 1min52s mono 8kHz speech sample as an example

    1. ve9qrp.wav : 1.799.212 bytes : 128000bps
    2. ve9qrp.bin : codec2 1200bps encoded : 16.866 bytes : 1200bps
    3. ve9qrp.txt : audio transcription of ve9qpr.wav : 1.178 bytes : 85bps

    Using codec2, we get a 106/1 compression ratio, using text 1527/1 compression ratio.  That's almost fifteen times better!

    If we use speech recognition on the transmit side, then send the transcription over and use speech synthesis on the receiving side, this might work.

    Speech recognition

    https://pypi.org/project/SpeechRecognition/

    Even though speech recognition engines are very good these days, they're still not as good as human beings.  The transcript text could be shown to the speaker during transmission.  In case of errors, the speaker could repeat the incorrect word or spell out its characters.

    A speech engine also requires a language preset.  That shouldn't be too much of a hurdle because we all speak the same language most of the times.

    Is there good speech recognition software that runs offline?

    Is speech recognition software not too power hungry?

    Speech synthesis

    Using Linux command line tools

  • Wireless communication

    Christoph Tack08/26/2020 at 19:25 0 comments

    WiFi

    I'm not planning to turn this into an actual application.  It's only a proof of concept.  If you want a VoIP solution that you could really use in your application, have a look at Mumble.  It's used in the RigPi.

    TCP

    • wireless_mic_TCP : a server is connected to an audio source.  Clients can connect to this server and output the received sound to an audio sink.  One way transmission only.  In contrast to the example it was based on, this implementation is fully non-blocking.
    • wireless_2way_audio_TCP : simultaneous 2 way audio system.  Voice-intercom over TCP-connection.  A very simple VoIP application in some way.
    • wireless_2way_audio_TCP_codec2 : the same application as above, but transferred data is first encoded with codec2.

    UDP

    LoRa RFM96W

    • 433MHz
    • maximum effective bitrate : 37.5kbps
    • 256 byte FIFO, shared for RX & TX
    • Critical parameters:
      • spreading factor,
      • modulation bandwidth
      • error coding rate

    References

  • Codec2 installation & test

    Christoph Tack08/15/2020 at 12:01 0 comments

    Installation

    When you're using Ubuntu, version > 19 is needed.

    sudo apt install python3-pip libcodec2-dev

    It might be better not to use "sudo" to avoid messing up the libraries that come with your Linux distribution. Alternatively, you can use PyCharm and use a virtual environment where all of these libraries get installed.

    sudo pip3 install Cython
    sudo pip3 install numpy
    sudo pip3 install pycodec2
    

    TEST0: offline encoding & decoding using cli-tools

    The codec2 examples you can find on the internet are presumably specially chosen to go well with the algorithm.  Let's grab a video from youtube using a Youtube Video Downloader.  This will give you an mp4-file.  Strip the audio from that video and convert the audio to 8kHz mono and strip it down to the first two minutes using a only a single command:

    ffmpeg -i Who\ Invented\ the\ Food\ Pyramid\ and\ Why\ You\'d\ Be\ Crazy\ to\ Follow\ It.mp4 -acodec pcm_s16le -ac 1 -ar 8000 -t 00:02:00 out.wav

     Then using codec2 on that file is as simple as:

    c2enc 1200 ve9qrp.wav ve9qrp.bit
    c2dec 1200 ve9qrp.bit ve9qrp_decoded.raw
    ffmpeg -f s16le -ar 8k -ac 1 -i ve9qrp_decoded.raw ve9qrp_decoded.wav

    The sample from the Youtube video, after running it through codec2 sounds like this.  No, it doesn't sound great, but keep in mind that the original video has a 44.1kHz stereo signal.  Converting that to 8kHz mono already has an audible impact.  Passing it through a 1200bps codec2 tunnel is responsible for the other artifacts.

    TEST1: offline encoding & decoding using python

    Download example.py:

    wget https://raw.githubusercontent.com/gregorias/pycodec2/master/example.py

    Then run it using:

    python3 example.py ve9qrp.wav

    To simultaneously encode/decode this 1'52s audio fragment, the Wandboard (iMX6Q) needs 8.21s.  So real-time implementation should be possible.
    Example.py will create output.raw which will contain the wav file encoded and then decoded by codec2.  You can listen to it with:

    aplay -D hw:CARD=imx6wandboardsg,DEV=0 -f S16_LE output.raw

    The -D option is to send the audio to line-out on a Wandboard.  You could remove it when you're using other hardware.

    You can encode and decode a file by using python or using cli-tools and compare the results.  They will be identical.  I simplified the example.py by using np.frombuffer() and np.asarray(), so the "import struct" is no longer necessary.

    TEST2: reading wav-file from disk, encode, decode, send result to line-out

    play_sound_samplerate_codec2 : works fine on a core i7,8thGen and on the Wandboard.

    TEST3: encoding and decoding of streaming audio

    record_play_codec2 : get input from line-in, encode it to Codec2, decode it and output it to line-out.  Works both on the Wandboard and on the laptop.  On the Wandboard, the samplerate filter had to be reduced from "sinc_best" to "sinc_medium", otherwise there was no sound.

  • Audio capture & playback

    Christoph Tack08/10/2020 at 11:32 0 comments

    Python

    Requirements for pyaudio:

    sudo apt install libportaudio2 libportaudiocpp0 python3-pip portaudio19-dev
    sudo pip3 install pyaudio
    sudo pip3 install sounddevice

    Some simple test applications:

    • play sound from WAV-file: plays 8kHz files on Wandboard, but not on my PC, as 8kHz is not supported by the hardware.
    • record sound from mic/line-in to WAV-file
    • audio pass through from mic/line-in to line-out, implemented in two ways: using pyaudio and using sounddevice library.  On the Wandboard, the sounddevice library only seems to work for 30s or so.  After that, there's sonic boom on the output.  The Wandboard needs to be power-cycled to restore sound output.  The pyaudio library doesn't seem to have that issue and keeps playing Judas Priest without problems.

    References:

    Audio resampling

    Codec2 works with a fixed sample rate of 8kHz.  The line-in and line-out work at 48kHz.  A sample rate conversion is needed.  Several options are considered:

    audioop.ratecv

    No libraries need to be installed.  The implemented filters are simple first order filters and it certainly sounds like that.

    This works both on the Core i7 8thGen and the Wandboard.

    play_sound_ratecv

    samplerate

    sudo pip3 install samplerate

    This library runs fine on a Core i7 8thGen and on the Wandboard.  Be sure to convert the output of this library to int16 before feeding it back to pyAudio.  Python doesn't complain about wrong types as a C++ program would, but the result sounds terrible.

    This "sync-best"-filter is audibly the best performing filter.

    play_sound_samplerate

    resampy

    Works fine on a Core i7 8thGen.  Takes more than two hours to build on a Wandboard.  This package has more than 300MB of dependencies.

    sudo apt install gfortran llvm-dev libblas3 liblapack3 liblapack-dev libblas-dev
    sudo pip3 install resampy

    play_sound_resampy : open a 8kHz wave file, up-sample it to 48kHz and then play it.  Works fine on a Core i7 8thGen.  On the Wandboard, it takes much longer to start and it hangs.  No sound is ever generated.

  • Data layers

    Christoph Tack08/09/2020 at 21:15 0 comments

    Physical layer

    LoRa

    • EU433 ISM-band (less stringent than EU863-870MHz ISM Band)
    • Maximum TX-power = 12.15dBm EIRP
    • TX-duty cycle < 10%

    This depends on the chipset and modulation used.  Typically a preamble is inserted here.  LoRaWAN uses an 8 symbol preamble.

    Data link layer

    FreeDV uses ethernet frames : 2x 6byte address, 2byte length, payload (46 to 1500bytes), FCS(=CRC32):

    Ethernet 802.3 layer 2 ethernet frame

    LoRa

    The walkie-talkie application doesn't need that amount of overhead. We can suffice with the OSI layer 2 provided by the wireless chipset:
    Semtech SX127x Layer 2, Variable length frame

  • Speech codec

    Christoph Tack08/09/2020 at 14:48 0 comments

     As the walkie talkie will use digital voice transmission, we need a way to digitize speech.  Several open source speech codecs are available.  We will focus on low-bitrate codecs because we want long range.  Opus and Speex won't do.  There's one codec that excels : codec2 :

    • bitrates as low as 700bps possible (but not usable, see below)
    • open source
    • existing implementation on PC, STM32 and nRF52
    • used in ham radio applications (e.g. FreeDV)

    Installation on Ubuntu

    sudo apt install codec2

    Some experiments

    After installation of codec2, the raw audio file test samples are available in /usr/share/codec2/raw

    I tried playing with the 700bps bitrate, but that never yielded results that were easily understandable.  If you had a conversation with someone using this bitrate, you would frequently have to ask to repeat sentences.

    1200bps seems to me the minimum practically achievable bitrate.

    christoph@christoph-ThinkPad-L580:/usr/share/codec2/raw$ c2enc 1200 ve9qrp.raw ~/ve9qrp.bit --natural && c2dec 1200 ~/ve9qrp.bit ~/ve9qrp_codec2_1200.raw --natural && aplay -f S16_LE ~/ve9qrp_codec2_1200.raw <br><br> 
    max_amp: 80 m_pitch: 320
    p_min: 20 p_max: 160
    Wo_min: 0.039270 Wo_max: 0.314159
    nw: 279 tw: 40
    max_amp: 80 m_pitch: 320
    p_min: 20 p_max: 160
    Wo_min: 0.039270 Wo_max: 0.314159
    nw: 279 tw: 40
    Playing raw data '/home/christoph/vk5qi_codec2_1200.raw' : Signed 16 bit Little Endian, Rate 8000 Hz, Mono
    christoph@christoph-ThinkPad-L580:/usr/share/codec2/raw$ 

    For your audio playback convenience, these raw files have been converted to WAV-file format using:

    sox -e signed-integer -b 16 -r 8000 -c 1 ve9qrp.raw ~/ve9qrp.wav

    File sizes:

    • ve9qrp.raw (original file) : 16bit samples, 8kHz sampling = 128ksps -> 1799168 bytes (WAV-file version)
    • ve9qrp.bit (codec2 1200 encoded) : 1.2ksps : 16866 bytes
    • ve9qrp_codec2_1200.raw (decoded) : 1799040 bytes (WAV-file version)

    So we see that codec2 achieves a 128k/1.2k = 106.7/1 compression ratio.  That's truly impressive.

    Of course, this compression ratio comes at a price : computational complexity.  There's no way you could pull this off in real time with an AVR-microcontroller.  You need at least an MCU with an FPU, such as the STM32F4.  An ESP32 doesn't seem suited either.  A Raspberry Pi could be used at the cost of higher current consumption.