PWM配置項(xiàng)的介紹

一、General

1、PwmDeInitApi

從代碼中添加/刪除Pwm_17_GtmCcu6_Delnit() API。

TRUE：Pwm_17_GtmCcu6_Delnit() API可供用戶使用。

FALSE：Pwm_17_GtmCcu6_Delnit() API對用戶不可用。

注意:默認(rèn)情況下禁用Pwm_17_GtmCcu6_Delnit() API以最小化可執(zhí)行代碼大小。

2、PwmGetOutputState?

從代碼中添加/刪除Pwm_17_GtmCcu6_GetOutputState() API。

TRUE：Pwm_17_GtmCcu6_GetOutputState() API可供用戶使用。

FALSE：Pwm_17_GtmCcu6_GetOutputState() API對用戶不可用。

注意:默認(rèn)情況下禁用Pwm_17_GtmCcu6_GetOutputState() API以最小化可執(zhí)行代碼大小。

3、PwmSetDutyCycle

從代碼中添加/刪除服務(wù)Pwm_17_GtmCcu6_SetDutyCycle() API。

TRUE: Pwm_17_GtmCcu6_SetDutyCycle() API對用戶可用。

FALSE: Pwm_17_GtmCcu6_SetDutyCycle() API對用戶不可用。

注意:Pwm_17_GtmCcu6_SetDutyCycle() API默認(rèn)禁用以最小化可執(zhí)行代碼大小。

4、PwmSetOutputToIdle

從代碼中添加/刪除服務(wù)Pwm_17_GtmCcu6_SetOutputToldle()。

TRUE: Pwm_17_GtmCcu6_SetOutputToldle() API對用戶可用。

FALSE: Pwm_17_GtmCcu6_SetOutputToldle() API對用戶不可用。

注意:Pwm_17_GtmCcu6_SetOutputToldle() API默認(rèn)禁用以最小化可執(zhí)行代碼大小。

5、PwmSetPeriodAndDuty

從代碼中添加/刪除服務(wù)Pwm_17_GtmCcu6_SetPeriodAndDuty()。

TRUE: Pwm_17_GtmCcu6_SetPeriodAndDuty() API可供用戶使用。

FALSE: Pwm_17_GtmCcu6_SetPeriodAndDuty() API對用戶不可用。

注意:默認(rèn)情況下禁用Pwm_17_GtmCcu6_SetPeriodAndDuty() API以最小化可執(zhí)行代碼大小。

6、PwmVersionInfoApi

從代碼中添加/刪除服務(wù)Pwm_17_GtmCcu6_GetVersionInfo。

TRUE: Pwm_17_GtmCcu6_GetVersionInfo() API可供用戶使用。

FALSE: Pwm_17_GtmCcu6_GetVersionInfo() API對用戶不可用。

注意:默認(rèn)情況下禁用Pwm_17_GtmCcu6_GetVersionInfo() API以最小化可執(zhí)行代碼大小。

7、PwmDevErrorDetect?

將(DET)檢測和通知切換到ON或OFF。

TRUE:啟用。

FALSE:禁用。

8、PwmMultiCoreErrorDetect

啟用或禁用與多核相關(guān)的DET檢測和報(bào)告。僅在啟用DET/Safety時(shí)才適用。

9、PwmDutycycleUpdatedEndperiod

全局開關(guān)，使能在當(dāng)前周期結(jié)束時(shí)更新占空比參數(shù)。

TRUE:更新占空比在當(dāng)前生成的波形周期結(jié)束時(shí)完成(當(dāng)前波形完成)。

FALSE:立即更新占空比(就在服務(wù)調(diào)用之后，當(dāng)前波形更新為新的占空比值)。

默認(rèn)值設(shè)置為“硬件默認(rèn)值”。

注意:如果全局開關(guān)為TRUE，那么對于PWM_VARIABLE_PERIOD通道，占空比和周期將在當(dāng)前生成的波形的周期結(jié)束時(shí)更新。

備注:此參數(shù)僅適用于GTM通道。

10、PwmIndex

11、PwmLowPowerStatesSupport?

由于不支持電源模式，該參數(shù)不啟用。

添加/刪除所有電源狀態(tài)管理相關(guān)的API (PWM_SetPowerState;PWM_GetCurrentPowerState、PWM_GetTargetPowerState、PWM_PreparePowerState、PWM_Main_PowerTransitionManager)表示硬件提供低功耗狀態(tài)管理。

12、PwmNotificationSupported?

通知支持的開關(guān)。

TRUE:支持通知。

FALSE:不支持通知。

注意:默認(rèn)值設(shè)置為FALSE以最小化可執(zhí)行代碼大小。

13、PwmPeriodUpdatedEndperiod?

啟用在當(dāng)前周期結(jié)束時(shí)更新period參數(shù)的全局開關(guān)。

TRUE:可變周期通道的周期和占空比在當(dāng)前生成波形的周期結(jié)束時(shí)更新(當(dāng)前波形完成)。

FALSE:立即更新變周期通道的周期和占空比(就在服務(wù)調(diào)用之后，當(dāng)前波形更新為新的周期值)。

PWM_FIXED_PERIOD、pwm_fixed_period_shift和PWM_FIXED_PERIOD_CENTER_ALIGNED類通道不受此參數(shù)設(shè)置的影響。

備注:默認(rèn)值為“硬件默認(rèn)值”。

備注:此參數(shù)僅適用于GTM通道。

14、PwmChannelCoherentSelection?

在當(dāng)前周期結(jié)束時(shí)啟用占空比/周期參數(shù)的智能通道更新開關(guān)。

TRUE:周期/占空比的更新是基于PWM通道特定配置PwmCoherentUpdate配置參數(shù)完成的。FALSE:根據(jù)PwmDutycycleUpdatedEndPeriod和PwmPeriodUpdatedEndPeriod全局參數(shù)更新周期/占空比。

備注:此參數(shù)僅適用于GTM通道。

15、PwmHandleShiftByOffset?

當(dāng)PwmHandleShiftByOffset被啟用時(shí)，移位的通道以偏移量開始，并將類似于固定周期通道。當(dāng)不選擇PwmHandleShiftByOffset時(shí)，從引用的固定周期通道觸發(fā)移位通道。

備注:此參數(shù)僅適用于GTM通道。

16、PwmDutyShiftInTicks?

確定占空比和移位值是絕對的還是相對于周期的。

TRUE:占空比和移位值作為絕對刻度輸入。

FALSE:輸入占空比和移位值相對于周期。

0為0%，Ox8000為100%。

注意:默認(rèn)值設(shè)置為FALSE，因?yàn)樗欠莂utosar功能。

17、PwmEnable0Or100DutyNotification?

如果設(shè)置為ON，則固定周期和可變周期通道支持0%和100%的通知。

如果設(shè)置為OFF，則固定周期和可變周期通道的0%和100%不支持通知。

注意:默認(rèn)值設(shè)置為FALSE以最小化可執(zhí)行代碼大小。

18、PwmPowerStateAsynchTransitionMode?

由于不支持電源模式，該參數(shù)不啟用。

啟用/禁用對異步電源狀態(tài)轉(zhuǎn)換的PWM驅(qū)動器的支持。

19、PwmSafetyEnable?

啟用安全錯(cuò)誤報(bào)告的開關(guān)(范圍和合理性檢查)。

注意:當(dāng)啟用此開關(guān)時(shí)，AUTOSAR DET默認(rèn)啟用。

默認(rèn)情況下啟用安全相關(guān)錯(cuò)誤的檢測，以確保在產(chǎn)品生命周期中解決安全問題。

20、PwmInitCheckApi?

開啟安全初始化檢查API。

注意:默認(rèn)情況下啟用安全相關(guān)錯(cuò)誤的檢測，以確保在產(chǎn)品生命周期中解決安全問題。

二、PwmChannel

1、PwmChannelId

PWM通道Id。該值被分配給從PwmChannel容器短名稱派生的符號名稱。Id值必須連續(xù)。注意:對每個(gè)新的PWM通道計(jì)算一個(gè)連續(xù)的值。選擇最小通道ID作為默認(rèn)值。

注意:PwmChannelld的值在一個(gè)配置集中應(yīng)該是唯一的。

2、PwmAssignedHwUnit?

用于產(chǎn)生PWM的硬件資源:GTM或CCU6。

注意:對于無GTM的設(shè)備，此參數(shù)將只保留CCU6選項(xiàng)。在這種情況下，默認(rèn)值將是CCU6。

3、PwmDutycycleDefault

通道占空比的默認(rèn)值。可以根據(jù)PwmDutyShiftInTicks參數(shù)輸入絕對刻度或相對百分比。

當(dāng)PwmDutyShiftInTicks設(shè)置為OFF時(shí)，該值相對于周期。0是0%，0x8000是100%。

當(dāng)PwmDutyShiftInTicks設(shè)置為ON時(shí)，該值以絕對刻度為單位。

0是0%，如果相同的值大于或等于PwmPeriodDefault，則占空比為100%。

范圍:

如果TOM/ATOM/CCU6的PwmDutyShiftInTicks為STD_OFF，則0~ 0x8000。

如果PwmDutyShiftInTicks為STD_ON且模塊為TOM或CCU6時(shí)，則0 ~ 0xFFFF。

如果PwmDutyShiftInTicks為STD_ON且模塊為ATOM時(shí)，則0 ~ 0xFFFFFF。

注:硬件復(fù)位為FALSE時(shí)，默認(rèn)為FALSE。

4、PwmIdleState?

表示信號停止(即調(diào)用)后PWM的輸出狀態(tài)Pwm_17_GtmCcu6_SetOutputToldle）。

注:默認(rèn)為硬件復(fù)位值。

5、PwmPeriodDefault

用于初始化的周期值。

如果PwmChannelClass為PWM_FIXED_PERIOD或PWM_VARIABLE_PERIOD，則此值重要。

范圍:

0 ~ OxFFFF，當(dāng)模塊為TOM或CCU6時(shí)；

0到OxFFFFFF，當(dāng)模塊是ATOM。

備注:默認(rèn)值與硬件復(fù)位值匹配。

6、PwmPolarity?

定義每個(gè)PWM通道的起始極性。

注意:默認(rèn)設(shè)置為PWM_LOW，因?yàn)橛布刂弥禐镕ALSE。

PWM_HIGH: PWM通道輸出在周期開始時(shí)高，然后在達(dá)到占空率計(jì)數(shù)時(shí)低。

PWM_LOW: PWM通道輸出在周期開始時(shí)低，然后在達(dá)到占空率計(jì)數(shù)時(shí)高。

7、PwmMcuClockReferencePoint?

包含對McuClockReferencePoint的引用。由于沒有使用此參數(shù)，因此它是禁用的。

8、PwmShiftValue

根據(jù)PWM_FIXED_PERIOD類通道配置初始移位值?？梢愿鶕?jù)PwmDutyShiftinTicks參數(shù)輸入絕對刻度或相對百分比。

當(dāng)PwmDutyShiftInTicks設(shè)置為OFF時(shí)，該值相對于周期。

0是0%，0x8000是100%。

當(dāng)PwmDutyShiftInTicks設(shè)置為ON時(shí)，該值以絕對刻度為單位。值0為0%。

與參考通道的PwmPeriodDefault值相同則為100%。

如果PwmChannelClass是pwm_fixed_period_shifts，這是重要的。

注意:默認(rèn)設(shè)置為匹配硬件復(fù)位值。

9、PwmReferenceChannel ?

如果PwmChannelClass是pwm_fixed_period_shift或PWM_FIXED_PERIOD_CENTER_ALIGNED，則此值有效。

如果PwmChannelClass是pwm_fixed_period_shifts或PWM_FIXED_PERIOD_CENTER_ALIGNED，則必須提供引用通道。

引用通道只能為PWM_FIXED_PERIOD。

注意:默認(rèn)值為空白，因?yàn)橛脩舯仨殢腗CU驅(qū)動程序中選擇適當(dāng)?shù)膮⒖贾怠?/p>

10、PwmCoherentUpdate?

啟用在當(dāng)前周期結(jié)束時(shí)更新占空比/周期參數(shù)的開關(guān)。

TRUE:周期/占空比的更新在當(dāng)前生成波形的周期結(jié)束時(shí)完成(當(dāng)前波形完成)。

FALSE:周期/占空比立即更新(就在服務(wù)調(diào)用之后，電流波形被切斷)。

根據(jù)PwmChannelClass，更新結(jié)束周期可以為占空比工作，也可以為占空和周期工作。可變周期通道更新占空比和周期，而其他PwmChannelClass通道只更新占空比。

備注:此參數(shù)僅適用于GTM通道。

11、PwmChannelClass

PWM_FIXED_PERIOD: PWM通道有固定的周期。只能改變占空比。

PWM_FIXED_PERIOD_CENTER_ALIGNED:這類PWM通道是指周期與一個(gè)PWM_FIXED_PERIOD通道相關(guān)，占空比將正好落在周期的中間。只有占空比可以為這個(gè)通道類改變。

注意:當(dāng)設(shè)備中有GTM硬件時(shí)，PWM_FIXED_PERIOD_CENTER_ALIGNED通道適用。

PWM_FIXED_PERIOD_SHIFTED:這類PWM通道是指周期與一個(gè)PWM_FIXED_PERIOD通道相關(guān)和占空比被要求的固定百分比移位。只能改變占空比。

PWM_VARIABLE_PERIOD:這類PWM通道具有可變周期和占空比。兩者都可以在運(yùn)行時(shí)更改。此通道不應(yīng)被任何其他通道引用，也不引用任何通道。

注意:如果PwmSetPeriodAndDuty設(shè)置為false，PWM_VARIABLE_PERIOD不適用。

12、PwmNotification

PWM驅(qū)動程序使用PwmNotification來調(diào)用用戶定義的函數(shù)，以生成相應(yīng)通道的邊緣。參數(shù)可以是通知函數(shù)的名稱或地址(數(shù)值)。

注1：由于函數(shù)的名稱是可配置的，所以默認(rèn)值保持為NULL。

注2：PWM驅(qū)動程序不驗(yàn)證配置的功能名稱或地址的正確性，責(zé)任落在用戶身上。

如果McuAtomChannelEventHandledByDsadc /McuAtomChannelEventHandledByDsadc為TRUE，則當(dāng)TOM/ATOM通道分別發(fā)生事件時(shí)，通知回調(diào)將由DSADC處理，而不是由PWM處理。因此，對于該通道，PwmNotification參數(shù)將不可編輯。

13、GtmTimerUsed?

分配給PWM通道的TOM或ATOM通道資源。

該參數(shù)列出所有GTM定時(shí)器通道(TOM或ATOM)。MCU中引用的定時(shí)器通道應(yīng)該具有TomChannelUsage/AtomChannelUsage作為USED_BY_PWM_DRIVER。

注意:默認(rèn)值設(shè)置為BLANK，因?yàn)橛脩舯仨殢腗CU驅(qū)動程序中選擇適當(dāng)?shù)膮⒖贾怠?/p>

14、GtmTimerClockSelect?

GTM時(shí)鐘的選擇。

15、GtmTimerPortPinSelect?

GTM針腳的選擇。