Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix for getting base id, when callback is defined #118

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 54 additions & 34 deletions enocean/communicators/communicator.py
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ class Communicator(threading.Thread):
'''
logger = logging.getLogger('enocean.communicators.Communicator')

def __init__(self, callback=None, teach_in=True):
def __init__(self, callback=None, teach_in=True, get_base_id=True):
super(Communicator, self).__init__()
# Create an event to stop the thread
self._stop_flag = threading.Event()
Expand All @@ -35,6 +35,16 @@ def __init__(self, callback=None, teach_in=True):
# Should new messages be learned automatically? Defaults to True.
# TODO: Not sure if we should use CO_WR_LEARNMODE??
self.teach_in = teach_in
# Keep track if parsing started ok
self.parse_started = threading.Event()
# Should we try to get base id in init?
self.get_base_id = get_base_id
if get_base_id:
# Ask for base_id, put as first packet in transmit buffer, wait for answer in parse loop
self.send(Packet(PACKET.COMMON_COMMAND, data=[0x08]))
else:
# Starting without base_id, set parsing started flag now
self.parse_started.set()

def _get_from_send_queue(self):
''' Get message from send queue, if one exists '''
Expand All @@ -54,6 +64,18 @@ def send(self, packet):
self.transmit.put(packet)
return True

def start(self):
''' Try to start parsing '''
super(Communicator, self).start()
# wait for parse to start
started_ok = self.parse_started.wait(5)
if not started_ok:
# Failed, stop parsing
self.logger.error('Communicator failed to start in time, stopping Communicator.')
self.stop()
return False
return True

def stop(self):
self._stop_flag.set()

Expand All @@ -70,47 +92,45 @@ def parse(self):
if status == PARSE_RESULT.OK and packet:
packet.received = datetime.datetime.now()

if isinstance(packet, UTETeachInPacket) and self.teach_in:
response_packet = packet.create_response_packet(self.base_id)
self.logger.info('Sending response to UTE teach-in.')
self.send(response_packet)

if self.__callback is None:
if not self.parse_started.is_set():
# Put packet in receive buffer
self.receive.put(packet)
# look for response packet with base id
if packet.packet_type == PACKET.RESPONSE and packet.response == RETURN_CODE.OK and len(packet.response_data) == 4: # noqa: E501
# Base ID is set with the response data, if not already set
if self._base_id is None:
self._base_id = packet.response_data
self.logger.info('Base ID: {}'.format(''.join('{:02X}'.format(x) for x in self._base_id)))
if self._base_id is not None:
self.parse_started.set()
self.logger.debug('Parsing started.')
if self.__callback is not None:
# Send receive queue to callback
while not self.receive.empty:
packet_from_queue = self.receive.get(block=False)
self.__callback(packet_from_queue)
else:
self.__callback(packet)
self.logger.debug(packet)
if isinstance(packet, UTETeachInPacket) and self.teach_in:
if self.base_id is None:
self.logger.warning('Sending response to UTE teach-in failed, no base_id set.')
else:
response_packet = packet.create_response_packet(self.base_id)
self.logger.info('Sending response to UTE teach-in.')
self.send(response_packet)

if self.__callback is None:
self.receive.put(packet)
else:
self.__callback(packet)
self.logger.debug(packet)

@property
def base_id(self):
''' Fetches Base ID from the transmitter, if required. Otherwise returns the currently set Base ID. '''
# If base id is already set, return it.
if self._base_id is not None:
return self._base_id

# Send COMMON_COMMAND 0x08, CO_RD_IDBASE request to the module
self.send(Packet(PACKET.COMMON_COMMAND, data=[0x08]))
# Loop over 10 times, to make sure we catch the response.
# Thanks to timeout, shouldn't take more than a second.
# Unfortunately, all other messages received during this time are ignored.
for i in range(0, 10):
try:
packet = self.receive.get(block=True, timeout=0.1)
# We're only interested in responses to the request in question.
if packet.packet_type == PACKET.RESPONSE and packet.response == RETURN_CODE.OK and len(packet.response_data) == 4: # noqa: E501
# Base ID is set in the response data.
self._base_id = packet.response_data
# Put packet back to the Queue, so the user can also react to it if required...
self.receive.put(packet)
break
# Put other packets back to the Queue.
self.receive.put(packet)
except queue.Empty:
continue
# Return the current Base ID (might be None).
return self._base_id

@base_id.setter
def base_id(self, base_id):
''' Sets the Base ID manually, only for testing purposes. '''
self._base_id = base_id
self.logger.info('Base ID (set manually): {}'.format(''.join('{:02X}'.format(x) for x in self._base_id)))

20 changes: 16 additions & 4 deletions enocean/communicators/tests/test_communicator.py
Original file line number Diff line number Diff line change
Expand Up @@ -30,17 +30,25 @@ def test_buffer():
@timing(1000)
def test_send():
''' Test sending packets to Communicator '''
com = Communicator()
com = Communicator(get_base_id=False)
assert com.send('AJSNDJASNDJANSD') is False
assert com.transmit.qsize() == 0
assert com._get_from_send_queue() is None
assert com.send(Packet(PACKET.COMMON_COMMAND, [0x08])) is True
assert com.transmit.qsize() == 1
assert isinstance(com._get_from_send_queue(), Packet)

@timing(5000)
def test_start():
com = Communicator(get_base_id=False)
assert com.start() is True
assert com.parse_started.is_set()
assert not com._stop_flag.is_set()
com.stop()
assert com._stop_flag.is_set()

def test_stop():
com = Communicator()
com = Communicator(get_base_id=False)
com.stop()
assert com._stop_flag.is_set()

Expand All @@ -58,14 +66,18 @@ def callback(packet):
0x75
])

com = Communicator(callback=callback)
com = Communicator(callback=callback, get_base_id=False)
com._buffer.extend(data)
com.parse()
assert com.receive.qsize() == 0


def test_base_id():
com = Communicator()
def callback(packet):
assert isinstance(packet, RadioPacket)

com = Communicator(callback=callback)
assert com.transmit.qsize() == 1
assert com.base_id is None

other_data = bytearray([
Expand Down