universalisos/kernel/drivers/i2c.h
Fábio Coutada 9540b0528c feat(universalisos): PikeOS-style Phase B/C device drivers + Phase D microkernel
Phase B (Core Device Support) — all drivers verified in QEMU:
- Network: virtio-net cleanup, RTL8139, E1000, clause-22 MDIO PHY management,
  CAN bus, industrial protocols (Modbus/Profibus/EtherCAT), controller probe+dispatch
- Block storage: RAM disk backend (write->read->verify PASSED), virtio-blk transport,
  backend dispatch, real MBR+GPT partition parsers, SD/eMMC command framework
- GPIO: PL061 (verified), I2C: DesignWare (verified), SPI: PL022 (verified)

Phase C (Advanced Features):
- PCI: FULL PikeOS ARMv7 replica — transport-agnostic uos_pci_ops, config-address
  encoding, BAR sizing, capability walk, enumeration+bridge recursion, MSI/MSI-X
- USB: PikeOS-style layered stack — usb.h contract, usb_core.cpp (enumeration
  state machine), usb_ehci.cpp (EHCI transport)
- Display: FULL 1:1 PikeOS fbcon replica + copied font_8x16

Build foundation fixes:
- Freestanding aeabi_runtime.cpp (__aeabi_uidiv/__aeabi_uldivmod)
- PikeOS-style flat 4GB MMU section map + proper enable (unblocked device MMIO)
- guest.h MAX_GUEST_IMAGE_SIZE 256MB->16MB (BSS was 259MB)
- C/C++ linkage fixes, duplicate-virtio_net_init, MMIO access-size handling

Phase D (PikeOS ARMv7 Microkernel Port):
- D-1: Per-VM address spaces — cloned pgdirs, ASID-tagged TLB, 4K page walker,
  isolation PASSED (two guests, same VA->different PAs), guest fault recovery
- D-2: IRQ dispatch backbone — 1024-slot dispatch table, real GICv2 hardware
  (GICD_CTLR/GICC_CTLR/GICC_PMR/GICC_IAR/GICC_EOIR), arm_irq_handler wired
- D-3: Time subsystem — CNTVCT ns-since-boot, CNTP periodic ticker via D-2
- D-4: KDEV framework — linker-section driver registration, uos_kdev_init_all,
  name lookup
- D-5: VFP/NEON — lazy enable (undef trap->CPACR+FPEXC.EN), FPEXC=0x40000000
- D-6: SMP — per-CPU state, MPIDR, IPI/SGI framework (reschedule+TLB flush)

All uos_ naming (PikeOS p4_ convention adapted). Compiles -Werror freestanding C++17.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-09 09:10:53 +01:00

84 lines
2.5 KiB
C

/*
* Universalisos I2C Master Driver
* Phase B Priority 6: Platform I/O - Inter-IC bus
*
* Synopsys DesignWare I2C controller, as emulated by QEMU. Provides master
* write, read, and combined write-then-read transfers plus bus scanning.
*
* Author: PortugalFuturista Hypervisor Development Team
*/
#ifndef UNIVERSALISOS_DRIVERS_I2C_H
#define UNIVERSALISOS_DRIVERS_I2C_H
#include <stdint.h>
#include <stdbool.h>
#ifdef __cplusplus
extern "C" {
#endif
/** I2C standard speeds */
#define I2C_SPEED_STANDARD 100000U /* 100 kHz */
#define I2C_SPEED_FAST 400000U /* 400 kHz */
#define I2C_SPEED_FAST_PLUS 1000000U /* 1 MHz */
/** Maximum controllers and transfer sizes */
#define MAX_I2C_CONTROLLERS 4
#define I2C_MAX_TRANSFER 256
/**
* Initialize a DesignWare I2C controller.
* @param controller_id Logical controller index
* @param base_address MMIO base
* @param speed_hz Bus speed in Hz (I2C_SPEED_*)
* @return 0 on success, negative on error
*/
int i2c_init(uint8_t controller_id, uint32_t base_address, uint32_t speed_hz);
/**
* Master write: send `length` bytes from `data` to 7-bit `slave_address`.
* @return number of bytes written, negative on error
*/
int i2c_master_write(uint8_t controller_id, uint8_t slave_address,
const uint8_t* data, uint16_t length);
/**
* Master read: receive `length` bytes into `data` from 7-bit `slave_address`.
* @return number of bytes read, negative on error
*/
int i2c_master_read(uint8_t controller_id, uint8_t slave_address,
uint8_t* data, uint16_t length);
/**
* Combined transfer: write `write_len` bytes (register select), then issue a
* repeated-start and read `read_len` bytes. Standard register-read pattern.
* @return number of bytes read, negative on error
*/
int i2c_master_write_read(uint8_t controller_id, uint8_t slave_address,
const uint8_t* write_data, uint16_t write_len,
uint8_t* read_data, uint16_t read_len);
/**
* Probe the bus for an ACKing device at `slave_address` (7-bit).
* @return true if a device responds, false otherwise
*/
bool i2c_probe_device(uint8_t controller_id, uint8_t slave_address);
/**
* Scan the full 7-bit address range and log discovered devices.
*/
void i2c_scan_bus(uint8_t controller_id);
/** Controller interrupt handler (wired by the GIC dispatch). */
void i2c_interrupt_handler(uint8_t controller_id);
/** Driver init / self-test. */
void i2c_driver_init(void);
void i2c_driver_demo(void);
#ifdef __cplusplus
}
#endif
#endif /* UNIVERSALISOS_DRIVERS_I2C_H */