com.rapplogic.xbee.api.wpan.TxRequest16 Maven / Gradle / Ivy

Go to download
/**
 * Copyright (c) 2008 Andrew Rapp. All rights reserved.
 *  
 * This file is part of XBee-API.
 *  
 * XBee-API is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *  
 * XBee-API is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *  
 * You should have received a copy of the GNU General Public License
 * along with XBee-API.  If not, see .
 */

package com.rapplogic.xbee.api.wpan;

import com.rapplogic.xbee.api.ApiId;
import com.rapplogic.xbee.api.XBeeAddress16;
import com.rapplogic.xbee.util.IntArrayOutputStream;

/**
 * Series 1 XBee.  16-bit address Transmit Packet.  This is received on the destination XBee
 * radio as a RxResponse16 response
 * 
 * API ID: 0x1
 * 
 * @author andrew
 *
 */
public class TxRequest16 extends TxRequestBase {
	
	private XBeeAddress16 remoteAddr16;
	
	/**
	 * 16 bit Tx Request with default frame id and awk option
	 * 
	 * Keep in mind that if you programmed the destination address with X-CTU, the unit is
	 * hex, so if you set MY=1234, use 0x1234.
	 * 
	 * @param remoteAddr16
	 * @param payload
	 */
	public TxRequest16(XBeeAddress16 remoteAddr16, int[] payload) {
		this(remoteAddr16, DEFAULT_FRAME_ID, Option.UNICAST, payload);
	}
	
	/**
	 * 16 bit Tx Request with frame id argument
	 * 
	 * 
	 * Payload size is limited to 100 bytes, according to MaxStream documentation.
	 * 
	 * @param remoteAddr16
	 * @param frameId
	 * @param payload
	 */
	public TxRequest16(XBeeAddress16 remoteAddr16, int frameId, int[] payload) {
		this(remoteAddr16, frameId, Option.UNICAST, payload);
	}
	
	/**
	 * Note: if option is DISABLE_ACK_OPTION you will not get a ack response and you must use the asynchronous send method
	 * 
	 * @param remoteAddr16
	 * @param frameId
	 * @param payload
	 * @param option
	 */
	public TxRequest16(XBeeAddress16 remoteAddr16, int frameId, Option option, int[] payload) {		
		this.remoteAddr16 = remoteAddr16;
		this.setFrameId(frameId);
		this.setOption(option);
		this.setPayload(payload);
	}

	public int[] getFrameData() {	
		// 3/6/10 fixed bug -- broadcast address is used with broadcast option, not no ACK
		
		IntArrayOutputStream out = new IntArrayOutputStream();

		// api id
		out.write(this.getApiId().getValue());
		// frame id (arbitrary byte that will be sent back with ack)
		out.write(this.getFrameId());
		// destination address (broadcast is 0xFFFF)
		out.write(remoteAddr16.getAddress());
		// options byte disable ack = 1, send pan id = 4
		out.write(this.getOption().getValue());		
		out.write(this.getPayload());

		return out.getIntArray();	
	}
	
	public ApiId getApiId() {
		return ApiId.TX_REQUEST_16;
	}
	
	public XBeeAddress16 getRemoteAddr16() {
		return remoteAddr16;
	}

	public void setRemoteAddr16(XBeeAddress16 remoteAddr16) {
		this.remoteAddr16 = remoteAddr16;
	}
	
	public String toString() {
		return super.toString() + 
			",remoteAddress16=" + this.remoteAddr16;
	}
}