-/*\r
- LUFA Library\r
- Copyright (C) Dean Camera, 2009.\r
- \r
- dean [at] fourwalledcubicle [dot] com\r
- www.fourwalledcubicle.com\r
-*/\r
-\r
-/*\r
- Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
- Permission to use, copy, modify, distribute, and sell this \r
- software and its documentation for any purpose is hereby granted\r
- without fee, provided that the above copyright notice appear in \r
- all copies and that both that the copyright notice and this\r
- permission notice and warranty disclaimer appear in supporting \r
- documentation, and that the name of the author not be used in \r
- advertising or publicity pertaining to distribution of the \r
- software without specific, written prior permission.\r
-\r
- The author disclaim all warranties with regard to this\r
- software, including all implied warranties of merchantability\r
- and fitness. In no event shall the author be liable for any\r
- special, indirect or consequential damages or any damages\r
- whatsoever resulting from loss of use, data or profits, whether\r
- in an action of contract, negligence or other tortious action,\r
- arising out of or in connection with the use or performance of\r
- this software.\r
-*/\r
-\r
-/** \file\r
- *\r
- * V2Protocol parameter handler, to process V2 Protocol device parameters.\r
- */\r
-\r
-#define INCLUDE_FROM_V2PROTOCOL_PARAMS_C\r
-#include "V2ProtocolParams.h"\r
-\r
-/* Non-Volatile Parameter Values for EEPROM storage */\r
-uint8_t EEMEM EEPROM_Rest_Polarity = 0x00;\r
-\r
-/* Volatile Parameter Values for RAM storage */\r
-static ParameterItem_t ParameterTable[] = \r
- {\r
- { .ParamID = PARAM_BUILD_NUMBER_LOW,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = (LUFA_VERSION_INTEGER >> 8) },\r
-\r
- { .ParamID = PARAM_BUILD_NUMBER_HIGH,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = (LUFA_VERSION_INTEGER & 0xFF), },\r
-\r
- { .ParamID = PARAM_HW_VER,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = 0x00 },\r
-\r
- { .ParamID = PARAM_SW_MAJOR,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = 0x01 },\r
-\r
- { .ParamID = PARAM_SW_MINOR,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = 0x0D },\r
-\r
- { .ParamID = PARAM_VTARGET,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = 0x32 },\r
-\r
- { .ParamID = PARAM_SCK_DURATION,\r
- .ParamPrivileges = PARAM_PRIV_READ | PARAM_PRIV_WRITE,\r
- .ParamValue = (TOTAL_ISP_PROGRAMMING_SPEEDS - 1) },\r
-\r
- { .ParamID = PARAM_RESET_POLARITY,\r
- .ParamPrivileges = PARAM_PRIV_WRITE,\r
- .ParamValue = 0x00 },\r
-\r
- { .ParamID = PARAM_STATUS_TGT_CONN,\r
- .ParamPrivileges = PARAM_PRIV_READ,\r
- .ParamValue = 0x00 },\r
-\r
- { .ParamID = PARAM_DISCHARGEDELAY,\r
- .ParamPrivileges = PARAM_PRIV_WRITE,\r
- .ParamValue = 0x00 },\r
- };\r
-\r
-\r
-/** Loads saved non-volatile parameter values from the EEPROM into the parameter table, as needed. */\r
-void V2Params_LoadNonVolatileParamValues(void)\r
-{\r
- /* Target RESET line polarity is a non-volatile value, retrieve current parameter value from EEPROM -\r
- * NB: Cannot call V2Protocol_SetParameterValue() here, as that will cause another EEPROM write! */\r
- V2Params_GetParamFromTable(PARAM_RESET_POLARITY)->ParamValue = eeprom_read_byte(&EEPROM_Rest_Polarity);\r
-}\r
-\r
-/** Updates any parameter values that are sourced from hardware rather than explicitly set by the host, such as\r
- * VTARGET levels from the ADC on supported AVR models.\r
- */\r
-void V2Params_UpdateParamValues(void)\r
-{\r
- #if defined(ADC)\r
- /* Update VTARGET parameter with the latest ADC conversion of VTARGET on supported AVR models */\r
- V2Params_GetParamFromTable(PARAM_VTARGET)->ParamValue = ((5 * 10 * ADC_GetResult()) / 1024);\r
- #endif\r
-}\r
-\r
-/** Retrieves the host PC read/write privileges for a given parameter in the parameter table. This should\r
- * be called before calls to \ref V2Params_GetParameterValue() or \ref V2Params_SetParameterValue() when\r
- * getting or setting parameter values in response to requests from the host.\r
- *\r
- * \param[in] ParamID Parameter ID whose privileges are to be retrieved from the table\r
- *\r
- * \return Privileges for the requested parameter, as a mask of PARAM_PRIV_* masks\r
- */ \r
-uint8_t V2Params_GetParameterPrivileges(const uint8_t ParamID)\r
-{\r
- ParameterItem_t* ParamInfo = V2Params_GetParamFromTable(ParamID);\r
- \r
- if (ParamInfo == NULL)\r
- return 0;\r
-\r
- return ParamInfo->ParamPrivileges;\r
-}\r
-\r
-/** Retrieves the current value for a given parameter in the parameter table.\r
- *\r
- * \param[in] ParamID Parameter ID whose value is to be retrieved from the table\r
- *\r
- * \return Current value of the parameter in the table, or 0 if not found\r
- */ \r
-uint8_t V2Params_GetParameterValue(const uint8_t ParamID)\r
-{\r
- ParameterItem_t* ParamInfo = V2Params_GetParamFromTable(ParamID);\r
- \r
- if (ParamInfo == NULL)\r
- return 0;\r
- \r
- return ParamInfo->ParamValue;\r
-}\r
-\r
-/** Sets the value for a given parameter in the parameter table.\r
- *\r
- * \param[in] ParamID Parameter ID whose value is to be set in the table\r
- * \param[in] Value New value to set the parameter to\r
- *\r
- * \return Pointer to the associated parameter information from the parameter table if found, NULL otherwise\r
- */\r
-void V2Params_SetParameterValue(const uint8_t ParamID, const uint8_t Value)\r
-{\r
- ParameterItem_t* ParamInfo = V2Params_GetParamFromTable(ParamID);\r
-\r
- if (ParamInfo == NULL)\r
- return;\r
-\r
- ParamInfo->ParamValue = Value;\r
-\r
- /* The target RESET line polarity is a non-volatile parameter, save to EEPROM when changed */\r
- if (ParamID == PARAM_RESET_POLARITY)\r
- eeprom_write_byte(&EEPROM_Rest_Polarity, Value); \r
-}\r
-\r
-/** Retrieves a parameter entry (including ID, value and privileges) from the parameter table that matches the given\r
- * parameter ID.\r
- *\r
- * \param[in] ParamID Parameter ID to find in the table\r
- *\r
- * \return Pointer to the associated parameter information from the parameter table if found, NULL otherwise\r
- */\r
-static ParameterItem_t* V2Params_GetParamFromTable(const uint8_t ParamID)\r
-{\r
- ParameterItem_t* CurrTableItem = ParameterTable;\r
-\r
- /* Find the parameter in the parameter table if present */\r
- for (uint8_t TableIndex = 0; TableIndex < (sizeof(ParameterTable) / sizeof(ParameterTable[0])); TableIndex++)\r
- {\r
- if (ParamID == CurrTableItem->ParamID)\r
- return CurrTableItem;\r
- \r
- CurrTableItem++;\r
- }\r
-\r
- return NULL;\r
-}\r
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2012.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.lufa-lib.org
+*/
+
+/*
+ Copyright 2012 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, distribute, and sell this
+ software and its documentation for any purpose is hereby granted
+ without fee, provided that the above copyright notice appear in
+ all copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * V2Protocol parameter handler, to process V2 Protocol device parameters.
+ */
+
+#define INCLUDE_FROM_V2PROTOCOL_PARAMS_C
+#include "V2ProtocolParams.h"
+
+/* Non-Volatile Parameter Values for EEPROM storage */
+static uint8_t EEMEM EEPROM_Reset_Polarity = 0x00;
+
+/* Volatile Parameter Values for RAM storage */
+static ParameterItem_t ParameterTable[] =
+ {
+ { .ParamID = PARAM_BUILD_NUMBER_LOW,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = 0 },
+
+ { .ParamID = PARAM_BUILD_NUMBER_HIGH,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = 0 },
+
+ { .ParamID = PARAM_HW_VER,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = 0x00 },
+
+ { .ParamID = PARAM_SW_MAJOR,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = 0x01 },
+
+ { .ParamID = PARAM_SW_MINOR,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = 0x0D },
+
+ { .ParamID = PARAM_VTARGET,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = 0x32 },
+
+ { .ParamID = PARAM_SCK_DURATION,
+ .ParamPrivileges = PARAM_PRIV_READ | PARAM_PRIV_WRITE,
+ .ParamValue = 6 },
+
+ { .ParamID = PARAM_RESET_POLARITY,
+ .ParamPrivileges = PARAM_PRIV_READ | PARAM_PRIV_WRITE,
+ .ParamValue = 0x01 },
+
+ { .ParamID = PARAM_STATUS_TGT_CONN,
+ .ParamPrivileges = PARAM_PRIV_READ,
+ .ParamValue = STATUS_ISP_READY },
+
+ { .ParamID = PARAM_DISCHARGEDELAY,
+ .ParamPrivileges = PARAM_PRIV_READ | PARAM_PRIV_WRITE,
+ .ParamValue = 0x00 },
+ };
+
+
+/** Loads saved non-volatile parameter values from the EEPROM into the parameter table, as needed. */
+void V2Params_LoadNonVolatileParamValues(void)
+{
+ /* Target RESET line polarity is a non-volatile value, retrieve current parameter value from EEPROM */
+ V2Params_GetParamFromTable(PARAM_RESET_POLARITY)->ParamValue = eeprom_read_byte(&EEPROM_Reset_Polarity);
+}
+
+/** Updates any parameter values that are sourced from hardware rather than explicitly set by the host, such as
+ * VTARGET levels from the ADC on supported AVR models.
+ */
+void V2Params_UpdateParamValues(void)
+{
+ #if (defined(ADC) && !defined(NO_VTARGET_DETECT))
+ /* Update VTARGET parameter with the latest ADC conversion of VTARGET on supported AVR models */
+ V2Params_GetParamFromTable(PARAM_VTARGET)->ParamValue = (((uint16_t)(VTARGET_REF_VOLTS * 10 * VTARGET_SCALE_FACTOR) * ADC_GetResult()) / 1024);
+ #endif
+}
+
+/** Retrieves the host PC read/write privileges for a given parameter in the parameter table. This should
+ * be called before calls to \ref V2Params_GetParameterValue() or \ref V2Params_SetParameterValue() when
+ * getting or setting parameter values in response to requests from the host.
+ *
+ * \param[in] ParamID Parameter ID whose privileges are to be retrieved from the table
+ *
+ * \return Privileges for the requested parameter, as a mask of \c PARAM_PRIV_* masks
+ */
+uint8_t V2Params_GetParameterPrivileges(const uint8_t ParamID)
+{
+ ParameterItem_t* ParamInfo = V2Params_GetParamFromTable(ParamID);
+
+ if (ParamInfo == NULL)
+ return 0;
+
+ return ParamInfo->ParamPrivileges;
+}
+
+/** Retrieves the current value for a given parameter in the parameter table.
+ *
+ * \note This function does not first check for read privileges - if the value is being sent to the host via a
+ * GET PARAM command, \ref V2Params_GetParameterPrivileges() should be called first to ensure that the
+ * parameter is host-readable.
+ *
+ * \param[in] ParamID Parameter ID whose value is to be retrieved from the table
+ *
+ * \return Current value of the parameter in the table, or 0 if not found
+ */
+uint8_t V2Params_GetParameterValue(const uint8_t ParamID)
+{
+ ParameterItem_t* ParamInfo = V2Params_GetParamFromTable(ParamID);
+
+ if (ParamInfo == NULL)
+ return 0;
+
+ return ParamInfo->ParamValue;
+}
+
+/** Sets the value for a given parameter in the parameter table.
+ *
+ * \note This function does not first check for write privileges - if the value is being sourced from the host
+ * via a SET PARAM command, \ref V2Params_GetParameterPrivileges() should be called first to ensure that the
+ * parameter is host-writable.
+ *
+ * \param[in] ParamID Parameter ID whose value is to be set in the table
+ * \param[in] Value New value to set the parameter to
+ *
+ * \return Pointer to the associated parameter information from the parameter table if found, NULL otherwise
+ */
+void V2Params_SetParameterValue(const uint8_t ParamID,
+ const uint8_t Value)
+{
+ ParameterItem_t* ParamInfo = V2Params_GetParamFromTable(ParamID);
+
+ if (ParamInfo == NULL)
+ return;
+
+ ParamInfo->ParamValue = Value;
+
+ /* The target RESET line polarity is a non-volatile parameter, save to EEPROM when changed */
+ if (ParamID == PARAM_RESET_POLARITY)
+ eeprom_update_byte(&EEPROM_Reset_Polarity, Value);
+}
+
+/** Retrieves a parameter entry (including ID, value and privileges) from the parameter table that matches the given
+ * parameter ID.
+ *
+ * \param[in] ParamID Parameter ID to find in the table
+ *
+ * \return Pointer to the associated parameter information from the parameter table if found, NULL otherwise
+ */
+static ParameterItem_t* V2Params_GetParamFromTable(const uint8_t ParamID)
+{
+ ParameterItem_t* CurrTableItem = ParameterTable;
+
+ /* Find the parameter in the parameter table if present */
+ for (uint8_t TableIndex = 0; TableIndex < TABLE_PARAM_COUNT; TableIndex++)
+ {
+ if (ParamID == CurrTableItem->ParamID)
+ return CurrTableItem;
+
+ CurrTableItem++;
+ }
+
+ return NULL;
+}
+