HelenOS sources

root/boot/genarch/src/ofw.c

DEFINITIONS

1. ofw_open
2. ofw_init
3. ofw_call
4. ofw_find_device
5. ofw_get_property
6. ofw_get_proplen
7. ofw_next_property
8. ofw_package_to_path
9. ofw_get_address_cells
10. ofw_get_size_cells
11. ofw_get_child_node
12. ofw_get_peer_node
13. ofw_putchar
14. ofw_translate
15. ofw_claim_virt_internal
16. ofw_claim_virt
17. ofw_claim_virt_any
18. ofw_claim_phys_internal
19. ofw_claim_phys
20. ofw_claim_phys_any
21. ofw_map
22. ofw_memmap
23. ofw_alloc
24. ofw_setup_screen
25. ofw_setup_screens_internal
26. ofw_setup_screens
27. ofw_quiesce

/*
 * Copyright (c) 2005 Martin Decky
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#include <arch/arch.h>
#include <arch/ofw.h>
#include <genarch/ofw.h>
#include <printf.h>
#include <stddef.h>
#include <str.h>
#include <align.h>
#include <halt.h>

#define RED(i)    (((i) >> 5) & ((1 << 3) - 1))
#define GREEN(i)  (((i) >> 3) & ((1 << 2) - 1))
#define BLUE(i)   ((i) & ((1 << 3) - 1))
#define CLIP(i)   ((i) <= 255 ? (i) : 255)

uintptr_t ofw_cif;

phandle ofw_chosen;
ihandle ofw_stdout;
phandle ofw_root;
ihandle ofw_mmu;
ihandle ofw_memory_prop;
phandle ofw_memory;

static char path[OFW_TREE_PATH_MAX_LEN + 1];

static ihandle ofw_open(const char *name)
{
        return (ihandle) ofw_call("open", 1, 1, NULL, name);
}

void ofw_init(void)
{
        ofw_chosen = ofw_find_device("/chosen");
        if (ofw_chosen == (phandle) -1)
                halt();

        if ((ofw_ret_t) ofw_get_property(ofw_chosen, "stdout", &ofw_stdout,
            sizeof(ofw_stdout)) <= 0)
                ofw_stdout = 0;

        ofw_root = ofw_find_device("/");
        if (ofw_root == (phandle) -1) {
                printf("Error: Unable to find / device, halting.\n");
                halt();
        }

        if ((ofw_ret_t) ofw_get_property(ofw_chosen, "mmu", &ofw_mmu,
            sizeof(ofw_mmu)) <= 0) {
                printf("Error: Unable to get mmu property, halting.\n");
                halt();
        }
        if ((ofw_ret_t) ofw_get_property(ofw_chosen, "memory", &ofw_memory_prop,
            sizeof(ofw_memory_prop)) <= 0) {
                printf("Error: Unable to get memory property, halting.\n");
                halt();
        }

        ofw_memory = ofw_find_device("/memory");
        if (ofw_memory == (phandle) -1) {
                printf("Error: Unable to find /memory device, halting.\n");
                halt();
        }
}

/** Perform a call to OpenFirmware client interface.
 *
 * @param service String identifying the service requested.
 * @param nargs   Number of input arguments.
 * @param nret    Number of output arguments. This includes the return
 *                value.
 * @param rets    Buffer for output arguments or NULL. The buffer must
 *                accommodate nret - 1 items.
 *
 * @return Return value returned by the client interface.
 *
 */
ofw_arg_t ofw_call(const char *service, const size_t nargs,
    const size_t nret, ofw_arg_t *rets, ...)
{
        ofw_args_t args;
        args.service = (ofw_arg_t) service;
        args.nargs = nargs;
        args.nret = nret;

        va_list list;
        va_start(list, rets);

        size_t i;
        for (i = 0; i < nargs; i++)
                args.args[i] = va_arg(list, ofw_arg_t);

        va_end(list);

        for (i = 0; i < nret; i++)
                args.args[i + nargs] = 0;

        (void) ofw(&args);

        for (i = 1; i < nret; i++)
                rets[i - 1] = args.args[i + nargs];

        return args.args[nargs];
}

phandle ofw_find_device(const char *name)
{
        return (phandle) ofw_call("finddevice", 1, 1, NULL, name);
}

ofw_arg_t ofw_get_property(const phandle device, const char *name, void *buf,
    const size_t buflen)
{
        return ofw_call("getprop", 4, 1, NULL, device, name, buf, buflen);
}

ofw_arg_t ofw_get_proplen(const phandle device, const char *name)
{
        return ofw_call("getproplen", 2, 1, NULL, device, name);
}

ofw_arg_t ofw_next_property(const phandle device, char *previous, char *buf)
{
        return ofw_call("nextprop", 3, 1, NULL, device, previous, buf);
}

ofw_arg_t ofw_package_to_path(const phandle device, char *buf,
    const size_t buflen)
{
        return ofw_call("package-to-path", 3, 1, NULL, device, buf, buflen);
}

size_t ofw_get_address_cells(const phandle device)
{
        ofw_prop_t ret = 1;

        if ((ofw_ret_t) ofw_get_property(device, "#address-cells", &ret,
            sizeof(ret)) <= 0)
                if ((ofw_ret_t) ofw_get_property(ofw_root, "#address-cells", &ret,
                    sizeof(ret)) <= 0)
                        ret = OFW_ADDRESS_CELLS;

        return (size_t) ret;
}

size_t ofw_get_size_cells(const phandle device)
{
        ofw_prop_t ret = 1;

        if ((ofw_ret_t) ofw_get_property(device, "#size-cells", &ret,
            sizeof(ret)) <= 0)
                if ((ofw_ret_t) ofw_get_property(ofw_root, "#size-cells", &ret,
                    sizeof(ret)) <= 0)
                        ret = OFW_SIZE_CELLS;

        return (size_t) ret;
}

phandle ofw_get_child_node(const phandle node)
{
        return (phandle) ofw_call("child", 1, 1, NULL, node);
}

phandle ofw_get_peer_node(const phandle node)
{
        return (phandle) ofw_call("peer", 1, 1, NULL, node);
}

void ofw_putchar(char ch)
{
        if (ofw_stdout == 0)
                return;

        ofw_call("write", 3, 1, NULL, ofw_stdout, &ch, 1);
}

void *ofw_translate(const void *virt)
{
        ofw_arg_t result[4];
        if (ofw_call("call-method", 4, 5, result, "translate", ofw_mmu,
            virt, 0) != 0) {
                printf("Error: mmu method translate failed, halting.\n");
                halt();
        }

        if (result[0] == false) {
                printf("Error: Unable to translate virtual address %p, halting.\n",
                    virt);
                halt();
        }

#ifdef __32_BITS__
        return (void *) result[2];
#endif

#ifdef __64_BITS__
        return (void *) ((result[2] << 32) | result[3]);
#endif
}

static void *ofw_claim_virt_internal(const void *virt, const size_t len,
    const size_t alignment)
{
        ofw_arg_t addr;
        if ((ofw_ret_t) ofw_call("call-method", 5, 2, &addr, "claim", ofw_mmu,
            alignment, len, (ofw_arg_t) virt) != 0) {
                printf("Error: mmu method claim failed, halting.\n");
                halt();
        }

        return (void *) addr;
}

void ofw_claim_virt(const void *virt, const size_t len)
{
        void *addr = ofw_claim_virt_internal(virt, len, 0);
        if (addr != virt) {
                printf("Error: Unable to claim virtual memory %p (size %zu), halting.\n",
                    virt, len);
                halt();
        }
}

void *ofw_claim_virt_any(const size_t len, const size_t alignment)
{
        void *addr = ofw_claim_virt_internal(NULL, len, alignment);

        if (addr == NULL) {
                printf("Error: Unable to claim %zu bytes in virtual memory, halting.\n",
                    len);
                halt();
        }

        return addr;
}

static void *ofw_claim_phys_internal(const void *phys, const size_t len,
    const size_t alignment)
{
        /*
         * Note that the return value check will help
         * us to discover conflicts between OpenFirmware
         * allocations and our use of physical memory.
         * It is better to detect collisions here
         * than to cope with weird errors later.
         *
         * So this is really not to make the loader
         * more generic; it is here for debugging
         * purposes.
         */

#ifdef __32_BITS__
        ofw_arg_t retaddr[1];
        if (ofw_call("call-method", 5, 2, retaddr, "claim",
            ofw_memory_prop, alignment, len, (ofw_arg_t) phys) != 0) {
                printf("Error: memory method claim failed, halting.\n");
                halt();
        }

        return (void *) retaddr[0];
#endif

#ifdef __64_BITS__
        ofw_arg_t retaddr[2];
        if (ofw_call("call-method", 6, 3, retaddr, "claim",
            ofw_memory_prop, alignment, len, ((ofw_arg_t) phys) >> 32,
            ((ofw_arg_t) phys) & 0xffffffff) != 0) {
                printf("Error: memory method claim failed, halting.\n");
                halt();
        }

        return (void *) ((retaddr[0] << 32) | retaddr[1]);
#endif
}

void ofw_claim_phys(const void *phys, const size_t len)
{
        void *addr = ofw_claim_phys_internal(phys, len, 0);
        if (addr != phys) {
                printf("Error: Unable to claim physical memory %p (size %zu), halting.\n",
                    phys, len);
                halt();
        }
}

void *ofw_claim_phys_any(const size_t len, const size_t alignment)
{
        void *addr = ofw_claim_phys_internal(NULL, len, alignment);
        if (addr == NULL) {
                printf("Error: Unable to claim %zu bytes in physical memory, halting.\n",
                    len);
                halt();
        }

        return addr;
}

void ofw_map(const void *phys, const void *virt, const size_t size,
    const ofw_arg_t mode)
{
        ofw_arg_t phys_hi;
        ofw_arg_t phys_lo;

#ifdef __32_BITS__
        phys_hi = (ofw_arg_t) phys;
        phys_lo = 0;
#endif

#ifdef __64_BITS__
        phys_hi = (ofw_arg_t) phys >> 32;
        phys_lo = (ofw_arg_t) phys & 0xffffffff;
#endif

        ofw_arg_t ret = ofw_call("call-method", 7, 1, NULL, "map", ofw_mmu, mode,
            ALIGN_UP(size, PAGE_SIZE), virt, phys_hi, phys_lo);

        if (ret != 0) {
                printf("Error: Unable to map %p to %p (size %zu), halting.\n",
                    virt, phys, size);
                halt();
        }
}

/** Save OpenFirmware physical memory map.
 *
 * @param map Memory map structure where the map will be saved.
 *
 */
void ofw_memmap(memmap_t *map)
{
        size_t ac = ofw_get_address_cells(ofw_memory) /
            (sizeof(uintptr_t) / sizeof(uint32_t));
        size_t sc = ofw_get_size_cells(ofw_memory) /
            (sizeof(uintptr_t) / sizeof(uint32_t));

        uintptr_t buf[((ac + sc) * MEMMAP_MAX_RECORDS)];

        /* The number of bytes read */
        ofw_ret_t ret = (ofw_ret_t) ofw_get_property(ofw_memory, "reg", buf,
            sizeof(buf));
        if (ret <= 0) {
                printf("Error: Unable to get physical memory information, halting.\n");
                halt();
        }

        size_t pos;
        map->total = 0;
        map->cnt = 0;
        for (pos = 0; (pos < ret / sizeof(uintptr_t)) &&
            (map->cnt < MEMMAP_MAX_RECORDS); pos += ac + sc) {
                void *start = (void *) (buf[pos + ac - 1]);
                uintptr_t size = buf[pos + ac + sc - 1];

                /*
                 * This is a hot fix of the issue which occurs on machines
                 * where there are holes in the physical memory (such as
                 * SunBlade 1500). Should we detect a hole in the physical
                 * memory, we will ignore any memory detected behind
                 * the hole and pretend the hole does not exist.
                 */
                if ((map->cnt > 0) && (map->zones[map->cnt - 1].start +
                    map->zones[map->cnt - 1].size < start))
                        break;

                if (size > 0) {
                        map->zones[map->cnt].start = start;
                        map->zones[map->cnt].size = size;
                        map->cnt++;
                        map->total += size;
                }
        }

        if (map->total == 0) {
                printf("Error: No physical memory detected, halting.\n");
                halt();
        }
}

/** Allocate physical and virtual memory area and map it
 *
 * The allocated memory is always page-aligned.
 *
 * @param name    Description of the memory area.
 * @param base    Virtual memory area address.
 * @param base_pa Physical memory area address.
 * @param size    Requested size in bytes.
 * @param min_pa  Minimal allowed physical address.
 *
 */
void ofw_alloc(const char *name, void **base, void **base_pa, const size_t size,
    void *min_pa)
{
        do {
                *base_pa = ofw_claim_phys_any(size, PAGE_SIZE);
        } while (*base_pa <= min_pa);

        *base = ofw_claim_virt_any(size, PAGE_SIZE);
        ofw_map(*base_pa, *base, ALIGN_UP(size, PAGE_SIZE), (ofw_arg_t) -1);
}

static void ofw_setup_screen(phandle handle)
{
        /* Check for device type */
        char device_type[OFW_TREE_PROPERTY_MAX_VALUELEN];
        if ((ofw_ret_t) ofw_get_property(handle, "device_type", device_type,
            OFW_TREE_PROPERTY_MAX_VALUELEN) <= 0)
                return;

        device_type[OFW_TREE_PROPERTY_MAX_VALUELEN - 1] = '\0';
        if (str_cmp(device_type, "display") != 0)
                return;

        /* Check for 8 bit depth */
        ofw_prop_t depth;
        if ((ofw_ret_t) ofw_get_property(handle, "depth", &depth,
            sizeof(depth)) <= 0)
                depth = 0;

        /* Get device path */
        ofw_arg_t len = ofw_package_to_path(handle, path, OFW_TREE_PATH_MAX_LEN);
        if (len == (ofw_arg_t) -1)
                return;

        path[len] = '\0';

        /* Open the display to initialize it */
        ihandle screen = ofw_open(path);
        if (screen == (ihandle) -1)
                return;

        if (depth == 8) {
                /* Setup the palette so that the (inverted) 3:2:3 scheme is usable */
                size_t i;
                for (i = 0; i < 256; i++) {
                        ofw_call("call-method", 6, 1, NULL, "color!", screen,
                            255 - i, CLIP(BLUE(i) * 37), GREEN(i) * 85, CLIP(RED(i) * 37));
                }
        }
}

static void ofw_setup_screens_internal(phandle current)
{
        while ((current != 0) && (current != (phandle) -1)) {
                ofw_setup_screen(current);

                /*
                 * Recursively process the potential child node.
                 */
                phandle child = ofw_get_child_node(current);
                if ((child != 0) && (child != (phandle) -1))
                        ofw_setup_screens_internal(child);

                /*
                 * Iteratively process the next peer node.
                 * Note that recursion is a bad idea here.
                 * Due to the topology of the OpenFirmware device tree,
                 * the nesting of peer nodes could be to wide and the
                 * risk of overflowing the stack is too real.
                 */
                phandle peer = ofw_get_peer_node(current);
                if ((peer != 0) && (peer != (phandle) -1)) {
                        current = peer;
                        /*
                         * Process the peer in next iteration.
                         */
                        continue;
                }

                /*
                 * No more peers on this level.
                 */
                break;
        }
}

/** Setup all screens which can be detected.
 *
 * Open all screens which can be detected and set up the palette for the 8-bit
 * color depth configuration so that the 3:2:3 color scheme can be used.
 * Check that setting the palette makes sense (the color depth is not greater
 * than 8).
 *
 */
void ofw_setup_screens(void)
{
        ofw_setup_screens_internal(ofw_root);
}

void ofw_quiesce(void)
{
        ofw_call("quiesce", 0, 0, NULL);
}