rrcSmall/src/ImageFormat.h
2020-12-17 20:01:57 +01:00

320 lines
10 KiB
C++

/*****************************************************************************
* Copyright (c) 2020, rrcSmall FM10K-Documentation Contributors
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of the copyright holder nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*****************************************************************************/
#pragma once
#include <utility>
#include <vector>
#include <cstdint>
#include <unordered_map>
class ImageFormat{
public:
class AnalysisState{
public:
std::unordered_map<uint32_t, uint32_t> memory;
uint32_t previous;
uint32_t current;
AnalysisState(uint32_t initial) : current(initial), previous(0){
}
AnalysisState(const AnalysisState& oldState) : current(oldState.current), previous(oldState.previous), memory(oldState.memory){
}
bool operator==(const AnalysisState &other) const{
return current == other.current && memory == other.memory;
}
void setRegister(uint32_t addr, uint32_t value){
memory[addr] = value;
}
uint32_t getRegister(uint32_t addr) const{
return memory.find(addr) == memory.end() ? 0 : memory.at(addr);
}
uint32_t getAddressOffset(uint8_t offsetEntry) const;
};
class Instruction{
public:
Instruction(){
}
Instruction(const Instruction& instruction) : address(instruction.address), endAddress(instruction.endAddress), command(instruction.command), parameters(instruction.parameters){
}
enum class KnownRegisters : uint32_t {
FATAL_CODE = 0x0,
LAST_FATAL_CODE = 0x1,
SOFT_RESET = 0x3,
DEVICE_CFG = 0x4,
RESET_CFG = 0x5,
WATCHDOG_CFG = 0x6,
MGMT_SCRATCH_0 = 0x8,
MGMT_SCRATCH_1 = MGMT_SCRATCH_0 + 1,
VITAL_PRODUCT_DATA = 0x304,
GLOBAL_INTERRUPT_DETECT = 0x400,
INTERRUPT_MASK_BSM = 0x442,
CHIP_VERSION = 0x452,
BSM_SCRATCH_START = 0x800,
BSM_SCRATCH_END = BSM_SCRATCH_START + 0x400 - 1,
BSM_ARGS = 0x000C01,
BSM_ADDR_OFFSET_0 = 0x000C04,
BSM_ADDR_OFFSET_1 = BSM_ADDR_OFFSET_0 + 1,
BSM_ADDR_OFFSET_2 = BSM_ADDR_OFFSET_0 + 2,
BSM_ADDR_OFFSET_3 = BSM_ADDR_OFFSET_0 + 3,
BSM_COUNTER_0 = 0x000C08,
BSM_COUNTER_1 = BSM_COUNTER_0 + 1,
BIST_CTRL = 0x000C10,
REI_CTRL = 0x000C12,
REI_STAT = 0x000C13,
GPIO_CFG = 0x000C15,
GPIO_DATA = 0x000C16,
GPIO_IP = 0x000C17,
GPIO_IM = 0x000C18,
PLL_PCIE_CTRL = 0x2241,
PLL_PCIE_STAT = 0x2242,
SBUS_PCIE_CFG = 0x2243,
SBUS_PCIE_COMMAND = 0x2244,
SBUS_PCIE_REQUEST = 0x2245,
SBUS_PCIE_RESPONSE = 0x2246,
SBUS_PCIE_SPICO_IN = 0x2247,
SBUS_PCIE_SPICO_OUT = 0x2248,
SBUS_PCIE_IP = 0x2249,
SBUS_PCIE_IM = 0x224a,
PCIE_XPLL_CTRL = 0x3000,
PCIE_CLK_CTRL = 0x3001,
PCIE_CLK_CTRL_2 = 0x3002,
PCIE_CLKMON_RATIO_CFG = 0x3003,
PCIE_CLKMON_TOLERANCE_CFG = 0x3004,
PCIE_CLKMON_DEADLINES_CFG = 0x3005,
PCIE_CLK_STAT = 0x3006,
PCIE_CLK_IP = 0x3007,
PCIE_CLK_IM = 0x3008,
PCIE_WARM_RESET_DELAY = 0x3009,
PORTS_MGMT_BASE_ADDRESS = 0xE8000,
PLL_EPL_CTRL = PORTS_MGMT_BASE_ADDRESS + 0x0,
PLL_EPL_STAT = PORTS_MGMT_BASE_ADDRESS + 0x1,
PLL_FABRIC_CTRL = PORTS_MGMT_BASE_ADDRESS + 0x2,
PLL_FABRIC_STAT = PORTS_MGMT_BASE_ADDRESS + 0x3,
PLL_FABRIC_LOCK = PORTS_MGMT_BASE_ADDRESS + 0x4,
SBUS_EPL_CFG = PORTS_MGMT_BASE_ADDRESS + 0x5,
SBUS_EPL_COMMAND = PORTS_MGMT_BASE_ADDRESS + 0x6,
SBUS_EPL_REQUEST = PORTS_MGMT_BASE_ADDRESS + 0x7,
SBUS_EPL_RESPONSE = PORTS_MGMT_BASE_ADDRESS + 0x8,
SBUS_EPL_SPICO_IN = PORTS_MGMT_BASE_ADDRESS + 0x9,
SBUS_EPL_SPICO_OUT = PORTS_MGMT_BASE_ADDRESS + 0xa,
SBUS_EPL_IP = PORTS_MGMT_BASE_ADDRESS + 0xb,
SBUS_EPL_IM = PORTS_MGMT_BASE_ADDRESS + 0xc,
PM_CLKOBS_CTRL = PORTS_MGMT_BASE_ADDRESS + 0x12,
PCIE_PF_BASE_ADDRESS = 0x100000,
NOP = 0xFFFFFFFF
};
static std::string getAddressRegisterName(uint32_t addr){
return getRegisterName(static_cast<KnownRegisters>(addr));
}
static std::string getRegisterName(KnownRegisters addr);
enum class Command : uint8_t {
WRITE = 0,
COPY,
LOAD,
INIT,
CALC,
CALC_IMM,
BRANCH,
POLL,
LOOP,
JUMP,
RETURN,
SET,
WAIT,
END,
NOP = 0xFF
};
uint32_t address;
uint32_t endAddress;
uint32_t command;
std::vector<uint32_t> parameters;
static Instruction fromBytes(uint32_t offset, const std::vector<uint8_t>& bytes);
Instruction(uint32_t address, uint32_t command, std::vector<uint32_t> parameters) : address(address), command(command), parameters(std::move(parameters)), endAddress(0){
}
std::string toString() const;
std::vector<uint32_t> getPossibleBranches() const;
std::vector<std::pair<uint32_t, std::unordered_map<uint32_t, uint32_t>>> execute(AnalysisState& state) const;
Command getCommand() const{
if(((command >> 6) & 0b11) == 0b00){
return Command::WRITE;
}else if(((command >> 6) & 0b11) == 0b01){
return Command::COPY;
}else if(((command >> 3) & 0b11111) == 0b11000){
return Command::LOAD;
}else if(((command >> 3) & 0b11111) == 0b11001){
return Command::INIT;
}else if(((command >> 5) & 0b111) == 0b100){
return Command::CALC;
}else if(((command >> 5) & 0b111) == 0b101){
return Command::CALC_IMM;
}else if(((command >> 3) & 0b11111) == 0b11010){
return Command::BRANCH;
}else if(((command >> 3) & 0b11111) == 0b11011){
return Command::POLL;
}else if(((command >> 1) & 0b1111111) == 0b1110000){
return Command::LOOP;
}else if(command == 0b11101000){
return Command::JUMP;
}else if(((command >> 2) & 0b111111) == 0b111100){
return Command::RETURN;
}else if(((command >> 2) & 0b111111) == 0b111110){
return Command::SET;
}else if(command == 0xFE){
return Command::WAIT;
}else if(command == 0xFF){
return Command::END;
}
return Command::NOP;
}
};
enum class HeaderSpeed : uint8_t {
SPEED_390_KHZ = 0,
SPEED_780_KHZ,
SPEED_1560_KHZ,
SPEED_3125_KHZ,
SPEED_6250_KHZ,
SPEED_12500_KHZ,
SPEED_25000_KHZ,
SPEED_50000_KHZ
};
enum class HeaderMode : uint8_t {
MODE_SINGLE = 0,
MODE_DUAL,
MODE_QUAD,
MODE_SINGLE_FAST
};
static ImageFormat fromBytes(const std::vector<uint8_t>& image, bool prefetchInitialZone = false);
void decodeInstructionsAt(const std::vector<uint32_t>& offset);
void decodeAnalyzeInstructionsAt(uint32_t offset);
const Instruction* findInstructionByAddress(uint32_t addr){
for(const auto& instruction : instructions){
if((instruction.endAddress == 0 && addr == instruction.address ) || (instruction.endAddress != 0 && addr >= instruction.address && addr < instruction.endAddress)){
return &instruction;
}
}
return nullptr;
}
ImageFormat(){
}
const auto& getHeader() const{
return header;
}
const auto& getInstructions() const{
return instructions;
}
const auto& getBaseImage() const{
return baseImage;
}
const auto& getBootConfig() const{
return bootConfig;
}
private:
struct {
uint8_t reserved : 3;
ImageFormat::HeaderSpeed speed : 3;
ImageFormat::HeaderMode mode : 2;
uint32_t baseAddress : 24;
} header;
static const int CFG_HEADER = 0x4 << 2;
static const int CFG_LENGTH = 16;
struct {
uint8_t length : 8;
uint32_t base : 24;
} cfgHeader;
struct {
uint8_t fileFormat : 8;
uint8_t version : 8;
uint16_t length : 16;
} cfg;
std::vector<std::string> bootConfig;
std::vector<Instruction> instructions;
std::vector<uint8_t> baseImage;
};