blob: 37875a89826d1d58b21f29e5df41c153f4c8da18 [file]
#!/usr/bin/python3
# SPDX-License-Identifier: MIT
"""
This module contains unit tests for the datbase functions in the amd-debug-tools package.
"""
import unittest
from datetime import datetime
from unittest.mock import patch, MagicMock
from amd_debug.database import SleepDatabase
class TestSleepDatabase(unittest.TestCase):
"""Test SleepDatabase class"""
def setUp(self):
"""Set up mocks and an in-memory database for testing"""
# Initialize SleepDatabase after mocks are set up
self.db = SleepDatabase(dbf=":memory:")
def test_start_cycle(self):
"""Test starting a new sleep cycle"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.assertEqual(self.db.last_suspend, timestamp)
self.assertEqual(self.db.cycle_data_cnt, 0)
self.assertEqual(self.db.debug_cnt, 0)
def test_record_debug(self):
"""Test recording a debug message"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_debug("Test debug message", level=5)
cur = self.db.db.cursor()
cur.execute(
"SELECT message, priority FROM debug WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, ("Test debug message", 5))
def test_record_battery_energy(self):
"""Test recording battery energy"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_battery_energy("Battery1", 50, 100, "mWh")
cur = self.db.db.cursor()
cur.execute(
"SELECT name, b0, b1, full, unit FROM battery WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, ("Battery1", 50, None, 100, "mWh"))
def test_record_cycle_data(self):
"""Test recording cycle data"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle_data("Test cycle data", "symbol1")
cur = self.db.db.cursor()
cur.execute(
"SELECT message, symbol FROM cycle_data WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, ("Test cycle data", "symbol1"))
def test_record_cycle(self):
"""Test recording a sleep cycle"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle(
requested_duration=100,
active_gpios="GPIO1",
wakeup_irqs="IRQ1",
kernel_duration=1.5,
hw_sleep_duration=2.5,
)
cur = self.db.db.cursor()
cur.execute(
"SELECT requested, gpio, wake_irq, kernel, hw FROM cycle WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, (100, "GPIO1", "IRQ1", 1.5, 2.5))
def test_report_debug(self):
"""Test reporting debug messages"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_debug("Test debug message", level=5)
result = self.db.report_debug(timestamp)
self.assertEqual(result, [("Test debug message", 5)])
def test_report_battery(self):
"""Test reporting battery data"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_battery_energy("Battery1", 50, 100, "mWh")
result = self.db.report_battery(timestamp)
self.assertEqual(
result,
[
(
int(timestamp.strftime("%Y%m%d%H%M%S")),
"Battery1",
50,
None,
100,
"mWh",
)
],
)
def test_record_prereq(self):
"""Test recording a prereq message"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_prereq("Test prereq message", "symbol1")
cur = self.db.db.cursor()
cur.execute(
"SELECT message, symbol FROM prereq_data WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, ("Test prereq message", "symbol1"))
def test_report_prereq(self):
"""Test reporting prereq messages"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_prereq("Test prereq message 1", "symbol1")
self.db.record_prereq("Test prereq message 2", "symbol2")
result = self.db.report_prereq(timestamp)
self.assertEqual(
result,
[
(
int(timestamp.strftime("%Y%m%d%H%M%S")),
0,
"Test prereq message 1",
"symbol1",
),
(
int(timestamp.strftime("%Y%m%d%H%M%S")),
1,
"Test prereq message 2",
"symbol2",
),
],
)
def test_report_prereq_no_data(self):
"""Test reporting prereq messages when no data exists"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
result = self.db.report_prereq(timestamp)
self.assertEqual(result, [])
def test_report_prereq_none_timestamp(self):
"""Test reporting prereq messages with None timestamp"""
result = self.db.report_prereq(None)
self.assertEqual(result, [])
def test_report_cycle(self):
"""Test reporting a cycle from the database"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle(
requested_duration=100,
active_gpios="GPIO1",
wakeup_irqs="IRQ1",
kernel_duration=1.5,
hw_sleep_duration=2.5,
)
result = self.db.report_cycle(timestamp)
self.assertEqual(
result,
[
(
int(timestamp.strftime("%Y%m%d%H%M%S")),
int(datetime.now().strftime("%Y%m%d%H%M%S")),
100,
"GPIO1",
"IRQ1",
1.5,
2.5,
)
],
)
def test_report_cycle_no_data(self):
"""Test reporting a cycle when no data exists"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
result = self.db.report_cycle(timestamp)
self.assertEqual(result, [])
def test_report_cycle_none_timestamp(self):
"""Test reporting a cycle with None timestamp"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle(
requested_duration=100,
active_gpios="GPIO1",
wakeup_irqs="IRQ1",
kernel_duration=1.5,
hw_sleep_duration=2.5,
)
result = self.db.report_cycle(None)
self.assertEqual(
result,
[
(
int(timestamp.strftime("%Y%m%d%H%M%S")),
int(datetime.now().strftime("%Y%m%d%H%M%S")),
100,
"GPIO1",
"IRQ1",
1.5,
2.5,
)
],
)
def test_get_last_cycle(self):
"""Test getting the last cycle from the database"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle(
requested_duration=100,
active_gpios="GPIO1",
wakeup_irqs="IRQ1",
kernel_duration=1.5,
hw_sleep_duration=2.5,
)
result = self.db.get_last_cycle()
self.assertEqual(result, (int(timestamp.strftime("%Y%m%d%H%M%S")),))
def test_get_last_cycle_no_data(self):
"""Test getting the last cycle when no data exists"""
result = self.db.get_last_cycle()
self.assertIsNone(result)
def test_get_last_prereq_ts(self):
"""Test getting the last prereq timestamp from the database"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_prereq("Test prereq message 1", "symbol1")
self.db.record_prereq("Test prereq message 2", "symbol2")
result = self.db.get_last_prereq_ts()
self.assertEqual(result, int(timestamp.strftime("%Y%m%d%H%M%S")))
def test_get_last_prereq_ts_no_data(self):
"""Test getting the last prereq timestamp when no data exists"""
result = self.db.get_last_prereq_ts()
self.assertEqual(result, 0)
def test_report_cycle_data(self):
"""Test reporting cycle data"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle_data("Test cycle data 1", "symbol1")
self.db.record_cycle_data("Test cycle data 2", "symbol2")
result = self.db.report_cycle_data(timestamp)
expected_result = "symbol1 Test cycle data 1\nsymbol2 Test cycle data 2\n"
self.assertEqual(result, expected_result)
def test_report_cycle_data_no_data(self):
"""Test reporting cycle data when no data exists"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
result = self.db.report_cycle_data(timestamp)
self.assertEqual(result, "")
def test_report_cycle_data_none_timestamp(self):
"""Test reporting cycle data with None timestamp"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_cycle_data("Test cycle data 1", "symbol1")
result = self.db.report_cycle_data(None)
expected_result = "symbol1 Test cycle data 1\n"
self.assertEqual(result, expected_result)
def test_record_power_rail_energy_insert(self):
"""Test inserting power rail energy (first call in prep)"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_power_rail_energy("CPU_VDDCR_PH1", 1000000.0, 149011.611)
cur = self.db.db.cursor()
cur.execute(
"SELECT label, e0, e1, scale FROM power_rails WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, ("CPU_VDDCR_PH1", 1000000.0, None, 149011.611))
def test_record_power_rail_energy_update(self):
"""Test updating power rail energy (second call in post)"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
# First call (prep) - INSERT
self.db.record_power_rail_energy("CPU_VDDCR_PH1", 1000000.0, 149011.611)
# Second call (post) - UPDATE
self.db.record_power_rail_energy("CPU_VDDCR_PH1", 1050000.0, 149011.611)
cur = self.db.db.cursor()
cur.execute(
"SELECT label, e0, e1, scale FROM power_rails WHERE t0=?",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
result = cur.fetchone()
self.assertEqual(result, ("CPU_VDDCR_PH1", 1000000.0, 1050000.0, 149011.611))
def test_record_multiple_power_rails(self):
"""Test recording multiple power rails per cycle"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
# Record multiple rails
rails = [
("CPU_VDDCR_PH1", 1000000.0, 1050000.0, 149011.611),
("CPU_VDDCR_PH2", 2000000.0, 2100000.0, 149011.611),
("VDDIO", 3000000.0, 3150000.0, 23751.3),
]
for label, e0, e1, scale in rails:
self.db.record_power_rail_energy(label, e0, scale)
self.db.record_power_rail_energy(label, e1, scale)
cur = self.db.db.cursor()
cur.execute(
"SELECT label, e0, e1, scale FROM power_rails WHERE t0=? ORDER BY label",
(int(timestamp.strftime("%Y%m%d%H%M%S")),),
)
results = cur.fetchall()
self.assertEqual(len(results), 3)
self.assertEqual(results[0], ("CPU_VDDCR_PH1", 1000000.0, 1050000.0, 149011.611))
self.assertEqual(results[1], ("CPU_VDDCR_PH2", 2000000.0, 2100000.0, 149011.611))
self.assertEqual(results[2], ("VDDIO", 3000000.0, 3150000.0, 23751.3))
def test_report_power_rails(self):
"""Test reporting power rails"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
self.db.record_power_rail_energy("CPU_VDDCR_PH1", 1000000.0, 149011.611)
self.db.record_power_rail_energy("CPU_VDDCR_PH1", 1050000.0, 149011.611)
result = self.db.report_power_rails(timestamp)
self.assertEqual(
result,
[
(
int(timestamp.strftime("%Y%m%d%H%M%S")),
"CPU_VDDCR_PH1",
1000000.0,
1050000.0,
149011.611,
)
],
)
def test_report_power_rails_no_data(self):
"""Test reporting power rails when no data exists"""
timestamp = datetime.now()
self.db.start_cycle(timestamp)
result = self.db.report_power_rails(timestamp)
self.assertEqual(result, [])
def test_default_db_path_uses_var_lib_restrictive(self):
"""Test the default database path is created securely in /var/lib"""
with patch("amd_debug.database.os.makedirs") as makedirs, patch(
"amd_debug.database.os.path.exists", return_value=False
), patch("amd_debug.database.sqlite3.connect", return_value=MagicMock()):
SleepDatabase()
# Directory is created in /var/lib with a restrictive mode
makedirs.assert_called_once_with(
"/var/lib/amd-s2idle", mode=0o700, exist_ok=True
)
# The insecure /var/local fallback is never referenced
for call in makedirs.call_args_list:
for arg in call.args:
self.assertNotIn("/var/local", str(arg))
def test_schema_migration_v1_to_v2(self):
"""Test database migration from schema v1 to v2"""
# Create a new database (will be at v2)
db = SleepDatabase(dbf=":memory:")
cur = db.db.cursor()
# Verify power_rails table exists
cur.execute(
"SELECT name FROM sqlite_master WHERE type='table' AND name='power_rails'"
)
result = cur.fetchone()
self.assertIsNotNone(result)
self.assertEqual(result[0], "power_rails")
# Verify schema version is 2
cur.execute("PRAGMA user_version")
version = cur.fetchone()[0]
self.assertEqual(version, 2)