Paul Mundt

lethal@linux-sh.org

2008-2010 Paul Mundt 2008-2010 Renesas Technology Corp. 2010 Renesas Electronics Corp. This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA For more details see the file COPYING in the source distribution of Linux. Kernel Hackers Manual July 2017 sq_flush_range 9 4.1.27 sq_flush_range Flush (prefetch) a specific SQ range void sq_flush_range unsigned long start unsigned int len start the store queue address to start flushing from len the length to flush Flushes the store queue cache from start to start + len in a linear fashion. Kernel Hackers Manual July 2017 sq_remap 9 4.1.27 sq_remap Map a physical address through the Store Queues unsigned long sq_remap unsigned long phys unsigned int size const char * name pgprot_t prot phys Physical address of mapping. size Length of mapping. name User invoking mapping. prot Protection bits. Remaps the physical address phys through the next available store queue address of size length. name is logged at boot time as well as through the sysfs interface. Kernel Hackers Manual July 2017 sq_unmap 9 4.1.27 sq_unmap Unmap a Store Queue allocation void sq_unmap unsigned long vaddr vaddr Pre-allocated Store Queue mapping. Unmaps the store queue allocation map that was previously created by sq_remap. Also frees up the pte that was previously inserted into the kernel page table and discards the UTLB translation. Kernel Hackers Manual July 2017 sh64_tlb_init 9 4.1.27 sh64_tlb_init Perform initial setup for the DTLB and ITLB. int sh64_tlb_init void void no arguments Kernel Hackers Manual July 2017 sh64_next_free_dtlb_entry 9 4.1.27 sh64_next_free_dtlb_entry Find the next available DTLB entry unsigned long long sh64_next_free_dtlb_entry void void no arguments Kernel Hackers Manual July 2017 sh64_get_wired_dtlb_entry 9 4.1.27 sh64_get_wired_dtlb_entry Allocate a wired (locked-in) entry in the DTLB unsigned long long sh64_get_wired_dtlb_entry void void no arguments Kernel Hackers Manual July 2017 sh64_put_wired_dtlb_entry 9 4.1.27 sh64_put_wired_dtlb_entry Free a wired (locked-in) entry in the DTLB. int sh64_put_wired_dtlb_entry unsigned long long entry entry Address of TLB slot. Works like a stack, last one to allocate must be first one to free. Kernel Hackers Manual July 2017 sh64_setup_tlb_slot 9 4.1.27 sh64_setup_tlb_slot Load up a translation in a wired slot. void sh64_setup_tlb_slot unsigned long long config_addr unsigned long eaddr unsigned long asid unsigned long paddr config_addr Address of TLB slot. eaddr Virtual address. asid Address Space Identifier. paddr Physical address. Load up a virtual<->physical translation for eaddr<->paddr in the pre-allocated TLB slot config_addr (see sh64_get_wired_dtlb_entry). Kernel Hackers Manual July 2017 sh64_teardown_tlb_slot 9 4.1.27 sh64_teardown_tlb_slot Teardown a translation. void sh64_teardown_tlb_slot unsigned long long config_addr config_addr Address of TLB slot. Teardown any existing mapping in the TLB slot config_addr. Kernel Hackers Manual July 2017 for_each_dtlb_entry 9 4.1.27 for_each_dtlb_entry Iterate over free (non-wired) DTLB entries for_each_dtlb_entry tlb tlb TLB entry Kernel Hackers Manual July 2017 for_each_itlb_entry 9 4.1.27 for_each_itlb_entry Iterate over free (non-wired) ITLB entries for_each_itlb_entry tlb tlb TLB entry Kernel Hackers Manual July 2017 __flush_tlb_slot 9 4.1.27 __flush_tlb_slot Flushes TLB slot slot. void __flush_tlb_slot unsigned long long slot slot Address of TLB slot. Kernel Hackers Manual July 2017 aica_rtc_gettimeofday 9 4.1.27 aica_rtc_gettimeofday Get the time from the AICA RTC void aica_rtc_gettimeofday struct timespec * ts ts pointer to resulting timespec Grabs the current RTC seconds counter and adjusts it to the Unix Epoch. Kernel Hackers Manual July 2017 aica_rtc_settimeofday 9 4.1.27 aica_rtc_settimeofday Set the AICA RTC to the current time int aica_rtc_settimeofday const time_t secs secs contains the time_t to set Adjusts the given tv to the AICA Epoch and sets the RTC seconds counter. Kernel Hackers Manual July 2017 ilsel_enable 9 4.1.27 ilsel_enable Enable an ILSEL set. int ilsel_enable ilsel_source_t set set ILSEL source (see ilsel_source_t enum in include/asm-sh/ilsel.h). Enables a given non-aliased ILSEL source (<= ILSEL_KEY) at the highest available interrupt level. Callers should take care to order callsites noting descending interrupt levels. Aliasing FPGA and external board IRQs need to use ilsel_enable_fixed. The return value is an IRQ number that can later be taken down with ilsel_disable. Kernel Hackers Manual July 2017 ilsel_enable_fixed 9 4.1.27 ilsel_enable_fixed Enable an ILSEL set at a fixed interrupt level int ilsel_enable_fixed ilsel_source_t set unsigned int level set ILSEL source (see ilsel_source_t enum in include/asm-sh/ilsel.h). level Interrupt level (1 - 15) Enables a given ILSEL source at a fixed interrupt level. Necessary both for level reservation as well as for aliased sources that only exist on special ILSEL#s. Returns an IRQ number (as ilsel_enable). Kernel Hackers Manual July 2017 ilsel_disable 9 4.1.27 ilsel_disable Disable an ILSEL set void ilsel_disable unsigned int irq irq Bit position for ILSEL set value (retval from enable routines) Disable a previously enabled ILSEL set. Kernel Hackers Manual July 2017 superhyway_add_device 9 4.1.27 superhyway_add_device Add a SuperHyway module int superhyway_add_device unsigned long base struct superhyway_device * sdev struct superhyway_bus * bus base Physical address where module is mapped. sdev SuperHyway device to add, or NULL to allocate a new one. bus Bus where SuperHyway module resides. This is responsible for adding a new SuperHyway module. This sets up a new struct superhyway_device for the module being added if sdev == NULL. Devices are initially added in the order that they are scanned (from the top-down of the memory map), and are assigned an ID based on the order that they are added. Any manual addition of a module will thus get the ID after the devices already discovered regardless of where it resides in memory. Further work can and should be done in superhyway_scan_bus, to be sure that any new modules are properly discovered and subsequently registered. Kernel Hackers Manual July 2017 superhyway_register_driver 9 4.1.27 superhyway_register_driver Register a new SuperHyway driver int superhyway_register_driver struct superhyway_driver * drv drv SuperHyway driver to register. This registers the passed in drv. Any devices matching the id table will automatically be populated and handed off to the driver's specified probe routine. Kernel Hackers Manual July 2017 superhyway_unregister_driver 9 4.1.27 superhyway_unregister_driver Unregister a SuperHyway driver void superhyway_unregister_driver struct superhyway_driver * drv drv SuperHyway driver to unregister. This cleans up after superhyway_register_driver, and should be invoked in the exit path of any module drivers. Kernel Hackers Manual July 2017 maple_driver_register 9 4.1.27 maple_driver_register register a maple driver int maple_driver_register struct maple_driver * drv drv maple driver to be registered. Registers the passed in drv, while updating the bus type. Devices with matching function IDs will be automatically probed. Kernel Hackers Manual July 2017 maple_driver_unregister 9 4.1.27 maple_driver_unregister unregister a maple driver. void maple_driver_unregister struct maple_driver * drv drv maple driver to unregister. Cleans up after maple_driver_register. To be invoked in the exit path of any module drivers. Kernel Hackers Manual July 2017 maple_getcond_callback 9 4.1.27 maple_getcond_callback setup handling MAPLE_COMMAND_GETCOND void maple_getcond_callback struct maple_device * dev void (*callback) struct mapleq *mq unsigned long interval unsigned long function dev device responding callback handler callback interval interval in jiffies between callbacks function the function code for the device Kernel Hackers Manual July 2017 maple_add_packet 9 4.1.27 maple_add_packet add a single instruction to the maple bus queue int maple_add_packet struct maple_device * mdev u32 function u32 command size_t length void * data mdev maple device function function on device being queried command maple command to add length length of command string (in 32 bit words) data remainder of command string