ToCoNet_Nwk_bTx()

Explanation

Requests the transmission of radio packets on the relay net.

For more information on delivery, see the description of the tsTxDataApp structure.

About the address

You can choose between two delivery addresses.

If TOCONET_NWK_ADDR_NEIGHBOUR_ABOVE is specified, it is directly transmitted to the neighboring parent or repeater, and the LQI between the child and the parent or repeater can be aggregated to determine which parent or repeater is closer to the child.

Note: The accuracy of the LQI and distance is not high, and it is only possible to distinguish between very close (within 1m) and other positions.

Dst address	Remark
TOCONET_NWK_ADDR_NEIGHBOUR_ABOVE	Direct transmission to a reachable parent or repeater (or all of them if there are more than one).
TOCONET_NWK_ADDR_PARENT	The packet is delivered to the parent device. (Even if a repeater receives a packet, it cannot know the reception of the packet by ToCoNet_vRxEvent())

Arguments

Type	Name	Remark
tsToCoNet_Nwk_Context*	pContextNwk	A structure that manages the internal information of the relay network.
tsTxDataApp*	sTx	A structure containing the data to be sent.

Returns

Type	Remark
bool_t	TRUE: The request has been accepted.FALSE: not accepted.

Sample code

static tsToCoNet_NwkLyTr_Config sNwkLayerTreeConfig;
static tsToCoNet_Nwk_Context* pContextNwk;
...
	} else {
		// 
		tsTxDataApp sTx;
		memset(&sTx, 0, sizeof(sTx)); // Always clear 0 before you use it!
		uint8 *q =  sTx.auData;
	
		sTx.u32SrcAddr = ToCoNet_u32GetSerial();
	
		if (IS_APPCONF_OPT_TO_ROUTER()) {
			// Received once by the router in the application 
			//and redelivered from the router to the parent unit
			sTx.u32DstAddr = TOCONET_NWK_ADDR_NEIGHBOUR_ABOVE;
		} else {
			// The router does not receive the data in the 
			//application, but simply relays it
			sTx.u32DstAddr = TOCONET_NWK_ADDR_PARENT;
		}
	
		// construct the payload
		S_OCTET('T');
		S_OCTET(sAppData.sFlash.sData.u8id);
		S_BE_WORD(sAppData.u16frame_count);		
​
		// Sensor-specific data
		memcpy(q,pu8Data,u8Len);
		q += u8Len;
	
		sTx.u8Cmd = 0; // Takes a value of 0..7. Use this when you want to separate packet types.
		sTx.u8Len = q - sTx.auData; // Payload size
		sTx.u8CbId = sAppData.u16frame_count & 0xFF; // Number to be notified by TxEvent, not to the destination
		sTx.u8Seq = sAppData.u16frame_count & 0xFF; // Sequence number (to be notified to destination)
		sTx.u8Retry = sAppData.u8Retry;
​
		if (ToCoNet_Nwk_bTx(pNwk, &sTx)) {
			ToCoNet_Event_SetState(pEv, E_STATE_APP_WAIT_TX);
		} else {
			// ... Failed (sleep process)
			ToCoNet_Event_SetState(pEv, E_STATE_SLEEP);
		}