Return to autoconfig CVS log

Up to [Apple Darwin 0.x] / driverkit / notes

Annotation of driverkit/notes/autoconfig, revision 1.1

1.1     ! root        1:                        Autoconfig questions
        !             2:                
        !             3: * NRW spec, IO Subsystem implies that 'device n' stuff is all relative to 
        !             4:   slot. But...all of this stuff is hard wired to slot 15! Should we 
        !             5:   assume that this stuff could work the same in other slots? Should autoconfig
        !             6:   be able to deal with NRW-type devices in other slots?
        !             7:  
        !             8: mapping dev_type to executable
        !             9:   -- dev_type = 32 bit number - 16 bits of type, 16 bits of rev
        !            10:      == TTTTRRRR
        !            11:      
        !            12:   -- executables named dev_XXXXYYYY_<any_text>
        !            13:      XXXX = type, in ASCII hex. Must match TYPE exactly
        !            14:      YYYY = rev, in ASCII hex. Any digit can be '*'.
        !            15:      
        !            16:   -- multiple links to a given executable allow multiple dev_ports mapped 
        !            17:      into one executable.
        !            18:      
        !            19:   -- multiple dev slots with same dev_type allow multiple exec's of one 
        !            20:      executable. 
        !            21:      
        !            22:   -- Ports advertised in bootstrap server subset by config as
        !            23:      dev_port_TTTT.
        !            24:      
        !            25:   -- autoconfig searches <driver_directory> for:
        !            26:     -- XXXX must = TTTT.
        !            27:     -- Then, in order:
        !            28:        -- RRRR == YYYY
        !            29:        -- RRRR == YY**
        !            30:        -- RRRR == Y***       
        !            31:        -- RRRR == ****
        !            32:        
        !            33: struct dev_entry {
        !            34:        struct {                                // one for each type associated
        !            35:            port_t dev_port;                    //   with this executable
        !            36:            int dev_type;
        !            37:        } entry[many];  
        !            38:        int executable_fid;                     // only one
        !            39:        char *one_executable_file_name;         // one of possibly many
        !            40: };
        !            41: 
        !            42: autoconfig main
        !            43: {
        !            44:        register host_priv_port to get privileges;
        !            45:        map in entire physical address space (somehow);
        !            46:                
        !            47:        for each device in DMA configuration page for each of three slots {
        !            48:                examine dev_type;
        !            49:                find executable for that dev_type;
        !            50:                if none
        !            51:                        continue to next device slot;
        !            52:                get dev_port from kernel for that device #;
        !            53:                if any dev_entries with this dev_type
        !            54:                        make a new dev_entry;
        !            55:                else if any dev_entries with this executable_fid
        !            56:                        add this dev_port, dev_type to that dev_entry;
        !            57:                else
        !            58:                        make a new dev_entry;
        !            59:        }
        !            60:        for each dev_entry {
        !            61:                make a new bootstrap subset;
        !            62:                advertise each entry.dev_port in bootstrap server
        !            63:                        as dev_port_TTTT under subst port;
        !            64:                exec(executable) with bootstrap = subset_port;
        !            65:        }
        !            66: }
        !            67: 
        !            68: device driver task
        !            69: {
        !            70:        for each dev_type needed { 
        !            71:                get bootstrap:dev_port_TTTT
        !            72:                dev_reg_map(dev_port_TTTT, **reg_ptr_TTTT);
        !            73:        }
        !            74:        [driver probe:dev_port reg_ptr:reg_ptr];
        !            75:        ...or...this is device-specific....
        !            76:        [driver probe:dev_port_TTTT 
        !            77:                next_port:dev_port_UUUU 
        !            78:                reg_ptr1:reg_ptr_1
        !            79:                reg_ptr2:reg_ptr_2];
        !            80:        /* TBD */
        !            81: }
        !            82: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.