Re: [PATCH] serial: 8250: Add Nuvoton NPCM UART

[Avi Fishman]

> From: joel.stan@xxxxxxxxx [mailto:joel.stan@xxxxxxxxx] On Behalf Of Joel Stanley
> Sent: Thursday, February 15, 2018 4:00 AM
>
> On Wed, Feb 14, 2018 at 3:22 AM, Andy Shevchenko <andy.shevchenko@xxxxxxxxx> wrote:
>> On Mon, Feb 12, 2018 at 6:48 AM, Joel Stanley <joel@xxxxxxxxx> wrote:
>>> The Nuvoton UART is almost compatible with the 8250 driver when
>>> probed via the 8250_of driver, however it requires some extra
>>> configuration at startup.
>>
>>
>>> +       [PORT_NPCM] = {
>>> +               .name           = "Nuvoton 16550",
>>> +               .fifo_size      = 16,
>>> +               .tx_loadsz      = 16,
>>> +               .fcr            = UART_FCR_ENABLE_FIFO | UART_FCR_R_TRIG_10 |
>>> +                                 UART_FCR_CLEAR_RCVR | UART_FCR_CLEAR_XMIT,
>>> +               .rxtrig_bytes   = {1, 4, 8, 14},
>>> +               .flags          = UART_CAP_FIFO,
>>
>>> +
>>
>> Redundant.
>
> You are referring to the extra whitespace?
>
>>> +       },
>>
>>> +               /*
>>> +                * Nuvoton calls the scratch register 'UART_TOR' (timeout
>>> +                * register). Enable it, and set TIOC (timeout interrupt
>>> +                * comparator) to be 0x20 for correct operation.
>>> +                */
>>> +               serial_port_out(port, UART_NPCM_TOR, UART_NPCM_TOIE |
>>> + 0x20);
>>
>>> +/* Nuvoton NPCM UARTs have a custom divisor calculation */
>>> +       return DIV_ROUND_CLOSEST(port->uartclk, 16 * baud + 2) - 2;
>>
>> Is there any link to datasheet?
>
> I have a copy of the datasheet under NDA. The Nuvoton guys might be able to help you out. Avi?

In the spec the calculation is as follows:
  BaudOut = Selected UART Clock Source / ( 16 * [Divisor + 2] )
To translate it to our code is:
  baud = port->uartclk / (16 * (Divisor + 2) )
So it should calculate without the "+ 2" inside as follow:
+       return DIV_ROUND_CLOSEST(port->uartclk, 16 * baud) - 2;

In order to get the spec you can add somthing like that:
"For getting the NPCM7XX Data Sheet please contact bmc_marketing@xxxxxxxxxxx".

BTW Andy, Intel has our Data Sheet under NDA, you can ask Mihm James
<james.mihm@xxxxxxxxx>.

>
>>
>>> +/* Nuvoton UART */
>>> +#define PORT_NPCM      118
>>
>> We have gaps there. #40 is perfect place for this one.
>
> Ok, I will move it up. Thanks for the review.
>
> Cheers,
>
> Joel
>