1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/* $Id: CC1000Control.nc,v 1.5 2010-06-29 22:07:44 scipio Exp $
* Copyright (c) 2000-2005 The Regents of the University of California.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* - Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* - Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the
* distribution.
* - Neither the name of the University of California nor the names of
* its contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
* THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGE.
*
* Copyright (c) 2002-2005 Intel Corporation
* All rights reserved.
*
* This file is distributed under the terms in the attached INTEL-LICENSE
* file. If you do not find these files, copies can be found by writing to
* Intel Research Berkeley, 2150 Shattuck Avenue, Suite 1300, Berkeley, CA,
* 94704. Attention: Intel License Inquiry.
*/
/**
* CC1000 internal radio control interface.
* @author Philip Buonadonna
* @aythor Jaein Jeong
*/
interface CC1000Control
{
/**
* Initialise the radio to its default state.
*/
command void init();
/**
* Tune the radio to one of the frequencies available in the CC1K_Params
* table. Calling Tune will allso reset the rfpower and LockVal
* selections to the table values.
*
* @param freq The index into the CC1K_Params table that holds the
* desired preset frequency parameters.
*/
command void tunePreset(uint8_t freq);
/**
* Tune the radio to a given frequency. Since the CC1000 uses a digital
* frequency synthesizer, it cannot tune to just an arbitrary frequency.
* This routine will determine the closest achievable channel, compute
* the necessary parameters and tune the radio.
*
* @param The desired channel frequency, in Hz.
*
* @return The actual computed channel frequency, in Hz. A return value
* of '0' indicates that no frequency was computed and the radio was not
* tuned.
*/
command uint32_t tuneManual(uint32_t DesiredFreq);
/**
* Turn the CC1000 off
*/
async command void off();
/**
* Shift the CC1000 Radio into transmit mode.
*/
async command void txMode();
/**
* Shift the CC1000 Radio in receive mode.
*/
async command void rxMode();
/**
* Turn off the bias power on the CC1000 radio, but leave the core and
* crystal oscillator powered. This will result in approximately a 750
* uA power savings.
*/
async command void coreOn();
/**
* Turn the bias power on. This function must be followed by a call to
* either rxMode() or txMode() to place the radio in a recieve/transmit
* state respectively. There is approximately a 200us delay when
* restoring bias power.
*/
async command void biasOn();
/**
* Set the transmit RF power value. The input value is simply an
* arbitrary index that is programmed into the CC1000 registers. Consult
* the CC1000 datasheet for the resulting power output/current
* consumption values.
*
* @param power A power index between 1 and 255.
*/
command void setRFPower(uint8_t power);
/**
* Get the present RF power index.
*
* @return The power index value.
*/
command uint8_t getRFPower();
/**
* Select the signal to monitor at the CHP_OUT pin of the CC1000. See
* the CC1000 data sheet for the available signals.
*
* @param LockVal The index of the signal to monitor at the CHP_OUT pin
*/
command void selectLock(uint8_t LockVal);
/**
* Get the binary value from the CHP_OUT pin. Analog signals cannot be
* read using function.
*
* @return 1 - Pin is high or 0 - Pin is low
*/
command uint8_t getLock();
/**
* Returns whether the present frequency set is using high-side LO
* injection or not. This information is used to determine if the data
* from the CC1000 needs to be inverted or not.
*
* @return TRUE if high-side LO injection is being used (i.e. data does NOT need to be inverted
* at the receiver.
*/
command bool getLOStatus();
}
|
