162. Abstract Communication Driver

In embedded firmware systems, communication peripherals such as UART and SPI are often accessed through a common abstract interface. This allows higher-level modules to interact with different hardware drivers without changing application logic.

In this problem, you will implement an abstract communication driver using Embedded C++ concepts.

You are given a base class CommDriver. Your task is to declare two pure virtual member functions in this class:

  • send(const string& data)
  • receive() → returns string

Two derived classes, UartDriver and SpiDriver, already implement these functions.

The program will:

  1. Read a driver type ("UART" or "SPI")
  2. Read a message (single word, no spaces)
  3. Create the appropriate driver object
  4. Send the message
  5. Print the value returned by receive()

This exercise focuses on abstract base classes, pure virtual functions, and runtime polymorphism, which are commonly used in embedded HAL (Hardware Abstraction Layer) design.

Input / Output Specification:

Input

  • A single line containing:
    • type"UART" or "SPI"
    • message → non-empty, single-word string (no spaces)

Output

  • Two lines:
    1. <TYPE> SEND: <message>
    2. <TYPE> RECV: <message>

Example:

Input:

UART Hello

Output:

UART SEND: Hello 
UART RECV: Hello

Constraints & Assumptions:

  • Driver type is always valid
  • Message length ≥ 1
  • Message contains no whitespace
  • This is a host-based simulation of firmware behavior

 

 

 

Need Help? Refer to the Quick Guide below

Abstraction is the process of exposing only the essential features of an object while hiding the complex implementation details ("the wiring") from the user.

Think of a Car:

  • Abstraction (Interface): Steering wheel, pedals, gear stick. (What the user sees).
  • Implementation (Hidden Details): Fuel injection timing, combustion cycles, differential gears. (What happens inside).

In C++, we achieve this using Access Specifiers (public/private) and Abstract Classes (Interfaces).

Syntax & Usage

1. Data Abstraction (The Public API)

Designing a class where the user sees simple functions, but the complex logic happens privately.

class WiFiModule {
private:
    // Complex hidden details (User doesn't need to see these)
    void spi_write(uint8_t byte) { /* ... */ }
    void handshake_tcp() { /* ... */ }
    int socket_id;

public:
    // Simple Abstraction (User sees only this)
    void connect(const char* ssid, const char* pass) {
        spi_write(0x01); // Internal logic
        handshake_tcp(); // Internal logic
    }
};

int main() {
    WiFiModule wifi;
    // The user calls one simple function.
    // They don't know (or care) that it triggered 50 SPI transactions.
    wifi.connect("HomeNet", "1234");
}

2. Abstract Classes (Pure Interfaces)

Defining a blueprint that enforces what a device must do, without defining how.

// Abstract Base Class
class IMotor {
public:
    virtual void setSpeed(int speed) = 0; // Pure Virtual
    virtual void stop() = 0;
};

// The user code works with the "IMotor" abstraction,
// ignoring whether it's a DC Motor or Stepper Motor.
void emergency_shutdown(IMotor* m) {
    m->stop();
}

Abstraction vs. Encapsulation

These two are often confused but are distinct.

FeatureEncapsulationAbstraction
FocusInformation Hiding.Implementation Hiding.
GoalProtect data from external corruption.Reduce complexity for the user.
MechanismGetters/Setters, private variables.Interfaces, Abstract Classes.
AnalogyThe plastic casing around a wire.The simple "On/Off" switch.

Relevance in Embedded/Firmware

1. HAL (Hardware Abstraction Layer)

This is the textbook definition of abstraction in firmware.

You write code like GPIO_Write(PIN_5, HIGH).

  • Abstraction: "Set Pin 5 High".
  • Implementation: On AVR, this writes to PORTB. On STM32, it writes to BSRR register. On Linux, it writes to a file /sys/class/gpio. Your application logic relies on the abstraction, making it portable.

2. Reducing Cognitive Load

A Junior Developer can use a complex driver (e.g., a FAT32 filesystem wrapper) by just calling file.open() and file.write(). They don't need to understand sectors, clusters, or allocation tables to use it effectively.

Common Pitfalls (Practical Tips)

PitfallDetails
❌ Leaky Abstractions

When implementation details "leak" out.

Example: A generic Motor class having a function setStepperMicrosteps(). This breaks the abstraction because not all motors are steppers.

❌ Over-AbstractionCreating wrappers around wrappers (Driver -> Hal -> LL -> Register). Too many layers add overhead and make debugging harder ("Spaghetti Code"). Keep it flat where possible.
✅ Design from the User's ViewWhen writing a class, write the main() code first (how you want to use it). Then implement the class to match that simple API.