mirror of
https://github.com/livingcomputermuseum/UniBone.git
synced 2026-01-31 05:42:56 +00:00
974aeed8eb
Interrupt and DMA system now handles multiple levels and multiple devices in parallel Interrupt Register changes synced with INTR transaction DL11 and KW11 clock pass the ZDLDI0 diagnostic. Devices can now be enabled and disabled individually.
135 lines
4.8 KiB
C++
135 lines
4.8 KiB
C++
/* device.hpp - abstract base class for devices
|
|
|
|
Copyright (c) 2018, Joerg Hoppe
|
|
j_hoppe@t-online.de, www.retrocmp.com
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files (the "Software"),
|
|
to deal in the Software without restriction, including without limitation
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
|
Software is furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
JOERG HOPPE BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
|
|
12-nov-2018 JH entered beta phase
|
|
*/
|
|
#ifndef _DEVICE_HPP_
|
|
#define _DEVICE_HPP_
|
|
|
|
#include <string>
|
|
#include <list>
|
|
#include <vector>
|
|
#include <mutex>
|
|
using namespace std;
|
|
|
|
#include "utils.hpp"
|
|
#include "parameter.hpp"
|
|
#include "logsource.hpp"
|
|
|
|
// instance of a worker thread for a device
|
|
class device_c;
|
|
class device_worker_c {
|
|
public:
|
|
// thread for this worker instance
|
|
device_c *device; // link to parent
|
|
unsigned instance; // id of this running instance
|
|
pthread_t pthread;bool running; // run state
|
|
};
|
|
|
|
// abstract unibus device
|
|
// maybe mass storage controller, storage drive or other device
|
|
// sets device register values depending on internal status,
|
|
// reacts on register read/write over UNIBUS by evaluation of PRU events.
|
|
class device_c: public logsource_c, public parameterized_c {
|
|
private:
|
|
void workers_start(void);
|
|
void workers_stop(void);
|
|
|
|
public:
|
|
// the class holds a list of pointers to instantiated devices
|
|
// also needed to have a list of threads
|
|
static list<device_c *> mydevices;
|
|
|
|
device_c *parent; // example: storagedrive_c.parent is storage-controller
|
|
|
|
// name of instance: "RL3"
|
|
parameter_string_c name = parameter_string_c(NULL, "name", "name", /*readonly*/
|
|
true, "Unique identifier of device");
|
|
// name of type: "RL02". normally readonly.
|
|
parameter_string_c type_name = parameter_string_c(NULL, "type", "type", /*readonly*/
|
|
true, "Type");
|
|
// NULL: do not link params to this device automatically over param constructor
|
|
|
|
// "enabled": controls device installation to PRU and worker() state.
|
|
parameter_bool_c enabled = parameter_bool_c(NULL, "enabled", "en", true,
|
|
"device installed and ready to use?");
|
|
|
|
parameter_unsigned_c emulation_speed = parameter_unsigned_c(NULL, "emulation_speed", "es",
|
|
false, "", "%d", "1 = original speed, > 1: mechanics is this factor faster", 8, 10);
|
|
// 1 = original speed, > 1: mechanics is this factor faster
|
|
|
|
parameter_unsigned_c verbosity = parameter_unsigned_c(NULL, "verbosity", "v", false, "",
|
|
"%d", "1 = fatal, 2 = error, 3 = warning, 4 = info, 5 = debug", 8, 10);
|
|
|
|
// make data exchange with worker atomic
|
|
// std::mutex worker_mutex;
|
|
|
|
// scheduler settings for worker thread
|
|
int worker_sched_policy;
|
|
int worker_sched_priority;
|
|
|
|
enum worker_priority_e {
|
|
none_rt, // lower than all RT priorities
|
|
rt_device, // all controller and storage worker
|
|
rt_max // 100% CPU, uninterruptable
|
|
};
|
|
void worker_init_realtime_priority(enum worker_priority_e priority);
|
|
void worker_boost_realtime_priority(void);
|
|
void worker_restore_realtime_priority(void);
|
|
|
|
device_c(void);
|
|
virtual ~device_c(); // class with virtual functions should have virtual destructors
|
|
void set_workers_count(unsigned workers_count);
|
|
|
|
virtual bool on_param_changed(parameter_c *param);
|
|
|
|
// search in mydevices
|
|
static device_c *find_by_name(char *name);
|
|
|
|
// a device can be powered down. use this to define power-up values
|
|
volatile bool power_down;
|
|
virtual void on_power_changed(void) = 0; // reset device, UNIBUS DC_LO
|
|
|
|
// every device has a INIT signal, which can be active (asserted) or inactive
|
|
// set/release device from INIT state
|
|
volatile bool init_asserted;
|
|
virtual void on_init_changed(void) = 0; // reset device, like UNIBUS INIT
|
|
|
|
// worker threads: multiple instances of single worker() are running in parallel
|
|
// device must implement a worker(instance) {
|
|
// switch((instance) { ... } }
|
|
// 'instance' from 0 .. worker_count-1
|
|
volatile bool workers_terminate; // cmd flag to all worker() instances
|
|
|
|
vector<device_worker_c> workers;
|
|
|
|
// default background worker function for devices without need.
|
|
virtual void worker(unsigned instance) {
|
|
UNUSED(instance);
|
|
printf("Warning: default device_c::worker() called, better use set_worker_count(0) ");
|
|
}
|
|
};
|
|
|
|
#endif
|
|
|