Merge the latest changes.

source/includes/device.h

@@ -1,24 +1,52 @@
-/*
+/*******************************************************************************
  * NewOswan
  * device.h: 
  *
  * Created by Manoël Trapier on 19/12/2021.
- * Copyright (c) 2014-2021 986-Studio. All rights reserved.
+ * Copyright (c) 2014-2022 986-Studio. All rights reserved.
  *
+ ******************************************************************************/
+
+#ifndef __DEVICE_H__
+#define __DEVICE_H__
+
+#include <stdint.h>
+
+/***
+ * Ticks are the fasted clock in the system
+ * Each device which need to be clocked use a multiple of the tick
+ * number as their own clock.
  */
+typedef uint64_t tick_t
 
-#ifndef NEWOSWAN_DEVICE_H
-#define NEWOSWAN_DEVICE_H
-
-typedef void (*device_init)(void);
+typedef void (*device_init)(uint8_t baseAddress, void *param);
 typedef void (*device_reset)(void);
 typedef void (*device_free)(void);
+typedef void (*device_update)(tick_t ticks);
+
+typedef enum device_type_t
+{
+    DT_INTERRUPT_CONTROLLER,
+    DT_GPU,
+    DT_BUTTONS,
+    DT_DMA,
+    DT_LUXOR,
+    DT_AUDIO,
+    DT_SYSTEM,
+    DT_RTC,
+    DT_RS232,
+    DT_EEPROM,
+    DT_DEBUG,
+} device_type_t;
 
 typedef struct device_t
 {
-    device_init *init;
-    device_reset *reset;
-    device_free *free;
+    device_init init;           /***< Function called to init the device   - Non optional */
+    device_update update;       /***< Function called on updates - Optional */
+    device_reset reset;         /***< Function called to reset the device  - Optional */
+    device_free free;           /***< Function called to deinit the device - Optional */
+    device_type_t deviceType;   /***< Used to tell the type of device, could be useful to pass the
+                                 * right parameters to init                - Non optional */
 } device_t;
 
-#endif /* NEWOSWAN_DEVICE_H */
+#endif /* __DEVICE_H__ */