2021-02-11 02:24:31 +00:00
|
|
|
//
|
|
|
|
// Bus.hpp
|
|
|
|
// Clock Signal
|
|
|
|
//
|
|
|
|
// Created by Thomas Harte on 10/02/2021.
|
|
|
|
// Copyright © 2021 Thomas Harte. All rights reserved.
|
|
|
|
//
|
|
|
|
|
|
|
|
#ifndef Bus_hpp
|
|
|
|
#define Bus_hpp
|
|
|
|
|
|
|
|
#include "../../../ClockReceiver/ClockReceiver.hpp"
|
|
|
|
|
|
|
|
#include <bitset>
|
|
|
|
#include <cstddef>
|
|
|
|
#include <vector>
|
|
|
|
|
|
|
|
namespace Apple {
|
|
|
|
namespace ADB {
|
|
|
|
|
2021-02-11 02:39:33 +00:00
|
|
|
struct Command {
|
|
|
|
enum class Type {
|
|
|
|
Reset,
|
|
|
|
Flush,
|
|
|
|
Reserved,
|
|
|
|
Listen,
|
|
|
|
Talk
|
|
|
|
};
|
|
|
|
const Type type = Type::Reserved;
|
|
|
|
const uint8_t device = 0xff;
|
|
|
|
const uint8_t reg = 0xff;
|
|
|
|
|
|
|
|
Command() {}
|
|
|
|
Command(Type type) : type(type) {}
|
|
|
|
Command(Type type, uint8_t device) : type(type), device(device) {}
|
|
|
|
Command(Type type, uint8_t device, uint8_t reg) : type(type), device(device), reg(reg) {}
|
|
|
|
};
|
|
|
|
|
|
|
|
/*!
|
|
|
|
@returns The @c Command encoded in @c code.
|
|
|
|
*/
|
|
|
|
inline Command decode_command(uint8_t code) {
|
|
|
|
switch(code & 0x0f) {
|
|
|
|
default: return Command();
|
|
|
|
|
|
|
|
case 0: return Command(Command::Type::Reset);
|
|
|
|
case 1: return Command(Command::Type::Flush, code >> 4);
|
|
|
|
|
|
|
|
case 8: case 9: case 10: case 11:
|
|
|
|
return Command(Command::Type::Listen, code >> 4, code & 3);
|
|
|
|
|
|
|
|
case 12: case 13: case 14: case 15:
|
|
|
|
return Command(Command::Type::Talk, code >> 4, code & 3);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-02-11 02:24:31 +00:00
|
|
|
/*!
|
|
|
|
The ADB bus models the data line of the ADB bus; it allows multiple devices to
|
|
|
|
post their current data level, or read the current level, and also offers a tokenised
|
|
|
|
version of all activity on the bus.
|
|
|
|
*/
|
|
|
|
class Bus {
|
|
|
|
public:
|
|
|
|
Bus(HalfCycles clock_speed);
|
|
|
|
|
2021-02-11 02:28:32 +00:00
|
|
|
/*!
|
|
|
|
Advances time; ADB is a clocked serial signal.
|
|
|
|
*/
|
2021-02-11 02:24:31 +00:00
|
|
|
void run_for(HalfCycles);
|
|
|
|
|
2021-02-11 02:28:32 +00:00
|
|
|
/*!
|
|
|
|
Adds a device to the bus, returning the index it should use
|
|
|
|
to refer to itself in subsequent calls to set_device_output.
|
|
|
|
*/
|
2021-02-11 02:24:31 +00:00
|
|
|
size_t add_device();
|
|
|
|
|
2021-02-11 02:28:32 +00:00
|
|
|
/*!
|
|
|
|
Sets the current data line output for @c device.
|
|
|
|
*/
|
2021-02-11 02:24:31 +00:00
|
|
|
void set_device_output(size_t device, bool output);
|
|
|
|
|
2021-02-11 02:28:32 +00:00
|
|
|
/*!
|
|
|
|
@returns The current state of the ADB data line.
|
|
|
|
*/
|
2021-02-11 02:24:31 +00:00
|
|
|
bool get_state() const;
|
|
|
|
|
|
|
|
enum class Event {
|
|
|
|
Reset,
|
|
|
|
Attention,
|
|
|
|
Byte,
|
|
|
|
ServiceRequest,
|
|
|
|
|
|
|
|
Unrecognised
|
|
|
|
};
|
|
|
|
|
|
|
|
struct Observer {
|
|
|
|
/// Reports to an observer that @c event was observed in the activity
|
2021-02-11 02:28:32 +00:00
|
|
|
/// observed on this bus. If this was a byte event, that byte's value is given as @c value.
|
2021-02-11 02:24:31 +00:00
|
|
|
virtual void adb_bus_did_observe_event(Bus *, Event event, uint8_t value = 0xff);
|
|
|
|
};
|
|
|
|
/*!
|
|
|
|
Adds an observer.
|
|
|
|
*/
|
|
|
|
void add_observer(Observer *);
|
|
|
|
|
|
|
|
private:
|
|
|
|
HalfCycles time_in_state_;
|
|
|
|
double half_cycles_to_microseconds_ = 1.0;
|
|
|
|
std::vector<Observer *> observers_;
|
|
|
|
unsigned int shift_register_ = 0;
|
|
|
|
bool data_level_ = true;
|
|
|
|
|
|
|
|
// ADB addressing supports at most 16 devices but that doesn't include
|
|
|
|
// the controller. So assume a maximum of 17 connected devices.
|
|
|
|
std::bitset<17> bus_state_{0xffffffff};
|
|
|
|
size_t next_device_id_ = 0;
|
|
|
|
|
|
|
|
inline void shift(unsigned int);
|
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif /* Bus_hpp */
|