manualshive.com logo in svg

Freescale Semiconductor MC1322x, Справочное руководство, Страница: 38 / 48

Поделиться
Скачать
Freescale Semiconductor MC1322x Скачать руководство пользователя страница 38

MC1322x SMAC Primitives

MC1322x SMAC Reference Manual, Rev. 1.7

3-18

Freescale Semiconductor

 

Arguments

u8CipherMode

The cipher mode to use (gCTRMode_c, gCBCMode_c or gCCMMode_c).

pCipherKey

A pointer to the 128 bits key.

pCtrValue

A pointer to the 128 counter value.

Returns

gFailTest_c 

CipherEngineInit has not been executed or self test failed.

gFailOutOfRange_c

u8CipherMode is not a valid value.

gSuccess_c

Configuration action was performed

3.3.2

CipherEngineInit

Call the CipherEngineInit function to initiate the security module. This function allows carrying out a self 
test to verify encryption engine operation.

Function

FuncReturn_t CipherEngineInit(void)

Returns

gFailTest_c 

Cipher Engine Self Test failed.

gSuccess_c

Cipher Engine Self Test succeed.

Figure 3-1

 shows the security CTR and CBC modes. CCM mode combines the CTR mode for protecting 

the privacy of data and the CBC mode to generate a MAC to protect the data from unauthorized 
modifications.

Figure 3-1. CTR and CBC Ciphering Modes

Содержание MC1322x

Страница 1: ...Document Number 22xSMACRM Rev 1 7 09 2011 MC1322x Simple Media Access Controller SMAC Reference Manual...

Страница 2: ...claims any and all liability including without limitation consequential or incidental damages Typical parameters that may be provided in Freescale Semiconductor data sheets and or specifications can a...

Страница 3: ...Hardware Support 2 2 2 3 Optional Modules 2 2 2 3 1 OTAP Module 2 2 2 3 2 Security Module 2 3 2 4 MC1322x SMAC Messages 2 3 2 4 1 Message Types 2 4 2 4 2 Message State Machine 2 6 2 4 3 Message Constr...

Страница 4: ...MLMESetChannelRequest 3 14 3 2 20 MLMESetPromiscuousMode 3 15 3 2 21 MLMESetWakeupSource 3 15 3 2 22 MLMETestMode 3 16 3 3 Security Module API 3 17 3 3 1 CipherConfigure 3 17 3 3 2 CipherEngineInit 3...

Страница 5: ...erences are as follows MC1322x SMAC does not have blocking functions MC1322x SMAC has a new Radio Management module which allows management of multiple messages depending on the application needs MC13...

Страница 6: ...oards EVK Evaluation Kit GUI Graphical User Interface IDE Integrated Development Environment MAC Medium Access Control MAC2 Message Authentication Code MCU MicroController Unit NVM Non volatile Memory...

Страница 7: ...ons see the MC1322x SMAC Demonstration Applications User s Guide 22xSMACDAUG for more information on these applications To use any of the existing applications available in the MC1322x SMAC users must...

Страница 8: ...e of RAM is available versus the M13224V Some drivers present in the MC13224 ROM have been removed and these include the ADC LCDfont and SSI drivers These drivers are still available as library functi...

Страница 9: ...more information on BeeKit refer to the BeeKit Wireless Connectivity Toolkit User s Guide BKWCTKUG For more information on the Codebase as it applies to MC1322x SMAC refer to the MC1322x SMAC Demonstr...

Страница 10: ...MC1322x SMAC Introduction MC1322x SMAC Reference Manual Rev 1 7 1 4 Freescale Semiconductor Figure 1 1 Example Project Folder Structure...

Страница 11: ...Diagram The Freescale MC1322x is a Platform in a Package PiP which integrates an RF transceiver modem MCU AES ciphering and is fully compliant with the IEEE 802 15 4 standard The MC1322x SMAC uses its...

Страница 12: ...t after exporting a solution with the projects correctly configured For more information on exporting projects see the BeeKit Wireless Connectivity Toolkit User s Guide BKWCTKUG and the BeeKit on line...

Страница 13: ...emented on 22x SMAC and the MC1322x see Annex B of the IEEE standard 802 15 4 2003 To enable security features the security module must first be initialized then the key and counter must be set After...

Страница 14: ...e functions call the Radio Management handle_new_message function Because the messages are processed by their states the process_radio_msg function must also be called periodically to run the message...

Страница 15: ...itial_state_c MSG_RX_PASSED_TO_DEVICE MSG_RX_ACTION_STARTED MSG_RX_SYNC_FOUND MSG_RX_TIMEOUT_FAIL MSG_RX_ACTION_COMPLETE_SUCCESS MSG_RX_ACTION_COMPLETE_FAIL MSG_RX_RQST_ABORT MSG_RX_ABORTED MAX_MSG_RX...

Страница 16: ...ed during the period from putting the message in the message queue until it is in a final state The final state is any of the following states action complete aborted or timeout occurs Modifying data...

Страница 17: ...8 bit definition int16_t Signed 16 bit definition int32_t Signed 32 bit definition Usage These data types are used in the MC1322x SMAC project as well as in the applications projects They are defined...

Страница 18: ...declared as uint8_t data smac_pdu_size 18 3 The application initiates the message using the MSG_INIT macro This macro is used as follow MSG_INIT the message pointer to the data buffer callback pointer...

Страница 19: ...Put in the queue an RX message to put the transceiver in reception MLMERXEnableRequest a_RX_msg TIME_OUT The following code snippets examples can be used for application development Validates if a TX...

Страница 20: ...MC1322x SMAC Software Architecture MC1322x SMAC Reference Manual Rev 1 7 2 10 Freescale Semiconductor...

Страница 21: ...ws the MC1322x SMAC API to call a subroutine or function defined in the application layer This type is defined for void functions that do not receive parameters typedef void callback_t void This type...

Страница 22: ...lTest_c Returned by ciphering functions when a function tries to perform a ciphering deciphering operation but the cipher engine has failed its initialization gAuthenticationFailed_c When the cipherin...

Страница 23: ...ents mTimingRef This argument indicates to reference clock to be used it could be gTimerRef_2Khz_c or gTimerRef_32Khz_c mTimeout Time out referenced to the main clock The value is on RTC ticks pfUserC...

Страница 24: ...led because this function processes the pending messages This function does not perform blocking which is different than previous SMAC versions NOTE Consider all the possible messages states as explai...

Страница 25: ...an be read from the data buffer of the message To properly process an ED message as well as a TX or RX message process_radio_msg must be periodically called at least until all the messages in the mess...

Страница 26: ...UCCESS state read the energy detect value at msg pu8Buffer u8Data 0 This function does not perform blocking which is different than previous SMAC versions NOTE To perform energy detect on two or more...

Страница 27: ...ID SW_SMAC_VERSION SW_BOOTSTRAP_VERSION Buffer A pointer to the buffer where the version will be written Returns gFailOutOfRange_c If the requested Entity is not part of the stored ones gSuccess_c If...

Страница 28: ...HibClock argument is not a valid value gSuccess_c In any other case Usage Configures a wakeup source using MLMESetWakeupSource Must have an assigned interrupt handler if needed CrmAssignHandler can be...

Страница 29: ...rn_t MLMEPAOutputAdjust uint8_t u8Power Arguments u8Power 8 bit value for the required output power Returns gFailOutOfRange_c If u8Power exceeds the maximum power value 0x11 gFailNoValidCondition_cIf...

Страница 30: ...n void Arguments None Returns void Usage Fills the logic for this function or leaves it void 3 2 13 MLMEPHYSoftReset The MLMEPHYSoftReset function is called to perform a soft reset to the SoC This fun...

Страница 31: ...ta Sheet Prototype FuncReturn_t MLMEPHYXtalAdjust uint8_t u8CoarseTrim uint8_t u8FineTrim Arguments u8CorseTrim 8 bit value representing the coarse trim value to the oscillator Max value is 0x1f u8Fin...

Страница 32: ...Simply calls MLMERXDisableRequest passing the message to be disabled as parameter NOTE This function can be used to abort the reception of a message prior to a timeout event or to disable the receive...

Страница 33: ...ction does not perform blocking which is different than previous SMAC versions Notes u32Timeout value of zero causes the receiver to never timeout and stay in receive mode until a data packet is recei...

Страница 34: ...u8ScanValPerChann each element in the array corresponds to each channel u8ScanValPerChann CHANNEL11 is the energy value at channel 11 while u8ScanValPerChann CHANNEL26 is the energy value at channel...

Страница 35: ...us mode is on TRUE or off FALSE Returns gSuccess_c This is always the returned value Usage Calls MLMESetPromiscuousMode with TRUE or FALSE depending on desired mode of operation NOTE This function mus...

Страница 36: ...io back into idle mode Continuos RX Places the radio into receive mode and allows developers to look for any spectral issues related to the RX section of the radio Also this mode can be used to measur...

Страница 37: ...le The ciphering process is base on AES 128 and supporting three operation modes CTR CBC CCM For further details about MC1322x Advanced Security Module refer to the MC1322x Reference Manual 3 3 1 Ciph...

Страница 38: ...cess_c Configuration action was performed 3 3 2 CipherEngineInit Call the CipherEngineInit function to initiate the security module This function allows carrying out a self test to verify encryption e...

Страница 39: ...2CipherBuffer uint8_t u8BufferLength FuncReturn_t CipherMsgU8 uint8_t pu8CipherBuffer uint8_t u8BufferLength cipher_mode_t is an enumeration cipher_key_t and ctr_value_t are structures defined at Secu...

Страница 40: ...ed at the same buffer u8BufferLength Buffer length in bytes Returns gFailTest_c CipherEngineInit has not been executed or self test failed gAuthenticationFailed_c Received MAC2 does not match with the...

Страница 41: ...unction is currently provided For more details about how an application uses the OTAP module see the MC1322x SMAC Demonstration Applications User s Guide 22xSMACDAUG 3 4 1 OTAP_data_indication_execute...

Страница 42: ...bOtapExecute endif gbRdyToProcessEvnt TRUE 3 4 2 OTAP_execute OTAP_execute function executes all the OTAP tasks Prototype void OTAP_execute void Arguments None Returns None Usage OTAP_execute must be...

Страница 43: ...ments pRxMsg A message of RX type OTAP will check the incoming data on this message this message can be the same RX message from the application or the application shall copy the data from its buffer...

Страница 44: ...RfSignalANT2_c gRfSignalTXON_c or gRfSignalRXON_c depending on which signal is going to be configured function gRfSignalFunctionGPIO_c gRfSignalFunction1_c or gRfSignalFunction2_c based on which funct...

Страница 45: ...CcaThreshold CCA and ED threshold value Returns None Usage Call this function with TRUE or FALSE depending on the desired mode SetEdCcaThreshold 0x40 NOTE If SetEdCcaThreshold is not called the thresh...

Страница 46: ...eKit Platform Editor to configure the complementary PA 3 5 4 SetDemulatorMode SetDemulatorMode selects either Non coherent Detect NCD or Differential Chip Detect DCD mode If the SetDemulatorMode optio...

Страница 47: ...ckMode FALSE NOTE When setting Lock Mode the following conditions must be true Current channel different than gChannel26_c Current power level must be one of the available levels when using Lock Mode...

Страница 48: ...ves MC1322x SMAC Reference Manual Rev 1 7 3 28 Freescale Semiconductor Returns None Usage Call this function to configure the radio and for low power mode operation RadioInit PLATFORM_CLOCK gDigitalCl...

Отзывы:

Нет отзывов