Received-SPF: softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) client-ip=23.128.96.19;
Message-ID: <0d8605f2-0556-3b83-998e-823b924b9a1a@os.amperecomputing.com>
Date:   Fri, 25 Mar 2022 14:14:24 +0700
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0)
 Gecko/20100101 Thunderbird/91.6.0
Subject: Re: [PATCH v7 5/9] misc: smpro-misc: Add Ampere's Altra SMpro misc
 driver
Content-Language: en-US
To:     Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc:     Lee Jones <lee.jones@linaro.org>, Rob Herring <robh+dt@kernel.org>,
        Krzysztof Kozlowski <krzk+dt@kernel.org>,
        Jean Delvare <jdelvare@suse.com>,
        Guenter Roeck <linux@roeck-us.net>,
        Jonathan Corbet <corbet@lwn.net>,
        Derek Kiernan <derek.kiernan@xilinx.com>,
        Dragan Cvetic <dragan.cvetic@xilinx.com>,
        Arnd Bergmann <arnd@arndb.de>,
        Thu Nguyen <thu@os.amperecomputing.com>,
        Gustavo Pimentel <Gustavo.Pimentel@synopsys.com>,
        open list <linux-kernel@vger.kernel.org>,
        "open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS" 
        <devicetree@vger.kernel.org>,
        "open list:HARDWARE MONITORING" <linux-hwmon@vger.kernel.org>,
        "open list:DOCUMENTATION" <linux-doc@vger.kernel.org>,
        OpenBMC Maillist <openbmc@lists.ozlabs.org>,
        Open Source Submission <patches@amperecomputing.com>,
        Phong Vo <phong@os.amperecomputing.com>,
        "Thang Q . Nguyen" <thang@os.amperecomputing.com>
References: <20220321081355.6802-1-quan@os.amperecomputing.com>
 <20220321081355.6802-6-quan@os.amperecomputing.com>
 <Yjg1nREijopyA+8A@kroah.com>
 <e9f92650-4f7c-260d-8aa2-92d1c84bf74a@os.amperecomputing.com>
 <YjhNP+Jzn/z4+5Zw@kroah.com>
From:   Quan Nguyen <quan@os.amperecomputing.com>
In-Reply-To: <YjhNP+Jzn/z4+5Zw@kroah.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?QmVMYk1xeUZKSC9aQ2lCeG9FWEp3T2xJNHdsOGtzSUZ5OXlMdDBiV3hqb2g4?=
 =?utf-8?B?K2h2SlhYMUxoMzA1aWRPV1VpeDIwOSt6WGtJNFptZnpkbW5ENzVoc1grY080?=
 =?utf-8?B?d1psdk9vQTF3QVlSeG4zRmthYzF1SUFRcDEzUC9rdDE2NzVac3M1ZjhWTmZl?=
 =?utf-8?B?T3Q0SFVjNnE1VThsdGFCS3dQM3R4bFI0U2xKSWZGWUxEaUZLcW9rK1FscElE?=
 =?utf-8?B?UzFzVDlIVnlVVlA1em5GdWZBWkJpY0k4emV0NldMaS9xTDdKWFZaOGphMEZB?=
 =?utf-8?B?S2FFN2VGbVNlSUZjaFpyK0o1RTl5ZUZVSTNBdUtERFowaExrR1IwcGFvZlVx?=
 =?utf-8?B?VU9xbEswRndJaVg2WUVCNDF3OGFPeWsrQzNlR0U4WFN4c0wzam5zYkoxRGhV?=
 =?utf-8?B?WmR5NEJOZ2swdTJpZXZwSTN5VHJjVXZRTVlBSmU5VDlualpzQUg4VjlFNWUw?=
 =?utf-8?B?UlJvSGF2WGxVOFlOcGhvWVAveUpkaHorQXBMdmkxemJ1eXVXQTJvY2h1clVL?=
 =?utf-8?B?RVVsbktRdVU1VGE2Yys0MEYzWit6dE5wOEVxazR6amVRZTc2Vzg3d3RMYkc4?=
 =?utf-8?B?b3l6UFoxMXUvN0hod0RTdi9lS2VTMGFLK1E3ZzVRR3JmSXdLNFlrWjNkdEVI?=
 =?utf-8?B?WEsxUW1IcnpDM3Q4eG5oNHk4U3lFV3JDc01BOGdJWHovQXYwRWNKQnIwR1Z4?=
 =?utf-8?B?RTZkWmxDUmRCZ3l1ODQyak1WSndQaG1LcVpSUFZGY0d1QTV1RDdiM3h1YjJN?=
 =?utf-8?B?eDkxWS93bWMrWGRKZHduS2JzamMwc095S2VYYmRoQlkzYzVOS3J2endDYkVw?=
 =?utf-8?B?N1lSY1lCcnl5VFQxRUcvd2hPQVROZWJubW1JWmRUY2sxZmhTMEFibThCZTE3?=
 =?utf-8?B?M1dLOVRRSEduUkdsVFNoVGlQVU1CcVd4aUtnVkQ1V1AxSFZtZXcyOUhsdFpM?=
 =?utf-8?B?Y1FLMURHcUZ2dU9GWG1SZnJ0WnBCTnU4aUlMQXM0TFpMcTExVmdNREZnMEhm?=
 =?utf-8?B?dkl5TVFGQXFjM3NSQUpGUnZMakY4aEw1dkVTZ3pUc3ZNWEJzblJla0cxa2dN?=
 =?utf-8?B?WGhSR1JvaU9uVFN0bWdBejF2dWZ0T040ajh3blQ3ZlA5TXVzOVBXQXZPMk51?=
 =?utf-8?B?Wk1TZEFsSG1mTmFGOElnT21sM0t1YWlIQjE5aXZ5bVpYK256eTB5Q1Q2M3pI?=
 =?utf-8?B?c3VnQnJ3M2Z1RU1Qdm1KMVNXTmtzZ2Jzb2ZmT2w4clhZbmNaV2lCZ0xaMlcx?=
 =?utf-8?B?aWo4dzNnOEp6QmhwYjFVdEJrUDJFQi9ZR28xZHFEUlNCSFlNOWV5dkNIaXBl?=
 =?utf-8?B?Y2ZNVGFhWEMxbzkxY1J6L1ZSbXJGdThNZ0h3OUlvWHprVXdDT1hkeTFsRWZ3?=
 =?utf-8?B?aEpiaVZYaUNLVXN1OHhkTDk3QWVSNkFkcm9yMm5KZUxJMXBrNFlsV3NESFJa?=
 =?utf-8?B?MzdvZEJGbWw4NjltZG9NdHY2Q2FqaklPQXFCQ2dxeWsrbkF0SDVaN0JvVDB3?=
 =?utf-8?B?V05NWVhTbjM4QmN3anA2REFTRGlaL2IwakJnRkExVmlhTUJQZnhEZU1XeWtG?=
 =?utf-8?B?azlJRjNhRGRBRUdVTDJNYUFaRjJoSmFielhxSWxPNjBZTTQ0UFNFWDdJKy9p?=
 =?utf-8?B?SEovK2ZhN3Ewbkxndk1yZ2l2MkNlY2psRHI5ZnpNd2hBRk9BRFI4MlV1WCs2?=
 =?utf-8?B?bDVxYnV5ZFd1T1dqeDlyaXR5S3hXVWNJN0lzQ25PQjI3eUNZbHJFMWRzSnF1?=
 =?utf-8?B?cGZEK0p6aTJhNERYeFN6dERXRjloaEdjMjFKemljdVhnaTRhNm9rZDczdXdD?=
 =?utf-8?B?VGVrZGIxVzJzdDVDc3diaSt0UnZ3VE1QanROVE55YjdaYVcvM3pDWk0wa3F0?=
 =?utf-8?B?M1c5YVB6YUM2bzZVSERMeTlaOGNySmhiMlN0OURrY1JmUDRBZXJ1dzBKUVFQ?=
 =?utf-8?B?ZWJDckVlbDZhem9NNWpyUlFMcnlwWDUybUwzbWFyYVBGWFprU0JLYWJEMWkz?=
 =?utf-8?Q?biDwm/7z0aHrvYgoI4cjb9fSyX0VV8=3D?=
X-OriginatorOrg: os.amperecomputing.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 01dfc0bc-c229-4c92-8aef-08da0e2f1f01
X-MS-Exchange-CrossTenant-AuthSource: SJ0PR01MB7282.prod.exchangelabs.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Mar 2022 07:14:37.6555
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3bc2b170-fd94-476d-b0ce-4229bdc904a7
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: 845t9BOadNgylpYl9b8UwTlaWA6hOsEAEvx8zESCe5C96XcCFBpTguDAUU6tXBmQ5WjqM7S2NtOb22vrxSfrtPoOnCsSZb9vaBUHm0nMbpY=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW2PR0102MB3465
X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED,
	DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,
	MAILING_LIST_MULTI,NICE_REPLY_A,RDNS_NONE,SPF_HELO_NONE,
	T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
	lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org


On 21/03/2022 17:02, Greg Kroah-Hartman wrote:
> On Mon, Mar 21, 2022 at 04:46:50PM +0700, Quan Nguyen wrote:
>>
>>
>> On 21/03/2022 15:21, Greg Kroah-Hartman wrote:
>>> On Mon, Mar 21, 2022 at 03:13:51PM +0700, Quan Nguyen wrote:
>>>> This commit adds driver support for accessing various information
>>>> reported by Ampere's SMpro co-processor such as Boot Progress and
>>>> other miscellaneous data.
>>>>
>>>> Signed-off-by: Quan Nguyen <quan@os.amperecomputing.com>
>>>
>>> No Documentation/ABI/ entries for your sysfs file?
>>>
>>
>> Thank you, Greg, for a very quick review.
>> I have put this file in other patch.
>>
>>>> +static ssize_t boot_progress_show(struct device *dev, struct device_attribute *da, char *buf)
>>>> +{
>>>> +	struct smpro_misc *misc = dev_get_drvdata(dev);
>>>> +	u32 boot_progress;
>>>> +	u8 current_stage;
>>>> +	u8 boot_status;
>>>> +	u8 boot_stage;
>>>> +	u32 select;
>>>> +	u32 reg_lo;
>>>> +	u32 reg;
>>>> +	int ret;
>>>> +
>>>> +	/* Read current boot stage */
>>>> +	ret = regmap_read(misc->regmap, BOOTSTAGE_CUR_STAGE, &reg);
>>>> +	if (ret)
>>>> +		return ret;
>>>> +
>>>> +	current_stage = reg & 0xff;
>>>> +
>>>> +	/* Read the boot progress */
>>>> +	ret = regmap_read(misc->regmap, BOOTSTAGE_SELECT, &select);
>>>> +	if (ret)
>>>> +		return ret;
>>>> +
>>>> +	boot_stage = (select >> 8) & 0xff;
>>>> +	boot_status = select & 0xff;
>>>> +
>>>> +	if (boot_stage > current_stage)
>>>> +		return -EINVAL;
>>>> +
>>>> +	ret = regmap_read(misc->regmap,	BOOTSTAGE_STATUS_LO, &reg_lo);
>>>> +	if (!ret)
>>>> +		ret = regmap_read(misc->regmap, BOOTSTAGE_STATUS_HI, &reg);
>>>> +	if (ret)
>>>> +		return ret;
>>>> +
>>>> +	boot_progress = swab16(reg) << 16 | swab16(reg_lo);
>>>> +
>>>> +	/* Tell firmware to provide next boot stage next time */
>>>> +	if (boot_stage < current_stage) {
>>>> +		ret = regmap_write(misc->regmap, BOOTSTAGE_SELECT, ((select & 0xff00) | 0x1));
>>>> +		if (ret)
>>>> +			return ret;
>>>> +	}
>>>> +
>>>> +	return snprintf(buf, PAGE_SIZE, "0x%02x 0x%02x 0x%08x\n",
>>>> +			boot_stage, boot_status, boot_progress);
>>>
>>> sysfs_emit() please.
>>>
>> Thanks, Greg.
>>
>> Will switch to sysfs_emit() in my next version.
>>
>>> Also, this is 3 different things, put all of these in different sysfs
>>> files.
>>>
>>> thanks,
>>>
>>> greg k-h
>>
>> Actually, no. It is single value of boot stage.
> 
> You are displaying 3 things in a single line, those are 3 different
> things.
> 
>> Let me explain:
>> The boot progress consists of three things together: boot_stage, boot_status
>> and boot_progress and they have no meaning if reported them as three
>> separate values:
>> + boot_stage is to indicate the boot stage
>> + boot_status is to report the result of that boot_stage: started, complete
>> or error.
>> + boot_progress is to report more extra information for the stage other than
>> the boot_stage/boot_status.
> 
> Why are these just not 3 different files?  They describe three different
> things, please do not EVER force userspace to parse a sysfs file other
> than a single value.
> 
Thanks Greg for the comment.

As there are multiple boot stages that occur even before the firmware is 
able to report, the firmware will stores all the stages and make them 
ready for later access. Later, on each access, ie: read to sysfs, the 
earliest boot stages will be read out and the next stage info is made 
ready for the next read by clearing the current reported stage.

As these three piece of info only make sense when put together, we chose 
to providing a single file only so that when the sysfs is read, we can 
provide them as a single value and do the clearing so that the next read 
will return with the next stage.

My intention for next version is to report a single 12-byte hex value 
for this sysfs.

- Quan