a3dd3f55f9
This change introduces PDDF which is described here: https://github.com/Azure/SONiC/pull/536 Most of the platform bring up effort goes in developing the platform device drivers, SONiC platform APIs and validating them. Typically each platform vendor writes their own drivers and platform APIs which is very tailor made to that platform. This involves writing code, building, installing it on the target platform devices and testing. Many of the details of the platform are hard coded into these drivers, from the HW spec. They go through this cycle repetitively till everything works fine, and is validated before upstreaming the code. PDDF aims to make this platform driver and platform APIs development process much simpler by providing a data driven development framework. This is enabled by: JSON descriptor files for platform data Generic data-driven drivers for various devices Generic SONiC platform APIs Vendor specific extensions for customisation and extensibility Signed-off-by: Fuzail Khan <fuzail.khan@broadcom.com>
92 lines
3.0 KiB
C
92 lines
3.0 KiB
C
/*
|
|
* Copyright 2019 Broadcom.
|
|
* The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
*
|
|
* Description:
|
|
* Platform FAN defines/structures header file
|
|
*/
|
|
|
|
#ifndef __PDDF_FAN_DEFS_H__
|
|
#define __PDDF_FAN_DEFS_H__
|
|
|
|
|
|
#define MAX_NUM_FAN 6
|
|
#define MAX_FAN_ATTRS 128
|
|
#define ATTR_NAME_LEN 32
|
|
#define STR_ATTR_SIZE 32
|
|
#define DEV_TYPE_LEN 32
|
|
|
|
/* Each client has this additional data
|
|
*/
|
|
|
|
typedef struct FAN_DATA_ATTR
|
|
{
|
|
char aname[ATTR_NAME_LEN]; // attr name, taken from enum fan_sysfs_attributes
|
|
char devtype[DEV_TYPE_LEN]; // Type of FAN controller, i.e EMC2305, EMC2302, or FAN-CPLD etc
|
|
char devname[DEV_TYPE_LEN]; // Name of the device from where this informatin is to be read
|
|
uint32_t devaddr;
|
|
uint32_t offset;
|
|
uint32_t mask;
|
|
uint32_t cmpval;
|
|
uint32_t len;
|
|
int mult; // Multiplication factor to get the actual data
|
|
uint8_t is_divisor; // Check if the value is a divisor and mult is dividend
|
|
void *access_data;
|
|
|
|
}FAN_DATA_ATTR;
|
|
|
|
|
|
typedef struct FAN_SYSFS_ATTR_DATA
|
|
{
|
|
int index;
|
|
unsigned short mode;
|
|
ssize_t (*show)(struct device *dev, struct device_attribute *da, char *buf);
|
|
int (*pre_get)(void *client, FAN_DATA_ATTR *adata, void *data);
|
|
int (*do_get)(void *client, FAN_DATA_ATTR *adata, void *data);
|
|
int (*post_get)(void *client, FAN_DATA_ATTR *adata, void *data);
|
|
ssize_t (*store)(struct device *dev, struct device_attribute *da, const char *buf, size_t count);
|
|
int (*pre_set)(void *client, FAN_DATA_ATTR *adata, void *data);
|
|
int (*do_set)(void *client, FAN_DATA_ATTR *adata, void *data);
|
|
int (*post_set)(void *client, FAN_DATA_ATTR *adata, void *data);
|
|
void *data;
|
|
} FAN_SYSFS_ATTR_DATA;
|
|
|
|
typedef struct FAN_SYSFS_ATTR_DATA_ENTRY
|
|
{
|
|
char name[ATTR_NAME_LEN];
|
|
FAN_SYSFS_ATTR_DATA *a_ptr;
|
|
} FAN_SYSFS_ATTR_DATA_ENTRY;
|
|
|
|
|
|
/* FAN CLIENT DATA - PLATFORM DATA FOR FAN CLIENT */
|
|
typedef struct FAN_DATA
|
|
{
|
|
int num_fantrays; // num of fans controlled by this fan client
|
|
FAN_DATA_ATTR fan_attr;
|
|
int len; // no of valid attributes for this fan client
|
|
FAN_DATA_ATTR fan_attrs[MAX_FAN_ATTRS];
|
|
}FAN_DATA;
|
|
|
|
typedef struct FAN_PDATA
|
|
{
|
|
int num_fantrays; // num of fans controlled by this fan client
|
|
int len; // no of valid attributes for this fan client
|
|
FAN_DATA_ATTR *fan_attrs;
|
|
}FAN_PDATA;
|
|
|
|
extern int board_i2c_cpld_read(unsigned short cpld_addr, u8 reg);
|
|
extern int board_i2c_cpld_write(unsigned short cpld_addr, u8 reg, u8 value);
|
|
|
|
#endif
|