137 lines
5.8 KiB
C++
137 lines
5.8 KiB
C++
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* *
|
|
* This file is part of guh. *
|
|
* *
|
|
* Guh is free software: you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation, version 2 of the License. *
|
|
* *
|
|
* Guh is distributed in the hope that it will be useful, *
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
* GNU General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU General Public License *
|
|
* along with guh. If not, see <http://www.gnu.org/licenses/>. *
|
|
* *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
/*!
|
|
\class Radio433
|
|
\brief The Radio433 class helps to interact with the 433 MHz receiver and transmitter.
|
|
|
|
\ingroup hardware
|
|
\inmodule libguh
|
|
|
|
This class handles all supported radio 433 MHz receiver and transmitter. Receiving data on the 433.92 MHz frequency
|
|
is only supported, if there are \l{Gpio}{GPIO's} available and a suitable receiver is connected to GPIO 27. Examples for receiver
|
|
can be found \l{https://www.futurlec.com/Radio-433MHZ.shtml}{here}. The antenna has a very large impact on the quality
|
|
of the signal and how well it is recognized. In many forums and blogs it is described that a 17, 3 mm piece of wire is enough.
|
|
Experiments have shown, it's not. A 50 Ohm coaxial cabel (thickness = 1mm), mounted on the antenna pin of the receiver
|
|
with a minimum distance of 5 cm away from the circuit and unisolated 17.3 mm at the end has shown the best results.
|
|
|
|
In order to send data to a 433 MHz device, there currently are two possibilitis. If there are \l{Gpio}{GPIO's}
|
|
available, the data will be sent over the transmitter connected to GPIO 22. Also in this case the antenna is a verry
|
|
important part.
|
|
|
|
The second possibility to sent data to a 433 MHz device is the \l{http://www.brennenstuhl.de/de-DE/steckdosenleisten-schaltgeraete-und-adapter/brematic-hausautomation/brematic-home-automation-gateway-gwy-433-1.html}
|
|
{Brennenstuhl 433 MHz LAN Gateway}. If there is a Gateway in the local network, this class will automaticaly detect
|
|
it and will be used. If both transmitter are available (Gateway + GPIO), each signal will be transmitted over both sender.
|
|
*/
|
|
|
|
/*! \fn void Radio433::dataReceived(QList<int> rawData)
|
|
This signal is emitted when the receiver recognized a signal. The \a rawData parameter describes the signal.
|
|
*/
|
|
|
|
#include "radio433.h"
|
|
|
|
/*! Construct the hardware resource Radio433 with the given \a parent. Each possible 433 MHz hardware will be initialized here. */
|
|
Radio433::Radio433(QObject *parent) :
|
|
QObject(parent)
|
|
{
|
|
m_receiver = new Radio433Receiver(this,27);
|
|
m_transmitter = new Radio433Trasmitter(this,22);
|
|
m_brennenstuhlTransmitter = new Radio433BrennenstuhlGateway(this);
|
|
|
|
connect(m_receiver, &Radio433Receiver::readingChanged, this, &Radio433::readingChanged);
|
|
connect(m_receiver, &Radio433Receiver::dataReceived, this, &Radio433::dataReceived);
|
|
connect(m_brennenstuhlTransmitter, &Radio433BrennenstuhlGateway::availableChanged, this, &Radio433::brennenstuhlAvailableChanged);
|
|
}
|
|
|
|
/*! Destroys the hardware resource Radio433 object. */
|
|
Radio433::~Radio433()
|
|
{
|
|
m_receiver->quit();
|
|
m_transmitter->quit();
|
|
}
|
|
|
|
/*! Enables GPIO transmitter and receiver and the Brennenstuhl Lan Gateway.
|
|
* Returns true, if the GPIO's are available and set up correctly. The status of the gateway will be emited asynchronous. */
|
|
bool Radio433::enable()
|
|
{
|
|
m_brennenstuhlTransmitter->enable();
|
|
|
|
bool receiverAvailable = m_receiver->startReceiver();
|
|
if (!receiverAvailable) {
|
|
//qWarning() << "ERROR: radio 433 MHz receiver not available on GPIO's";
|
|
}
|
|
|
|
bool transmitterAvailable = m_transmitter->startTransmitter();
|
|
if (!transmitterAvailable) {
|
|
//qWarning() << "ERROR: radio 433 MHz transmitter not available on GPIO's";
|
|
}
|
|
|
|
if (!receiverAvailable && !transmitterAvailable) {
|
|
qWarning() << "--> Radio 433 MHz GPIO's not available.";
|
|
return false;
|
|
}
|
|
qDebug() << "--> Radio 433 MHz GPIO's enabled.";
|
|
return true;
|
|
}
|
|
|
|
/*! Returns true, if the Radio433 hardware resources disabled correctly. */
|
|
bool Radio433::disabel()
|
|
{
|
|
m_brennenstuhlTransmitter->disable();
|
|
if (m_receiver->stopReceiver()) {
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
void Radio433::readingChanged(bool reading)
|
|
{
|
|
if (reading) {
|
|
m_transmitter->allowSending(false);
|
|
} else {
|
|
m_transmitter->allowSending(true);
|
|
}
|
|
}
|
|
|
|
void Radio433::brennenstuhlAvailableChanged(const bool &available)
|
|
{
|
|
if (available) {
|
|
qDebug() << "--> Radio 433 MHz Brennenstuhl LAN Gateway available.";
|
|
} else {
|
|
qDebug() << "--> Radio 433 MHz Brennenstuhl LAN Gateway NOT available.";
|
|
}
|
|
}
|
|
|
|
/*! Returns true, if the \a rawData with a certain \a delay (pulse length) can be sent. */
|
|
bool Radio433::sendData(int delay, QList<int> rawData)
|
|
{
|
|
bool sendGpio = false;
|
|
bool sendBrennenstuhl = false;
|
|
|
|
if (m_brennenstuhlTransmitter->available()) {
|
|
sendBrennenstuhl = m_brennenstuhlTransmitter->sendData(delay, rawData);
|
|
}
|
|
|
|
if (m_transmitter->available()) {
|
|
m_transmitter->sendData(delay, rawData);
|
|
sendGpio = true;
|
|
}
|
|
|
|
return (sendGpio || sendBrennenstuhl);
|
|
}
|