shell_init.c

MIPS下的boottloader yamon 的源代码

/************************************************************************
 *
 *  shell_init.c
 *
 *  Register help commands and start shell
 *
 *
 * ######################################################################
 *
 * Copyright (c) 1999-2000 MIPS Technologies, Inc. All rights reserved. 
 * 
 * Unpublished rights reserved under the Copyright Laws of the United States of 
 * America. 
 * 
 * This document contains information that is proprietary to MIPS Technologies, 
 * Inc. ("MIPS Technologies"). Any copying, modifying or use of this information 
 * (in whole or in part) which is not expressly permitted in writing by MIPS 
 * Technologies or a contractually-authorized third party is strictly 
 * prohibited. At a minimum, this information is protected under unfair 
 * competition laws and the expression of the information contained herein is 
 * protected under federal copyright laws. Violations thereof may result in 
 * criminal penalties and fines. 
 * MIPS Technologies or any contractually-authorized third party reserves the 
 * right to change the information contained in this document to improve 
 * function, design or otherwise. MIPS Technologies does not assume any 
 * liability arising out of the application or use of this information. Any 
 * license under patent rights or any other intellectual property rights owned 
 * by MIPS Technologies or third parties shall be conveyed by MIPS Technologies 
 * or any contractually-authorized third party in a separate license agreement 
 * between the parties. 
 * The information contained in this document constitutes one or more of the 
 * following: commercial computer software, commercial computer software 
 * documentation or other commercial items. If the user of this information, or 
 * any related documentation of any kind, including related technical data or 
 * manuals, is an agency, department, or other entity of the United States 
 * government ("Government"), the use, duplication, reproduction, release, 
 * modification, disclosure, or transfer of this information, or any related 
 * documentation of any kind, is restricted in accordance with Federal 
 * Acquisition Regulation 12.212 for civilian agencies and Defense Federal 
 * Acquisition Regulation Supplement 227.7202 for military agencies. The use of 
 * this information by the Government is further restricted in accordance with 
 * the terms of the license agreement(s) and/or applicable contract terms and 
 * conditions covering this information from MIPS Technologies or any 
 * contractually-authorized third party. 
 *
 ************************************************************************/


/************************************************************************
 *  Include files
 ************************************************************************/

#include <stdlib.h>
#include <shell_api.h>
#include <syscon_api.h>
#include <sys_api.h>
#include <mips.h>
#include <string.h>
#include "shell.h"

/************************************************************************
 *  Definitions
 ************************************************************************/

/* Maximum number of shell commands */
#define MAX_COMMANDS	40

/************************************************************************
 *  Public variables
 ************************************************************************/

/************************************************************************
 *  Static variables
 ************************************************************************/

/* Shell commands (array and count) */
static t_cmd  *(commands[MAX_COMMANDS]);
static UINT32 command_count = 0;

/************************************************************************
 *  Static function prototypes
 ************************************************************************/

static void
shell_function_install(
    UINT32 code,
    UINT32 function );

static int
compare(
   t_cmd **x,
   t_cmd **y );


/************************************************************************
 *  Implementation : Public functions
 ************************************************************************/

/************************************************************************
 *
 *                          shell_setup
 *  Description :
 *  -------------
 *
 *  Register commands and start shell
 *
 *  Return values :
 *  ---------------
 *
 *  None
 *
 ************************************************************************/
void 
shell_setup(void)
{
    /* Setup vector table for SHELL API */

    shell_function_install( SHELL_FUNC_EXIT_CODE,             
			    (UINT32)shell_exit );

    shell_function_install( SHELL_FUNC_PRINT_COUNT_CODE,
			    (UINT32)shell_print_count );

    shell_function_install( SHELL_FUNC_PRINT_CODE,
			    (UINT32)shell_print );

    shell_function_install( SHELL_FUNC_GETCHAR_CODE,
			    (UINT32)shell_getchar );

    shell_function_install( SHELL_FUNC_SYSCON_READ_CODE,
			    (UINT32)shell_syscon_read );

    shell_function_install( SHELL_FUNC_FLUSH_CODE,
			    (UINT32)shell_flush );

    shell_function_install( SHELL_FUNC_REGISTER_CPU_ISR_CODE, 
			    (UINT32)shell_register_cpu_isr );

    shell_function_install( SHELL_FUNC_DEREGISTER_CPU_ISR_CODE, 
			    (UINT32)shell_deregister_cpu_isr );

    shell_function_install( SHELL_FUNC_REGISTER_IC_ISR_CODE,  
			    (UINT32)shell_register_ic_isr );

    shell_function_install( SHELL_FUNC_DEREGISTER_IC_ISR_CODE,  
			    (UINT32)shell_deregister_ic_isr );

    shell_function_install( SHELL_FUNC_REGISTER_ESR_CODE,  
			    (UINT32)shell_register_esr );

    shell_function_install( SHELL_FUNC_DEREGISTER_ESR_CODE,  
			    (UINT32)shell_deregister_esr );

    /* Register commands except help */
    shell_arch();
    
    /* Register help command (must be the last one) */   
    shell_register_cmd( shell_help_init( commands, command_count + 1 ) );

    /* Sort the table */
    qsort( (char *)commands,
           (int)command_count,
	   (int)sizeof(t_cmd *),
	   compare );

    /* Start shell (never returns) */    
    shell( commands, command_count );
}


/************************************************************************
 *
 *                          shell_register_cmd
 *  Description :
 *  -------------
 *
 *  Register a command for the shell (commands must be setup before
 *  starting shell)
 *
 *  Return values :
 *  ---------------
 *
 *  None
 *
 ************************************************************************/
void 
shell_register_cmd( 
    t_cmd *cmd )			/* Command to be registered	*/
{
    if(command_count < MAX_COMMANDS )
        commands[command_count++] = cmd;
}


/************************************************************************
 *  Implementation : Static functions
 ************************************************************************/

/************************************************************************
 *  			compare
 ************************************************************************/
static int
compare(
   t_cmd **x,
   t_cmd **y )
{
   if( !(*x)->name )
       return 1;
   if( !(*y)->name )
       return -1;

   return strcmp( (*x)->name, (*y)->name );
}

/************************************************************************
 *  			shell_function_install
 ************************************************************************/
static void
shell_function_install(
    UINT32 code,
    UINT32 function )
{
    UINT32 addr;
    UINT32 opcode;

    /* Install JUMP */
    addr   = SHELL_VECTOR_ADDR + code * 8;
    opcode = OPCODE_JUMP( function );

    sys_dcache_flush_addr( addr );
    REG32( addr ) = opcode;
    sys_dcache_flush_addr( addr );
    sys_icache_invalidate_addr( addr );

    /* Install Nop in branch delay slot */
    addr  += 4;
    opcode = OPCODE_NOP;
    
    sys_dcache_flush_addr( addr );
    REG32( addr ) = opcode;
    sys_dcache_flush_addr( addr );
    sys_icache_invalidate_addr( addr );
}