diff options
author | Chris Cain <cjcain@us.ibm.com> | 2016-01-21 08:08:22 -0600 |
---|---|---|
committer | Christopher J. Cain <cjcain@us.ibm.com> | 2016-03-01 10:04:07 -0500 |
commit | 0b38bc9d5f8a7ab2fe466a3a432ade97eb5f8971 (patch) | |
tree | 6238bd93a590b4b38e69fbc1dd6513b1bb7955de /src/occ_405/lock/lock.h | |
parent | 8d6b58d82125223c07fa0c4fa795c0de52eefd2a (diff) | |
download | talos-occ-0b38bc9d5f8a7ab2fe466a3a432ade97eb5f8971.tar.gz talos-occ-0b38bc9d5f8a7ab2fe466a3a432ade97eb5f8971.zip |
Implement I2C locking with host
Change-Id: I9e99e799e0df442bebef473360ca87d564f5ddaf
RTC: 140545
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/12898
Tested-by: FSP CI Jenkins
Reviewed-by: Martha Broyles <mbroyles@us.ibm.com>
Reviewed-by: William A. Bryan <wilbryan@us.ibm.com>
Reviewed-by: Christopher J. Cain <cjcain@us.ibm.com>
Diffstat (limited to 'src/occ_405/lock/lock.h')
-rw-r--r-- | src/occ_405/lock/lock.h | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/src/occ_405/lock/lock.h b/src/occ_405/lock/lock.h new file mode 100644 index 0000000..dc570f2 --- /dev/null +++ b/src/occ_405/lock/lock.h @@ -0,0 +1,54 @@ +/* IBM_PROLOG_BEGIN_TAG */ +/* This is an automatically generated prolog. */ +/* */ +/* $Source: src/occ_405/lock/lock.h $ */ +/* */ +/* OpenPOWER OnChipController Project */ +/* */ +/* Contributors Listed Below - COPYRIGHT 2011,2015 */ +/* [+] International Business Machines Corp. */ +/* */ +/* */ +/* Licensed under the Apache License, Version 2.0 (the "License"); */ +/* you may not use this file except in compliance with the License. */ +/* You may obtain a copy of the License at */ +/* */ +/* http://www.apache.org/licenses/LICENSE-2.0 */ +/* */ +/* Unless required by applicable law or agreed to in writing, software */ +/* distributed under the License is distributed on an "AS IS" BASIS, */ +/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or */ +/* implied. See the License for the specific language governing */ +/* permissions and limitations under the License. */ +/* */ +/* IBM_PROLOG_END_TAG */ + +#ifndef _LOCK_H +#define _LOCK_H + +#include <occ_common.h> +#include <dimm.h> + + +// TODO: remove testing code once SIMICS_FLAG_ISSUE removed +//#define DEBUG_LOCK_TESTING + + + +// Release the OCC lock indefinitely +// This should be called when OCC goes into safe mode or will be reset +// to allow the host to use the specified I2C engines. +// Use PIB_I2C_ENGINE_ALL, if locks for all I2C engines should be released +void occ_i2c_lock_release(const uint8_t i_engine); + + +// Check and update lock ownership for the specified i2c engine +// If host has requesed lock, and there is no other outstanding interrupt +// release the lock, generate and external interrupt and return false. +// If the host has not released the lock, set ownership back to OCC and +// return true. +// +// Returns true if OCC owns the lock, or false if host owns lock +bool check_and_update_i2c_lock(const uint8_t i_engine); + +#endif //_LOCK_H |