Nothing Special   »   [go: up one dir, main page]

Skip to content

Implementation of ACPI embedded controller specification to access the EC's RAM

License

Notifications You must be signed in to change notification settings

Soberia/EmbeddedController

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📋 How to use

You can either copy the source code directly to your project or using compiled Dynamic-Link Library (DLL) version. You need to compile your app with c++17 flag or newer versions. This app uses WinRing0 driver to access the hardware, make sure you place WinRing0x64.sys or WinRing0.sys beside your binary files. Your program has to run with administrator privileges to work properly.

Include ec.hpp header file and initialize an object from EmbeddedController class.

#include <iostream>
#include <windows.h>

#include "ec.hpp"

int main()
{
    EmbeddedController ec = EmbeddedController();

    // Making sure driver file loaded successfully
    if (ec.driverFileExist && ec.driverLoaded)
    {
        // Your rest of code palces in here
        // ...

        // Free up the resources at the end
        ec.close();
    }

}

Public Methods

  • EmbeddedController(BYTE scPort = EC_SC, BYTE dataPort = EC_DATA, BYTE endianness = LITTLE_ENDIAN, UINT16 retry = 5, UINT16 timeout = 100)
    If read or write operations often fails, you should increase the retry and timeout values.

    • scPort: Embedded Controller Status/Command port, default value is 0x66
    • dataPort: Embedded Controller Data port, default value is 0x62
    • endianness: Byte order of read and write operations, could be LITTLE_ENDIAN or BIG_ENDIAN, default value is LITTLE_ENDIAN
    • retry: Number of retires for failed read or write operations, default value is 5
    • timeout: Waiting threshold for reading EC's OBF and IBF flags, default value is 100
  • VOID close()
    Close the driver resources

  • EC_DUMP dump()
    Generate a map object of all registers
    return: map object of register's address and value

    EC_DUMP dump = ec.dump();
    BYTE value = dump.find(0x20)->second; // Accessing value of 0x20 register
  • VOID printDump()
    Print generated dump of all registers

  • VOID saveDump(std::string output = "dump.bin")
    Store generated dump of all registers to the disk
    output: Path of output file, default is in the current directory

  • BYTE readByte(BYTE bRegister)
    Read EC register as BYTE
    bRegister: Address of register
    return: Value of register

    BYTE value = ec.readByte(0x20);
    std::cout << std::hex << (INT)value; // Print value of register 0x20
  • WORD readWord(BYTE bRegister)
    Read EC register as WORD
    bRegister: Address of register
    return: Value of register

    WORD value = ec.readWord(0x20);
    std::cout << std::hex << (INT)value; // Print value of register 0x20 and 0x21 in Little Endian byte order
  • DWORD readDword(BYTE bRegister)
    Read EC register as DWORD
    bRegister: Address of register
    return: Value of register

    ec.endianness = BIG_ENDIAN;
    DWORD value = ec.readDword(0x20);
    std::cout << std::hex << (INT)value; // Print value of register 0x20, 0x21, 0x22 and 0x23 in Big Endian byte order
  • BOOL writeByte(BYTE bRegister, BYTE value)
    Write EC register as BYTE
    bRegister: Address of register
    value: Value of register
    return: TRUE if the opreation was successful, FALSE otherwise

    ec.writeByte(0x20, 0xAA); // Write 0xAA to register 0x20
  • BOOL writeWord(BYTE bRegister, WORD value)
    Write EC register as WORD
    bRegister: Address of register
    value: Value of register
    return: TRUE if the opreation was successful, FALSE otherwise

    // Write 0xBB to register 0x20 and 0xAA to register 0x21 in Little Endian byte order
    ec.writeWord(0x20, 0xAABB);
  • BOOL writeDword(BYTE bRegister, DWORD value)
    Write EC register as DWORD
    bRegister: Address of register
    value: Value of register
    return: TRUE if the opreation was successful, FALSE otherwise

    // Write 0xAA to register 0x20, 0xBB to register 0x21, 0xCC to register 0x22
    // and 0xDD to register 0x23 in Big Endian byte order
    ec.endianness = BIG_ENDIAN;
    ec.writeDword(0x20, 0xAABBCCDD);

⚠️ Disclaimer

Author of this software is not responsible for damage of any kind, use it at your own risk!