[PATCH] Fix beagle i2c file bbb-i2c.c comment issues

[Joel Sherrill]

A close personal friend of mine pushed the patch. :)

--joel

On Thu, Jun 15, 2017 at 2:57 PM, Gedare Bloom <gedare at rtems.org> wrote:

> Someone can push this.
>
> On Thu, Jun 15, 2017 at 7:35 AM, Sichen Zhao <1473996754 at qq.com> wrote:
> > ---
> >  c/src/lib/libbsp/arm/beagle/i2c/bbb-i2c.c | 42
> +++++++++++++++++--------------
> >  1 file changed, 23 insertions(+), 19 deletions(-)
> >
> > diff --git a/c/src/lib/libbsp/arm/beagle/i2c/bbb-i2c.c
> b/c/src/lib/libbsp/arm/beagle/i2c/bbb-i2c.c
> > index 3d7d820..26bae52 100644
> > --- a/c/src/lib/libbsp/arm/beagle/i2c/bbb-i2c.c
> > +++ b/c/src/lib/libbsp/arm/beagle/i2c/bbb-i2c.c
> > @@ -7,6 +7,7 @@
> >   */
> >
> >  /*
> > + * Copyright (c) 2016 Punit Vara <punitvara at gmail.com>
> >   * Copyright (c) 2017 Sichen Zhao <zsc19940506 at gmail.com>
> >   *
> >   * The license and distribution terms for this file may be
> > @@ -48,27 +49,26 @@ static void I2C0ModuleClkConfig( void )
> >              AM335X_CM_WKUP_I2C0_CLKCTRL_MODULEMODE ) ) ;
> >
> >    /*
> > -  ** Waiting for IDLEST field in AM335X_CM_WKUP_CONTROL_CLKCTRL
> > -  ** register to attain
> > -  ** desired value.
> > -  */
> > +   * Waiting for IDLEST field in AM335X_CM_WKUP_CONTROL_CLKCTRL
> > +   * register to attain desired value.
> > +   */
> >    while ( ( AM335X_CM_WKUP_CONTROL_CLKCTRL_IDLEST_FUNC <<
> >              AM335X_CM_WKUP_CONTROL_CLKCTRL_IDLEST_SHIFT ) !=
> >            ( REG( AM335X_SOC_CM_WKUP_REGS +
> AM335X_CM_WKUP_CONTROL_CLKCTRL ) &
> >              AM335X_CM_WKUP_CONTROL_CLKCTRL_IDLEST ) ) ;
> >
> >    /*
> > -  ** Waiting for CLKACTIVITY_I2C0_GFCLK field in
> AM335X_CM_WKUP_CLKSTCTRL
> > -  ** register to attain desired value.
> > -  */
> > +   * Waiting for CLKACTIVITY_I2C0_GFCLK field in
> AM335X_CM_WKUP_CLKSTCTRL
> > +   * register to attain desired value.
> > +   */
> >    while ( AM335X_CM_WKUP_CLKSTCTRL_CLKACTIVITY_I2C0_GFCLK !=
> >            ( REG( AM335X_SOC_CM_WKUP_REGS + AM335X_CM_WKUP_CLKSTCTRL ) &
> >              AM335X_CM_WKUP_CLKSTCTRL_CLKACTIVITY_I2C0_GFCLK ) ) ;
> >
> >    /*
> > -  ** Waiting for IDLEST field in AM335X_CM_WKUP_I2C0_CLKCTRL register
> to attain
> > -  ** desired value.
> > -  */
> > +   * Waiting for IDLEST field in AM335X_CM_WKUP_I2C0_CLKCTRL register
> to attain
> > +   * desired value.
> > +   */
> >    while ( ( AM335X_CM_WKUP_I2C0_CLKCTRL_IDLEST_FUNC <<
> >              AM335X_CM_WKUP_I2C0_CLKCTRL_IDLEST_SHIFT ) !=
> >            ( REG( AM335X_SOC_CM_WKUP_REGS + AM335X_CM_WKUP_I2C0_CLKCTRL
> ) &
> > @@ -100,7 +100,7 @@ static void am335x_i2c_reset( bbb_i2c_bus *bus )
> >    }
> >  }
> >  /*
> > -   Possible values for msg->flag
> > + * Possible values for msg->flag
> >   * - @ref I2C_M_TEN,
> >   * - @ref I2C_M_RD,
> >   * - @ref I2C_M_STOP,
> > @@ -116,13 +116,15 @@ static void am335x_i2c_set_address_size(
> >    volatile bbb_i2c_regs *regs
> >  )
> >  {
> > -  /*can be configured multiple modes here.
> > -   **Need to think about own address modes*/
> > +  /*
> > +   * Can be configured multiple modes here.
> > +   * Need to think about own address modes
> > +   */
> >    if ( ( msgs->flags & I2C_M_TEN ) == 0 ) {
> > -    /* 7-bit mode slave address mode*/
> > +    /* 7-bit mode slave address mode */
> >      REG( &regs->BBB_I2C_CON ) = AM335X_I2C_CFG_7BIT_SLAVE_ADDR;
> >    } else {
> > -    /* 10-bit slave address mode*/
> > +    /* 10-bit slave address mode */
> >      REG( &regs->BBB_I2C_CON ) = AM335X_I2C_CFG_10BIT_SLAVE_ADDR;
> >    }
> >  }
> > @@ -282,12 +284,14 @@ static void am335x_i2c_interrupt( void *arg )
> >  {
> >    bbb_i2c_bus           *bus = arg;
> >    volatile bbb_i2c_regs *regs = bus->regs;
> > -  /* get status of enabled interrupts */
> > +  /* Get status of enabled interrupts */
> >    uint32_t irqstatus = REG( &regs->BBB_I2C_IRQSTATUS );
> >    bool     done = false;
> >
> > -  /* Clear all enabled interrupt except receive ready
> > -     and transmit ready interrupt in status register */
> > +  /*
> > +   * Clear all enabled interrupt except receive ready
> > +   * and transmit ready interrupt in status register
> > +   */
> >    REG( &regs->BBB_I2C_IRQSTATUS ) =
> >      ( irqstatus & ~( AM335X_I2C_IRQSTATUS_RRDY |
> >                       AM335X_I2C_IRQSTATUS_XRDY ) );
> > @@ -417,7 +421,7 @@ int am335x_i2c_bus_register(
> >    rtems_status_code sc;
> >    int               err;
> >
> > -  /*check bus number is >0 & <MAX*/
> > +  /* Check bus number is >0 & <MAX */
> >    bus = (bbb_i2c_bus *) i2c_bus_alloc_and_init( sizeof( *bus ) );
> >
> >    if ( bus == NULL ) {
> > --
> > 2.7.4
> >
> >
> >
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20170615/f0e0ee69/attachment.html>