brain-hackers_pepepper-mirror/u-boot-brain
1
0
Fork 0
mirror of https://github.com/brain-hackers/u-boot-brain synced 2024-09-29 16:10:24 +09:00
Code Issues Projects Releases Wiki Activity

ARM: keystone2: psc: redo doc in kernel-doc format

Browse Source 
u-boot coding style guidance in
http://www.denx.de/wiki/U-Boot/CodingStyle clearly mentions that the
kernel doc style shall be followed for documentation in u-boot.

Current PSC documentation standard does not, so fix that.

Signed-off-by: Nishanth Menon <nm@ti.com>
Reviewed-by: Tom Rini <trini@konsulko.com>
This commit is contained in:
Nishanth Menon 2016-02-25 12:53:42 -06:00 committed by Tom Rini
parent 239c6953a9
commit 82ff21bd6f
1 changed files with 52 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

96
arch/arm/mach-keystone/psc.c
View File

@ -13,24 +13,27 @@
#include <asm/processor.h> #include <asm/processor.h>
#include <asm/arch/psc_defs.h> #include <asm/arch/psc_defs.h>
/**
* psc_delay() - delay for psc
*
* Return: 10
*/
int psc_delay(void) int psc_delay(void)
{ {
udelay(10); udelay(10);
return 10; return 10;
} }
/* /**
* FUNCTION PURPOSE: Wait for end of transitional state * psc_wait() - Wait for end of transitional state
* @domain_num: GPSC domain number
* *
* DESCRIPTION: Polls pstat for the selected domain and waits for transitions * Polls pstat for the selected domain and waits for transitions to be complete.
* to be complete. * Since this is boot loader code it is *ASSUMED* that interrupts are disabled
* and no other core is mucking around with the psc at the same time.
* *
* Since this is boot loader code it is *ASSUMED* that interrupts * Return: 0 when the domain is free. Returns -1 if a timeout occurred waiting
* are disabled and no other core is mucking around with the psc * for the completion.
* at the same time.
*
* Returns 0 when the domain is free. Returns -1 if a timeout
* occurred waiting for the completion.
*/ */
int psc_wait(u32 domain_num) int psc_wait(u32 domain_num)
{ {
@ -59,6 +62,10 @@ int psc_wait(u32 domain_num)
return 0; return 0;
} }
/**
* psc_get_domain_num() - Get the domain number
* @mod_num: LPSC module number
*/
u32 psc_get_domain_num(u32 mod_num) u32 psc_get_domain_num(u32 mod_num)
{ {
u32 domain_num; u32 domain_num;
@ -70,20 +77,19 @@ u32 psc_get_domain_num(u32 mod_num)
return domain_num; return domain_num;
} }
/* /**
* FUNCTION PURPOSE: Power up/down a module * psc_set_state() - powers up/down a module
* @mod_num: LPSC module number
* @state: 1 to enable, 0 to disable.
* *
* DESCRIPTION: Powers up/down the requested module and the associated power * Powers up/down the requested module and the associated power domain if
* domain if required. No action is taken it the module is * required. No action is taken it the module is already powered up/down.
* already powered up/down. * This only controls modules. The domain in which the module resides will
* be left in the power on state. Multiple modules can exist in a power
* domain, so powering down the domain based on a single module is not done.
* *
* This only controls modules. The domain in which the module * Return: 0 on success, -1 if the module can't be powered up, or if there is a
* resides will be left in the power on state. Multiple modules * timeout waiting for the transition.
* can exist in a power domain, so powering down the domain based
* on a single module is not done.
*
* Returns 0 on success, -1 if the module can't be powered up, or
* if there is a timeout waiting for the transition.
*/ */
int psc_set_state(u32 mod_num, u32 state) int psc_set_state(u32 mod_num, u32 state)
{ {
@ -136,15 +142,16 @@ int psc_set_state(u32 mod_num, u32 state)
return psc_wait(domain_num); return psc_wait(domain_num);
} }
/* /**
* FUNCTION PURPOSE: Power up a module * psc_enable_module() - power up a module
* @mod_num: LPSC module number
* *
* DESCRIPTION: Powers up the requested module and the associated power domain * Powers up the requested module and the associated power domain
* if required. No action is taken it the module is already * if required. No action is taken it the module is already powered up.
* powered up. *
* Return: 0 on success, -1 if the module can't be powered up, or
* if there is a timeout waiting for the transition.
* *
* Returns 0 on success, -1 if the module can't be powered up, or
* if there is a timeout waiting for the transition.
*/ */
int psc_enable_module(u32 mod_num) int psc_enable_module(u32 mod_num)
{ {
@ -158,12 +165,11 @@ int psc_enable_module(u32 mod_num)
return psc_set_state(mod_num, PSC_REG_VAL_MDCTL_NEXT_ON); return psc_set_state(mod_num, PSC_REG_VAL_MDCTL_NEXT_ON);
} }
/* /**
* FUNCTION PURPOSE: Power down a module * psc_disable_module() - Power down a module
* @mod_num: LPSC module number
* *
* DESCRIPTION: Powers down the requested module. * Return: 0 on success, -1 on failure or timeout.
*
* Returns 0 on success, -1 on failure or timeout.
*/ */
int psc_disable_module(u32 mod_num) int psc_disable_module(u32 mod_num)
{ {
@ -179,13 +185,16 @@ int psc_disable_module(u32 mod_num)
return psc_set_state(mod_num, PSC_REG_VAL_MDCTL_NEXT_SWRSTDISABLE); return psc_set_state(mod_num, PSC_REG_VAL_MDCTL_NEXT_SWRSTDISABLE);
} }
/* /**
* FUNCTION PURPOSE: Set the reset isolation bit in mdctl * psc_set_reset_iso() - Set the reset isolation bit in mdctl
* @mod_num: LPSC module number
* *
* DESCRIPTION: The reset isolation enable bit is set. The state of the module * The reset isolation enable bit is set. The state of the module is not
* is not changed. Returns 0 if the module config showed that * changed.
* reset isolation is supported. Returns 1 otherwise. This is not *
* an error, but setting the bit in mdctl has no effect. * Return: 0 if the module config showed that reset isolation is supported.
* Returns 1 otherwise. This is not an error, but setting the bit in mdctl
* has no effect.
*/ */
int psc_set_reset_iso(u32 mod_num) int psc_set_reset_iso(u32 mod_num)
{ {
@ -204,10 +213,9 @@ int psc_set_reset_iso(u32 mod_num)
return 1; return 1;
} }
/* /**
* FUNCTION PURPOSE: Disable a power domain * psc_disable_domain() - Disable a power domain
* * @domain_num: GPSC domain number
* DESCRIPTION: The power domain is disabled
*/ */
int psc_disable_domain(u32 domain_num) int psc_disable_domain(u32 domain_num)
{ {