广州创龙LED程序深度剖析

深度剖析创龙公司LED程序（这个程序是OMAP-L138平台上的LED点灯的双核通信程序）第一部分：ARM端程序1、MainWindow w;//创建MainWindow的对象，这将会调用其构造函数2、在MainWindow::MainWindow(QWidget*parent):QMainWindow(parent)构造函数中a)syslink init-->SysLink_setup();初始化SysLink，此函数必须在用户进程调用其他的SysLink API函数之前调用。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////Void SysLink_setup(Void);///////////////////////////////////////////////////////////////////////////////////////////////////////////////////b)m_slave_id=MultiProc_getId(“DSP”);//获取DSP处理器的ID////////////////////////////////////////////////////////////////////////////////////////////////////////////////////UInt16MultiProc_getId(String name);name:处理器名字返回值：返回处理器的ID/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////String MultiProc_getName(UInt16id);id:多核处理器ID返回值：处理器的名字，返回的处理器名字是不能被修改的/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////c)Ipc_control(m_slave_id,Ipc_CONTROLCMD_LOADCALLBACK,NULL);//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////Int Ipc_control(UInt16procId,Int32cmdId,Ptr arg);procId:远程处理器IDcmdId:命令ID值arg:参数值依赖命令ID值返回值：成功返回0，失败返回负值/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////Ipc_CONTROLCMD_LOADCALLBACK0xBABE0000加载回调控制命令，此命令只能通过Ipc_control()函数发送，在从设备装载程序之后，并且在从设备使用IPC组件之前调用。

Ipc_CONTROLCMD_STARTCALLBACK0xBABE0001开始回调控制命令，此命令只能通过Ipc_control()函数发送，同时需要在先发送Ipc_CONTROLCMD_LOADCALLBACK成功之后发送。

这个命令会与从处理器执行一个握手过程，通常在从处理器端调用Ipc_attach()后成功返回。

Ipc_CONTROLCMD_STOPCALLBACK0xBABE0002停止回调控制命令，此命令只能通过Ipc_control()函数发送，从从设备上分离。

这个命令会与从处理器产生一个握手过程，通常在从处理器端调用Ipc_detach()和Ipc_stop()后成功返回，这可能会使资源对于从处理器不可见。

Ipc_CONTROLCMD_SETTERMINATEPOLICY0xBABE0003终止指定的操作策略，传给Ipc_control()函数中的arg参数必须是一个指向Ipc_Terminate结构体的指针。

d)led init-->m_led=new LedClient(...);//创建一个LedClient对象,接着调用构造函数。

在LedClient::LedClient(...)构造函数中，对其中的成员变量进行赋值。

m_slave_id=m_slave_id(ID)m_line_id=SystemCfg_LineId(0)m_event_id=SystemCfg_EventId(7)e)m_led->connect();//调用LedClient类中的connect()成员函数///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////f)Int Notify_sendEvent(UInt16procId,UInt16lineId,UInt32eventId,UInt32payload,BoolwaitClear);在一个中断中发送一个事件。

procId:远程处理器IDline_id:线IDenentId:事件IDpayload:命令（需要发送的command）waitClear:一般选择为TRUE，这样命令不会被覆盖返回值：#Notify_E_EVTNOTREGISTERED：事件没有注册回调函数#Notify_E_NOTINITIALIZED：从设备的驱动没有被初始化#Notify_E_EVTDISABLED：从设备事件没有使能#Notify_E_TIMEOUT：发生超时(当waitClear是TRUE)#Notify_S_SUCCESS：事件成功发送3、在MainWindow::~MainWindow()析构函数中a)m_led->disconnect();//调用LedClient类中的disconnect()成员函数b)Ipc_control();//发生Ipc_CONTROLCMD_STOPCALLBACK命令c)sysLink destroy-->SysLink_destroy();//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////Void SysLink_destroy(Void);结束syslink//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////4、在MainWindow类中，定义了私有槽函数，当在屏幕上产生相应信号之后，相应的槽函数将会执行（QT程序的典型机制），这里只分析一类，其他的类似a)MainWindow::on_pushButton_6on_clicked();//D6按钮的槽函数在这个函数中，调用了LedClient类中的on_D6():m_led->on_D6();b)LedClient::on_D6();在这个函数中，调用了LedClient类中的send_command();c)LedClient::send_command(uint16_t cmd);cmd:需要发送的命令在这个函数中将会调用Notify_sendEvent()函数发送cmd命令d)其他的过程基本类似，这里不再赘述第二部分：DSP端程序1、首先在main()函数中，a)LOG_INIT();-->UARTStdioInit();-->UARTConsoleInit();-->PSCModuleControl(SOC_PSC_1_REGS,13,0,PSC_MDCTL_NEXT_ENABLE);///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////int PSCModuleControl(unsigned int baseAdd,unsigned int moduleId,unsigned int powerDomain,unsigned int flags) ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#define SOC_PSC_1_REGS(0x01E27000)//REVID#define PSC_MDCTL_NEXT_ENABLE(0x00000003u)在该函数中，会执行以下程序：HWREG(baseAdd+PSC_MDCTL(moduleId))=(flags&PSC_MDCTL_NEXT);#define HWREG(x)(*((volatile unsigned int*)(x)))#define PSC_MDCTL(n)(0xA00+(n*4))#define PSC_MDCTL_NEXT(0x0000001Fu)0x01E27000+(0xA00+13*4)=0x01E27A34-->0x00000003UARTPinMuxSetup(2,FALSE);/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// void UARTPinMuxSetup(unsigned int instanceNum,unsigned int modemCtrlChoice) ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////清除上下文中的引脚，但保留PINMUX4（0x01c14130）寄存器其他的引脚值svPinMuxTxdRxd=(HWREG(SOC_SYSCFG_0_REGS+SYSCFG0_PINMUX(4))&\~(SYSCFG_PINMUX4_PINMUX4_23_20|\SYSCFG_PINMUX4_PINMUX4_19_16));#define SOC_SYSCFG_0_REGS(0x01C14000)#define SYSCFG0_PINMUX(n)(0x120+(n*4))#define SYSCFG_PINMUX4_PINMUX4_23_20(0x00F00000u)#define SYSCFG_PINMUX4_PINMUX4_19_16(0x000F0000u)svPinMuxTxdRxd=0xXX00XXXX;///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////设置UART2_TXD和UART2_RXD引脚，设置寄存器的值0x00220000HWREG(SOC_SYSCFG_0_REGS+SYSCFG0_PINMUX(4))=\(PINMUX4_UART2_TXD_ENABLE|\PINMUX4_UART2_RXD_ENABLE|\svPinMuxTxdRxd);#define PINMUX4_UART2_TXD_ENABLE(SYSCFG_PINMUX4_PINMUX4_23_20_UART2_TXD<<\SYSCFG_PINMUX4_PINMUX4_23_20_SHIFT)#define SYSCFG_PINMUX4_PINMUX4_23_20_UART2_TXD(0x00000002u)#define SYSCFG_PINMUX4_PINMUX4_23_20_SHIFT(0x00000014u)PINMUX4_UART2_TXD_ENABLE0x00200000#define PINMUX4_UART2_RXD_ENABLE(SYSCFG_PINMUX4_PINMUX4_19_16_UART2_RXD<<\SYSCFG_PINMUX4_PINMUX4_19_16_SHIFT)#define SYSCFG_PINMUX4_PINMUX4_19_16_UART2_RXD(0x00000002u)#define SYSCFG_PINMUX4_PINMUX4_19_16_SHIFT(0x00000010u) PINMUX4_UART2_RXD_ENABLE0x00020000///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// UARTStdioInitExpClk(BAUD_115200,UART_RX_TRIG_LEVEL_1);/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#define BAUD_115200115200#define UART_RX_TRIG_LEVEL_1(UART_FCR_RXFIFTL_CHAR1\<<UART_FCR_RXFIFTL_SHIFT)#define UART_FCR_RXFIFTL_CHAR1(0x00000000u)#define UART_FCR_RXFIFTL_SHIFT(0x00000006u)UART_RX_TRIG_LEVEL_1=0x00000000使能发送和接收UARTEnable(UART_CONSOLE_BASE);============================================================= void UARTEnable(unsigned int baseAdd)=============================================================#define UART_CONSOLE_BASE(SOC_UART_2_REGS)#define SOC_UART_2_REGS(0x01D0D000)//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// HWREG(baseAdd+UART_PWREMU_MGMT)=(UART_FREE_MODE|\UART_RX_RST_ENABLE|UART_TX_RST_ENABLE); #define UART_PWREMU_MGMT(0x30)#define UART_FREE_MODE UART_PWREMU_MGMT_FREE#define UART_PWREMU_MGMT_FREE(0x00000001u)#define UART_RX_RST_ENABLE UART_PWREMU_MGMT_URRST#define UART_PWREMU_MGMT_URRST(0x00002000u)#define UART_TX_RST_ENABLE UART_PWREMU_MGMT_UTRST#define UART_PWREMU_MGMT_UTRST(0x00004000u)PWREMU_MGMT(0x01D0D030)=0x00006001////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// UARTConfigSetExpClk(UART_CONSOLE_BASE,SOC_UART_2_MODULE_FREQ, baudRate,UART_WORDL_8BITS,UART_OVER_SAMP_RATE_16);======================================================================= void UARTConfigSetExpClk(unsigned int baseAdd,unsigned int uartClk,unsigned int baudrate,unsigned int config,unsigned int overSampRate)=======================================================================输入模块的时钟为150M，波特率为115200，8位数据位，无奇偶校验位，1位停止位，过采样率为16*115200#define SOC_UART_2_MODULE_FREQ(SOC_SYSCLK_2_FREQ)#define SOC_SYSCLK_2_FREQ(SOC_SYSCLK_1_FREQ/2)#define SOC_SYSCLK_1_FREQ(300000000)#define UART_WORDL_8BITS UART_LCR_WLS_8BITS#define UART_LCR_WLS_8BITS(0x00000003u)#define UART_OVER_SAMP_RATE_16UART_MDR_OSM_SEL_SHIFT#define UART_MDR_OSM_SEL_SHIFT(0x00000000u)根据传入参数值，计算分频值和设置寄存器的值divisor=uartClk/(baudrate*16);//150000000/115200/16=81（分频值0x51）HWREG(baseAdd+UART_MDR)&=~UART_OVER_SAMP_RATE;#define UART_MDR(0x34)#define UART_OVER_SAMP_RATE UART_MDR_OSM_SEL#define UART_MDR_OSM_SEL(0x00000001u)MDR(0x01D0D034)=0x*******???0(*表示4位，？表示1位)//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////将分频值写入到分频锁存寄存器中HWREG(baseAdd+UART_DLL)=((divisor&0xFF));HWREG(baseAdd+UART_DLH)=((divisor&0xFF00)>>8);#define UART_DLL(0x20)#define UART_DLH(0x24)DLL(0x01D0D020)=0x51&0xff=0x00000051DLH(0x01D0D024)=(0x51&0xff00)>>8=0x00000000将相应的值写入到LCR，LCR控制数据位，校验位，停止位HWREG(baseAdd+UART_LCR)=(config&(UART_STOP_BIT|UART_WORDL|\ UART_PARITY|UART_SET_PARITY_TYPE|\UART_STICK_PARITY|UART_BREAK_CTRL|UART_DLAB));#define UART_LCR(0xC)#define UART_STOP_BIT UART_LCR_STB#define UART_LCR_STB(0x00000004u)#define UART_WORDL UART_LCR_WLS#define UART_LCR_WLS(0x00000003u)#define UART_PARITY UART_LCR_PEN#define UART_LCR_PEN(0x00000008u)#define UART_SET_PARITY_TYPE UART_LCR_EPS#define UART_LCR_EPS(0x00000010u)#define UART_STICK_PARITY UART_LCR_SP#define UART_LCR_SP(0x00000020u)#define UART_BREAK_CTRL UART_LCR_BC#define UART_LCR_BC(0x00000040u)#define UART_DLAB UART_LCR_DLAB#define UART_LCR_DLAB(0x00000080u)LCR(0x01D0D00C)=(0x00000003&(0x00000004|0x00000003|0x00000008|0x00000010|0x00000020|0x00000040|0x00000080))=0x00000003////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////使能发送和接收FIFO，清除和复位FIFO计数器UARTFIFOEnable(UART_CONSOLE_BASE);======================================================================== void UARTFIFOEnable(unsigned int baseAdd)======================================================================== HWREG(baseAdd+UART_FCR)=(UART_FIFO_MODE|UART_RX_CLEAR|UART_TX_CLEAR);#define UART_FCR(0x8)#define UART_FIFO_MODE UART_FCR_FIFOEN#define UART_FCR_FIFOEN(0x00000001u)#define UART_RX_CLEAR UART_FCR_RXCLR#define UART_FCR_RXCLR(0x00000002u)#define UART_TX_CLEAR UART_FCR_TXCLR#define UART_FCR_TXCLR(0x00000004u)FCR(0x01D0D008)=0x00000007////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////设置接收FIFO触发级别UARTFIFOLevelSet(UART_CONSOLE_BASE,rxTrigLevel);======================================================================= void UARTFIFOLevelSet(unsigned int baseAdd,unsigned int rxLevel)======================================================================= HWREG(baseAdd+UART_FCR)=((rxLevel&(UART_RX_TRIG_LEVEL))|UART_FIFO_MODE);根据传入的参数值，rxLevel=UART_RX_TRIG_LEVEL_1(0x00000000)#define UART_RX_TRIG_LEVEL UART_FCR_RXFIFTL#define UART_FCR_RXFIFTL(0x000000C0u)#define UART_FIFO_MODE UART_FCR_FIFOEN#define UART_FCR_FIFOEN(0x00000001u)FCR(0x01D0D008)=0x00000001//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////b)Error_Block eb;//定义一个错误标志-->typedef UInt32Error_Block;c)Task_Params taskParams;#define Task_Params ti_sysbios_knl_Task_Paramsstruct ti_sysbios_knl_Task_Params{size_t__size;const void*__self;void*__fxns;xdc_runtime_IInstance_Params*instance;xdc_UArg arg0;xdc_UArg arg1;xdc_Int priority;xdc_Ptr stack;xdc_SizeT stackSize;xdc_runtime_IHeap_Handle stackHeap;xdc_Ptr env;xdc_Bool vitalTaskFlag;xdc_UInt affinity;xdc_runtime_IInstance_Params__iprms;};//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////在使用错误块的之前必须初始化Error_init(&eb);========================================================================#define Error_init(eb)*eb=0========================================================================在main()中创建主线程，初始化线程，设置线程的参数Task_Params_init(&taskParams);taskParams.instance->name="smain";//设置线程实例名字taskParams.arg0=(UArg)argc;//线程使用的参数argctaskParams.arg1=(UArg)argv;//线程使用的参数argvtaskParams.stackSize=0x1000;//线程使用的堆栈大小Task_create(smain,&taskParams,&eb);//启动线程函数smain()///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// static inline void ti_sysbios_knl_Task_Params_init(ti_sysbios_knl_Task_Params*prms)如果prms参数不为NULL，则会调用ti_sysbios_knl_Task_Params__init__S(prms,0,sizeof(ti_sysbios_knl_Task_Params),sizeof(xdc_runtime_IInstance_Params));////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// static inline ti_sysbios_knl_Task_Handle ti_sysbios_knl_Task_create(ti_sysbios_knl_Task_FuncPtr fxn,const ti_sysbios_knl_Task_Params*__prms,xdc_runtime_Error_Block*__eb)//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////d)Error_check(&eb);//检测错误块=====================================================================Bool Error_check(Error_Block*eb)=====================================================================e)如果创建任务失败，将会调用以下函数终止程序System_abort("main:failed to create application startup thread");=====================================================================Void System_abort(CString str)=====================================================================f)启动线程调度函数,该函数不会返回，会进行进程调度BIOS_start();===================================================================== Void BIOS_start(void)=====================================================================在函数里，继续调用BIOS_module->startFunc();2、在smain()函数中a)打开Diags_INFO追踪Diags_setMask("LedServer+F");===================================================================== Void Diags_setMask(CString src)=====================================================================b)status=Ipc_start();///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// UInt16baseId=MultiProc_getBaseIdOfCluster();//获取多核系统的基ID返回MultiProc_module->baseIdOfCluster中的值。