FreeBSD fournit un mécanisme orienté objet pour demander des ressources du bus parent. Pratiquement tous les périphériques seront un fils membre d'un type de bus (PCI, ISA, USB, SCSI, etc) et ces périphériques nécessite des ressources issues de leur bus parent (comme des segments de mémoire, des interruptions or des canaux DMA).
Pour faire de particulièrement utile avec un périphérique PCI,
vous aurez besoin d'obtenir les registres d'adresse de base
(Base Address Registers ou BARs) de l'espace de configuration PCI.
Les détails spécifiques au PCI sur l'obtention du registre d'adresse de base
sont masqués dans la fonction bus_alloc_resource()
.
Par exemple, un pilote typique aura sa fonction attach()
similaire à ceci :
sc->bar0id = 0x10; sc->bar0res = bus_alloc_resource(dev, SYS_RES_MEMORY, &(sc->bar0id), 0, ~0, 1, RF_ACTIVE); if (sc->bar0res == NULL) { uprintf("Allocation memoire du registre PCI de base 0 echouee!\n"); error = ENXIO; goto fail1; } sc->bar1id = 0x14; sc->bar1res = bus_alloc_resource(dev, SYS_RES_MEMORY, &(sc->bar1id), 0, ~0, 1, RF_ACTIVE); if (sc->bar1res == NULL) { uprintf("Allocation memoire du registre PCI de base 1 echouee!\n"); error = ENXIO; goto fail2; } sc->bar0_bt = rman_get_bustag(sc->bar0res); sc->bar0_bh = rman_get_bushandle(sc->bar0res); sc->bar1_bt = rman_get_bustag(sc->bar1res); sc->bar1_bh = rman_get_bushandle(sc->bar1res);
Des références pour chaque registre d'adresse de base sont gardées
dans la structure softc
afin qu'elle puisse
être utilisée pour écrire dans le périphérique plus tard.
Ces références peuvent alors être utilisées pour lire ou écrire
dans les registres du périphérique avec les fonctions bus_space_*
.
Par exemple, un pilote peut contenir une fonction raccourci
pour lire dans un registre spécifique à une carte comme cela :
uint16_t board_read(struct ni_softc *sc, uint16_t address) { return bus_space_read_2(sc->bar1_bt, sc->bar1_bh, address); }
De façon similaire, une autre peut écrire dans les registres avec :
void board_write(struct ni_softc *sc, uint16_t address, uint16_t value) { bus_space_write_2(sc->bar1_bt, sc->bar1_bh, address, value); }
Ces fonctions existent en versions 8bit, 16bit et 32bit
et vous devriez utiliser
bus_space_{read|write}_{1|2|4}
en conséquence.
Les interruptions sont alloués à partir du code orienté objet du bus de façon similaire aux ressources mémoire. D'abord une ressource IRQ doit être allouée à partir du bus parent, et alors le gestionnaire d'interruption doit être règlé pour traiter cet IRQ.
A nouveau, un exemple de fonction
attach()
en dit plusqu'un long discours.
/* Recupere la ressource IRQ */ sc->irqid = 0x0; sc->irqres = bus_alloc_resource(dev, SYS_RES_IRQ, &(sc->irqid), 0, ~0, 1, RF_SHAREABLE | RF_ACTIVE); if (sc->irqres == NULL) { uprintf("Allocation IRQ echouee!\n"); error = ENXIO; goto fail3; } /* Maitnenant nous choisissons notre gestionnaire d'interruption */ error = bus_setup_intr(dev, sc->irqres, INTR_TYPE_MISC, my_handler, sc, &(sc->handler)); if (error) { printf("Ne peut regler l'IRQ\n"); goto fail4; } sc->irq_bt = rman_get_bustag(sc->irqres); sc->irq_bh = rman_get_bushandle(sc->irqres);
Sur les PC, les périphériques qui veulent utiliser la gestion de
bus DMA doivent travailler avec des adresses physiques. C'est un problème
puisque FreeBSD utilise une mémoire virtuelle et travaille presque
exclusivement avec des adresses virtuelles. Heureusement, il y a une
fonction vtophys()
pour nous aider.
#include <vm/vm.h> #include <vm/pmap.h> #define vtophys(virtual_address) (...)
La solution est toutefois un peu différente sur Alpha, et
ce que nous voulons réellement est une fonction appelée
vtobus()
.
#if defined(__alpha__) #define vtobus(va) alpha_XXX_dmamap((vm_offset_t)va) #else #define vtobus(va) vtophys(va) #endif
Il est très important de désallouer toutes les ressources
qui furent allouées pendant attach()
.
Unsoin tout particulier doit être pris pour désallouer
les bonnes choses même lors d'un échec afin que le système reste
utilisable lorsque votre driver meurt.
Précédent | Sommaire | Suivant |
Les périphériques PCI | Niveau supérieur | Contrôleurs SCSI Common Access Method (CAM) ** |
Ce document, ainsi que d'autres peut être téléchargé sur ftp.FreeBSD.org/pub/FreeBSD/doc/.
Pour toutes questions à propos de FreeBSD, lisez la documentation avant de contacter <questions@FreeBSD.org>.
Pour les questions sur cette documentation, contactez <doc@FreeBSD.org>.