chipsec-chipsec/chipsec/modules/common/rtclock.py

# CHIPSEC: Platform Security Assessment Framework
# Copyright (c) 2010-2022, Intel Corporation
#
# This program 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.
#
# This program 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 this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
#
# Contact information:
# chipsec@intel.com
#

"""
Checks for RTC memory locks.
Since we do not know what RTC memory will be used for on a specific platform, we return WARNING (rather than FAILED) if the memory is not locked.

Usage:
    ``chipsec_main -m common.rtclock [-a modify]``

    - ``-a modify``: Attempt to modify CMOS values

Examples:
    >>> chipsec_main.py -m common.rtclock
    >>> chipsec_main.py -m common.rtclock -a modify

Registers used:
    - RC.LL
    - RC.UL

.. NOTE::
    - This module will only run on Core platforms
"""

from chipsec.library.exceptions import CSReadError
from chipsec.module_common import BaseModule, BIOS, HWCONFIG
from chipsec.library.returncode import ModuleResult
from chipsec.hal.common.cmos import CMOS
# from chipsec.config import CHIPSET_CODE_AVN
from typing import List

TAGS = [BIOS, HWCONFIG]
METADATA_TAGS = ['OPENSOURCE', 'IA', 'COMMON', 'RTCLOCK']


class rtclock(BaseModule):

    def __init__(self):
        BaseModule.__init__(self)
        self.cmos = CMOS(self.cs)
        self.user_request = False
        self.test_offset = 0x38
        self.test_value = 0xAA
        self.cs.set_scope({
            "RC": "8086.RTC",
        })

    def is_supported(self) -> bool:
        if self.cs.is_core(): #or (self.cs.Cfg.get_chipset_code() == CHIPSET_CODE_AVN):
            if self.cs.register.is_defined('RC'):
                return True
            self.logger.log_important('RC register not defined for platform.  Skipping module.')
        else:
            self.logger.log_important('Not a Core platform.  Skipping check.')
        return False

    def check_rtclock(self) -> int:
        ll = ul = False
        rc_list = self.cs.register.get_list_by_name('RC')
        res = ModuleResult.FAILED
        for rc in rc_list:
            try:
                check_config_regs = rc.read() != 0xFFFFFFFF
            except CSReadError as err:
                check_config_regs = False
                self.logger.log_debug(f'Error reading RC register: {err}')

            if check_config_regs:
                rc.print()
                ll = rc.is_all_field_value(1, 'LL')
                ul = rc.is_all_field_value(1, 'UL')
            elif self.user_request:
                self.logger.log_important('Writing to CMOS to determine write protection (original values will be restored)')

                original_val = self.cmos.read_cmos_low(self.test_offset)
                self.cmos.write_cmos_low(self.test_offset, original_val ^ self.test_value)
                if original_val == self.cmos.read_cmos_low(self.test_offset):
                    ll = True
                else:
                    self.logger.log_important('Restoring original value')
                    self.cmos.write_cmos_low(self.test_offset, original_val)

                original_val = self.cmos.read_cmos_high(self.test_offset)
                self.cmos.write_cmos_high(self.test_offset, original_val ^ self.test_value)
                if original_val == self.cmos.read_cmos_high(self.test_offset):
                    ul = True
                else:
                    self.logger.log_important('Restoring original value')
                    self.cmos.write_cmos_high(self.test_offset, original_val)
            else:
                self.logger.log_important('Unable to test lock bits without attempting to modify CMOS.')
                self.logger.log('[*] Run chipsec_main manually with the following commandline flags.')
                self.logger.log('[*] python chipsec_main -m common.rtclock -a modify')
                self.result.setStatusBit(self.result.status.VERIFY)
                return self.result.getReturnCode(ModuleResult.WARNING)

            if ll:
                self.logger.log_good('Protected bytes (0x38-0x3F) in low 128-byte bank of RTC memory are locked')
            else:
                self.logger.log_bad('Protected bytes (0x38-0x3F) in low 128-byte bank of RTC memory are not locked')
            if ul:
                self.logger.log_good('Protected bytes (0x38-0x3F) in high 128-byte bank of RTC memory are locked')
            else:
                self.logger.log_bad('Protected bytes (0x38-0x3F) in high 128-byte bank of RTC memory are not locked')

            if ll and ul:
                res = ModuleResult.PASSED
                self.logger.log_passed('Protected locations in RTC memory are locked')
            else:
                res = ModuleResult.WARNING
                self.result.setStatusBit(self.result.status.POTENTIALLY_VULNERABLE)
                self.logger.log_warning('Protected locations in RTC memory are accessible (BIOS may not be using them)')

        return self.result.getReturnCode(res)

    def run(self, module_argv: List[str]) -> int:
        self.logger.start_test('Protected RTC memory locations')

        if len(module_argv) >= 1:
            if module_argv[0].lower() == 'modify':
                self.user_request = True
        self.res = self.check_rtclock()
        return self.res