unleashed-firmware/debug/FreeRTOS/FreeRTOSgdb/HandleRegistry.py

85 lines
2.7 KiB
Python
Raw Normal View History

2020-10-17 13:34:16 +00:00
# File: HandleRegistry.py
# Author: Carl Allendorph
# Date: 06NOV2014
#
# Description:
# THis file contains the implementation of a class for accessing the
# handle registry. This contains a mapping of queue handles to
# strings for labeling purposes.
import gdb
from .Types import StdTypes
from .QueueTools import *
class HandleRegistry:
"""The FreeRTOS system can be configured with a table that
associates a name with a QueueHandle_t.
This class can be used to access this table and
label queue/mutex/semaphore/event groups
"""
def __init__(self, regSymbol="xQueueRegistry"):
symbol, methodObj = gdb.lookup_symbol(regSymbol)
self._registry = symbol.value()
self._minIndex = 0
self._maxIndex = 0
self._minIndex, self._maxIndex = self._registry.type.range()
def GetName(self, handle):
"""Find the string name associated with a queue
handle if it exists in the registry
"""
for i in range(self._minIndex, self._maxIndex):
elem = self._registry[i]
h = elem["xHandle"]
val = h.cast(StdTypes.uint32_t)
if handle == val:
print("Found Entry for: %x" % handle)
name = elem["pcQueueName"].string()
return name
def PrintRegistry(self):
for i in range(self._minIndex, self._maxIndex):
elem = self._registry[i]
h = elem["xHandle"]
if h != 0:
name = elem["pcQueueName"].string()
print("%d: %3s %16s" % (i, h, name))
def FilterBy(self, qMode):
"""Retrieve a List of Mutex Queue Handles"""
resp = []
for i in range(self._minIndex, self._maxIndex):
elem = self._registry[i]
h = elem["xHandle"]
if h != 0:
name = elem["pcQueueName"].string()
q = QueueInspector(h)
q.SetName(name)
if qMode != None:
qType = q.GetQueueType()
if qType != None:
if qType == qMode:
resp.append(q)
else:
print("qType == None")
else:
resp.append(q)
return resp
def GetMutexes(self):
"""Retrieve all the Mutex Objects in the Handle Registry"""
return self.FilterBy(QueueMode.MUTEX)
def GetSemaphores(self):
"""Retrieve all the Semaphore Objects in the Handle Registry"""
return self.FilterBy(QueueMode.BINARY)
def GetQueues(self):
"""Retrieve all the Queue Objects in the Handle Registry"""
return self.FilterBy(QueueMode.QUEUE)