manualshive.com logo in svg

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

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

MC1322x SMAC Software Architecture

MC1322x SMAC Reference Manual, Rev. 1.7

Freescale Semiconductor

2-3

 

•

OTAP-enabled target Board (The board having its firmware updated.)
— Download and run an OTAP-enabled application on the board. The currently loaded 

application will be replaced by the new application using the OTAP Programmer.
– The application being replaced must have its OTAP module property enabled when the 

project is generated in BeeKit.

— Any of the MC1322x development boards can be used as an OTAP enabled target board.

2.3.2

Security Module

The security module is a software component that allows the ciphering and deciphering of messages 
through its API. This section describes the procedure for implementing security in a MC1322x SMAC 
application.

The MC1322x SMAC security management module allows implementation of wireless security 
mechanisms. The MC1322x SMAC security module defines all functions required to cipher and decipher 
the messages to be sent or received with the MC1322x SMAC on the MC1322x transceiver. The cipher 
process is executed by the ASM module which implements the AES algorithm. It can perform CTR, CBC, 
and CCM. CCM is a combination of CTR and CBC. For further details about the security implemented 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 that, plain/cipher text can be ciphered/deciphered.

NOTE

The resulting ciphered/deciphered text is put on the same buffer where the 
plain text is provided, for CBC and CCM modes which generate Message 
Authentication Code, the provided buffer must also allocate 16 extra bytes 
for the MAC.

The Security Module API is as follows:

FuncReturn_t CipherEngineInit(void)
FuncReturn_t CipherConfigure(cipher_mode_t u8CipherMode, cipher_key_t * pCipherKey, 
ctr_value_t * pCtrValue)
FuncReturn_t CipherMsg (uint32_t * pu32CipherBuffer, uint8_t u8BufferLength)
FuncReturn_t DecipherMsg (uint32_t *pu32DecipherBuffer, uint8_t u8BufferLength)
FuncReturn_t CipherMsgU8(uint8_t *pu8CipherBuffer, uint8_t u8BufferLength)
FuncReturn_t DecipherMsgU8(uint8_t *pu8CipherBuffer, uint8_t u8BufferLength)

2.4

MC1322x SMAC Messages

This section describes the MC1322x SMAC messages, their types, operations and states. Send and receive 
are basic functions of the MC1322x SMAC and they are implemented as messages. Energy detection and 
radio idle time out are also implemented as messages. That is why messages are the core of the MC1322x 
SMAC and it is important to explain the messages in detail both in how are they structured and how they 
are processed and interfaced.

Содержание 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...

Отзывы:

Нет отзывов