diff --git a/doc/appsFeatures/apps-featured/sdr/SDRBlockDiagram.PNG b/doc/appsFeatures/apps-featured/sdr/SDRBlockDiagram.PNG new file mode 100644 index 000000000..d821d1a44 Binary files /dev/null and b/doc/appsFeatures/apps-featured/sdr/SDRBlockDiagram.PNG differ diff --git a/doc/appsFeatures/apps-featured/sdr/appSDR.rst b/doc/appsFeatures/apps-featured/sdr/appSDR.rst index 507252ead..0621bb032 100644 --- a/doc/appsFeatures/apps-featured/sdr/appSDR.rst +++ b/doc/appsFeatures/apps-featured/sdr/appSDR.rst @@ -1,5 +1,72 @@ SDR transceiver ############### +.. image:: SDRBlockDiagram.PNG + :scale: 75 % + :align: center + +Receiver Specifications +*********************** + ++-------------------------------+-------------------------------------------------+ +| Architecture: | Direct Digital Sampling | ++-------------------------------+-------------------------------------------------+ +| ADC Sampling Rate: | 125Msps | ++-------------------------------+-------------------------------------------------+ +| ADC Resolution: | 14 bits | ++-------------------------------+-------------------------------------------------+ +| Wideband Frequency Coverage: | 25 kHz - 62.25 MHz | ++-------------------------------+-------------------------------------------------+ +| MDS (min. detectable signal): | MDS (typ)@ 500Hz BW | ++-------------------------------+-------------------------------------------------+ +| Preamp OFF at 14MHz | -113dBm | ++-------------------------------+-------------------------------------------------+ +| Preamp +15dB at 14MHz | -130dBm | ++-------------------------------+-------------------------------------------------+ +| Preamp +30dB at 50MHz | -135dBm | ++-------------------------------+-------------------------------------------------+ +| | More MDS measurements. | ++-------------------------------+-------------------------------------------------+ +| Preselectors: | Available as add-on module (comming soon) | ++-------------------------------+-------------------------------------------------+ +| | User can also connect own preselectors/filters | ++-------------------------------+-------------------------------------------------+ + +Transmitter Specifications +************************** + ++-------------------------------+--------------------------------------------------------------------------------------+ +| Architecture: | Direct Digital Up-conversion | ++-------------------------------+--------------------------------------------------------------------------------------+ +| TX DAC Sampling Rate: | 125 Msps | ++-------------------------------+--------------------------------------------------------------------------------------+ +| TX DAC Resolution: | 14 bits | ++-------------------------------+--------------------------------------------------------------------------------------+ +| RF Output Power: | up to 10 W CW and SSB at @ 13.8 V input voltage (max. 15 V) | ++-------------------------------+--------------------------------------------------------------------------------------+ +| Transmitter Frequency Range: | 160 - 10 m (amateur bands only)* | ++-------------------------------+--------------------------------------------------------------------------------------+ +| Low Pass PA Filter Bands: | 160m / 80 m / 40 m / 30m / 20 m / 17m / 15m / 12m / 10m / 6 m | ++-------------------------------+--------------------------------------------------------------------------------------+ +| | (possibility to changed it to any range 1.8 - 50 MHz) | ++-------------------------------+--------------------------------------------------------------------------------------+ +| Emission Modes Types: | A1A (CWU, CWL), J3E (USB, LSB), A3E (AM), F3E (FM), DIGITAL (DIGU, DIGL) | ++-------------------------------+--------------------------------------------------------------------------------------+ +| | DIGITAL (DIGU, DIGL) | ++-------------------------------+--------------------------------------------------------------------------------------+ +| Harmonic Radiation: | better than -45 dB | ++-------------------------------+--------------------------------------------------------------------------------------+ +| 3rd-Order IMD: | better than -35 dB below PEP @ 14.2 MHz 10 Watts PEP | ++-------------------------------+--------------------------------------------------------------------------------------+ +| Cooling: | copper heat spreader | ++-------------------------------+--------------------------------------------------------------------------------------+ + + +.. note:: + C25 also supports 6m operation and has all necessary output filters for 6m, anyhow STEMlab 125-14 ouput signal is not pure enough to comply harmonic regulations for 6m + + + + What is in the box ****************** @@ -168,3 +235,460 @@ On Windows 10 you might get warning of Unknown Publisher you can procede with in :scale: 75 % :align: center +General Specifications +********************** + ++-----------------------------------------------+-------------------------------------------------------------------------------------+ +|Antenna Connector: | ANT1 and ANT2 available on SMA connectors Included one cable with SMA to SO-239 UHF | ++-----------------------------------------------+-------------------------------------------------------------------------------------+ +|Antenna Impedance: | 50 Ohm Unbalanced | ++-----------------------------------------------+-------------------------------------------------------------------------------------+ +|RF Output Power: | up to 10 W CW and SSB at 13.8 V input voltage (max. 15 V) | ++-----------------------------------------------+-------------------------------------------------------------------------------------+ +|Maximum Interconnect Cable Length Ethernet: | 100 meters (328 feet), Category 5 cable | ++-----------------------------------------------+-------------------------------------------------------------------------------------+ +|Power connector: | PowerPole | ++-----------------------------------------------+-------------------------------------------------------------------------------------+ + + +Measurement instruments specifications +###################################### + + +Oscilloscope +************ + ++-------------------------------+-----------------------+ +| Input channels | 2 | ++-------------------------------+-----------------------+ +| Input channels connector | BNC | ++-------------------------------+-----------------------+ +| Bandwidth | 50 MHz | ++-------------------------------+-----------------------+ +| Resolution | 14 bit | ++-------------------------------+-----------------------+ +| Memory depth | 16384 Samples Max. | ++-------------------------------+-----------------------+ +| Sampling Rate | 125 MS/s | ++-------------------------------+-----------------------+ +| Input range | +/- 1 V or +/- 20 V | ++-------------------------------+-----------------------+ +| Input coupling | AC/DC | ++-------------------------------+-----------------------+ +| Minimal Voltage Sensitivity | ±0.244 mV / ±2.44 mV | ++-------------------------------+-----------------------+ +| External Trigger connector | BNC | ++-------------------------------+-----------------------+ +| Input coupling | AC/DC | ++-------------------------------+-----------------------+ + + + +Signal generator +**************** + ++---------------------------------------+-----------------------+ +| Output channels | 2 | ++---------------------------------------+-----------------------+ +| Output channels connector | BNC | ++---------------------------------------+-----------------------+ +| Bandwidth | 50 MHz | ++---------------------------------------+-----------------------+ +| Resolution | 14 bit | ++---------------------------------------+-----------------------+ +| Signal buffer | 16384 Samples Max. | ++---------------------------------------+-----------------------+ +| Sampling Rate | 125 MS/s | ++---------------------------------------+-----------------------+ +| Output range | +/- 1V | ++---------------------------------------+-----------------------+ +| Frequency Range | 0 - 50 MHz | ++---------------------------------------+-----------------------+ +| Output impedance | 50 ohm | ++---------------------------------------+-----------------------+ +| External Trigger connector | BNC | ++---------------------------------------+-----------------------+ + + + +Spectrum analyzer +***************** + ++-------------------------------+--------------------+ +| Input channels | 2 | ++-------------------------------+--------------------+ +| Input channels connector | BNC | ++-------------------------------+--------------------+ +| Bandwidth | 0 - 62 MHz | ++-------------------------------+--------------------+ +| Dynamic Range | -80dBm | ++-------------------------------+--------------------+ +| Input noise level | < -119 dBm/Hz | ++-------------------------------+--------------------+ +| Input range | +/- 1V | ++-------------------------------+--------------------+ +| Frequency Range | 0 - 50 MHz | ++-------------------------------+--------------------+ +| Input impedance | 1 MΩ / 10 pF | ++-------------------------------+--------------------+ +| Spurious frequency components | -90 dBFS Typically | ++-------------------------------+--------------------+ + + +Logic analyzer +************** + ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Input channels | 8 | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Max. sample rate | 125 MS/s | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Fastest input signal | 50 MHz | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Supported protocols: | I2C, SPI, UART | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Input voltage levels | 2.5 V - 5.5 V | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Threshold: | 0.8 V for logic low | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| | 2.0 V for logic high | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Input impedance | 100 kohm 3 pF | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Sample depth | 1 MS (typical*) | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Trigger resolution | 8 ns | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ +| Min. detectable pulse length | 10 ns | ++-----------------------------------------------+-----------------------------------------------------------------------------------------------+ + + +.. note:: + + Acquired data is compressed therefore the size of data than can be captured depends on activity of signal on LA inputs. + For I2C, SPI & UART signals 1MS is typical sample depth. + All instrumentation applications are WEB based and don’t require the installation of any native software. + Users can access them via a browser using their smartphone, tablet or a PC running any popular operating systems (MAC, Linux, Windows, Android and iOS). + + +General Electrical specifications +################################# + ++-----------------------+-----------------------------------------------------------------------+ +| Power Requirements: | +13.8 V DC nominal ± 15 % (Transmitter output specified at 13.8 V DC) | ++-----------------------+-----------------------------------------------------------------------+ +| Power Consumption: | 2 A | ++-----------------------+-----------------------------------------------------------------------+ + +Mechanical specifications +######################### + ++---------------------------+----------------+ +| Height: | 100 mm | ++---------------------------+----------------+ +| Width: | 340 mm | ++---------------------------+----------------+ +| Depth: | 215 mm | ++---------------------------+----------------+ +| Weight: | 5 kg | ++---------------------------+----------------+ +| Operating temperature: | -10*C to +50*C | ++---------------------------+----------------+ + +.. _front: + +Front panel controls and connections +#################################### + + +.. image:: Front_panel_controls_and_connections.png + +Power button +************ + +Momentarily pressing power button **(1)** will turn the HAMlab ON. It normally takes 30s from the button press until the HAMlab is ready to be used. Once HAMlab is ON, holding the power button pressed will cause the proper shut down of the device. Blue LED indication on the power button indicates that device is turned on. + +.. note:: + In case that system halts and becomes unresponsive, device can be turned off by holding power button for a few seconds / until the blue LED is turned off. + + +SDR +*** + +Microphone connector (RJ45) +--------------------------- + +The HAMlab 80-10 10W front microphone connector **(2)** can support Kenwood KMC 30 electret microphone +or compatible types. + +.. image:: microfono-kmc-30-ml.jpg + +Front panel view microphone pinout + ++-----+----------+ ++ Pin | Function + ++=====+==========+ +| 1 | NC | ++-----+----------+ +| 2 | 8V DC | ++-----+----------+ +| 3 | Ground | ++-----+----------+ +| 4 | PTT | ++-----+----------+ +| 5 | Ground | ++-----+----------+ +| 6 | MIC | ++-----+----------+ +| 7 | NC | ++-----+----------+ +| 8 | NC | ++-----+----------+ + +CW Key / paddle jack +-------------------- + +The CW key/paddle jack **(3)** is a ¼ inch TRS phone plug. +Tip - DOT +Ring - DASH +The common is connected to the sleeve. + + +.. note:: + 3.3V Max input. + + +For an iambic paddle, the tip is connected to the dot paddle, the ring is connected to the dash paddle and the sleeve is connected to the common. For a straight key or a keyer output, connect to the tip and leave the ring floating. The common is connected to the sleeve. + +.. note:: + + Currently keyer is not supported by software. Software support for it will be availabe in one of incomming software updates. + + +Phones +------ + +The HAMlab 80-10 10W supports a stereo headset with headphone ¼ inch TRS phone plug **(4)** . +Mono or TS connector that grounds the “ring” portion of the connector should not be used! + + + +Logic analyzer +-------------- + +0-7 are logic analyzer inputs. +G - common ground. + + +.. note:: + + Logic analyzer inputs **(5)** can only be used when running Logic analyzer WEB app. + + + +Oscilloscope +------------ + + **(6)** - IN1 + **(7)** - IN2 + **(8)** - EXT. TRIG. + +IN1, IN2 and EXT. TRIG. are oscilloscope inputs. + +.. note:: + + These inputs are active and can be used only when Oscilloscope+Signal generator WEB application is running. + + +Signal generator +---------------- + + **(9)** - OUT1 + **(10)** - OUT2 + +OUT1 and OUT2 are signal generator outputs. + +.. note:: + + These two outputs are active and can be controlled only when Oscilloscope+Signal generator WEB application is running. + + +.. note:: + + To get expected signals from the signal generator, outputs must be 50ohm terminated. + + + + +.. _back: + +Back panel controls and connections +################################### + + +.. image:: Back_panel_controls_and_connections.png + + +ANT - TRANSCEIVER ANTENNA PORTS [1,2] +************************************* + +ANT1 **(1)** is SO-239 50 ohm connector, while ANT2 **(2)** is BNC 50 ohm connector. + + +User can connect transmitter output to ANT1 or ANT2 by properly connecting SMA cable inside the chassis to one of ANT connectors. Software switching between ANT1 and ANT2 is not available in HAMlab 80-10 10W version. + +.. danger:: + + THIS UNIT GENERATES RADIO FREQUENCY (RF) ENERGY. USE CAUTION AND OBSERVE PROPER SAFETY PRACTICES REGARDING YOUR SYSTEM CONFIGURATION. WHEN ATTACHED TO AN ANTENNA, THIS RADIO IS CAPABLE OF GENERATING RF ELECTROMAGNETIC FIELDS WHICH REQUIRE EVALUATION ACCORDING TO YOUR NATIONAL LAW TO PROVIDE ANY NECESSARY ISOLATION OR PROTECTION REQUIRED, WITH RESPECT TO HUMAN EXPOSURE! + +.. danger:: + + NEVER CONNECT OR DISCONNECT ANTENNAS WHILE IN TRANSMIT MODE. THIS MAY CAUSE ELECTRICAL SHOCK OR RF BURNS TO YOUR SKIN AND DAMAGE TO THE UNIT. + + +AUX1 +**** + +RX1 IN - direct feed to the first receiver pre-amp and attenuators. + +RX1 OUT - an output from the antenna feeding + + +By default HAMlab 80-10 10W comes with loopback cable connected from RX1 IN to RX1 OUT. User can also use this two connectors to insert external filters or preamplifier. + + +.. note:: + This input is not protected by any ESD circuitry, therefore device connected to the RX1 OUT Output is susceptible to possible damage by ESD from an EMP event if the connected device does not have adequate ESD protection circuitry. + +.. warning:: + Be aware that Preamp1 and Preamp 2 are both wide band amplifiers covering the whole bandwidth of 55MHz. + It is not recommended to use the Preamps on a large Antenna without a Preselector connected (this would cause overload and intermodulation from strong broadcast signals outside the Amateur Radio Bands)! + +AUX2 +**** + +RX2 IN - secondary 50ohm receiver input that can be used as a second panadapter in Power SDR software +or to as feedback signal for pre-distortions (Pure Signal tool). + + +XVTR (TX2 OUT) - secondary transmitter can be used to drive external PA +Max. output power is around 10 dBm @ 50ohm. + +However, currently there is no support in HPSDR for a second TX output. + +Power and Fuses +*************** + +The HAMlab 80-10 10W is designed to operate from a 13.8 volt nominal DC supply and required at least 4A. + +.. danger:: + + This unit must only be operated with the electrical power described in this manual. NEVER CONNECT THE +13.8VDC POWER CONNECTOR DIRECTLY TO AN AC OUTLET. This may cause a fire, injury, or electrical shock. + + +The HAMlab 80-10 10W requires 13.8 VDC @ 4 A measured at the radio in order to transmit maximum wattage. Multiple power cable connections between the power supply and the HAMlab 80-10 10W, a poorly regulated power supply, undersized power cable and very long power cable lengths will result in a voltage drop, especially under load. Any voltage deviation from 13.8 VDC will result in lower power output that the 10W nominal specification. + + +For best results, select a linear or switching power supply that is well regulated and free of internally generated radio frequency noise. “Birdies” generated by a poorly filtered supply can often appear as signals in the Power SDR Panadapter display. + + +The Anderson Powerpole™ connector contains 45 Amp pins to minimize voltage drop during transmit. The RED connection should be connected to the positive (+) lead of the power source. The BLACK connection should be connected to the negative (-) lead of the power source. + + +I - If you choose to use your own Powerpole cabling, be sure to properly size the wire and the Powerpole connector to minimize voltage drop during transmit. Excessive voltage drop can cause lower transmit power output levels. + + +There are two internal fuses in the HAMlab. One is protecting whole system while the other one is just for the transceiver. If you ever need to replace the internal fuse, remove the top cover and the shield of the power board. + + +.. image:: IMG_20161202_105403.jpg + +.. image:: IMG_20161202_105424.jpg + +.. danger:: + + FUSE CURRENT RATING SHOULD NOT BE HIGHER THAN 3.15A AMPS! FAILURE TO PROPERLY USE THIS SAFETY DEVICE COULD RESULT IN DAMAGE TO YOUR RADIO, POWER SUPPLY, OR CREATE A FIRE RISK. + + +Chassis ground +************** + +This is a thumbscrew for attaching an earth ground to the chassis of the radio. Grounding is the most important safety enhancement you can make to your shack. Always ground the HAMlab to your station RF ground using high quality wiring with the length being as short as possible. +Braided wire is considered the best for ground applications. Your station ground should be a common point where all grounds come together. You will likely be using a PC and a DC power source so be sure to ground these devices together as well. + + +AUDIO +***** + +Audio USB connector +USB 2.0 Cable - A-Male to Mini-B must be used to connect HAMlab audio sound card with the PC in order to be able to use Phone, MIC and speaker connector for voice communication. + +.. note:: + USB connector is only available on HAMlab 80-10 10W model. For new models audio codec is used / audio is transferred over ethernet. + +Speaker connector +1/8” TRS stereo connector can be used to connect stereo powered computer speakers. + +.. note:: + Do not use a mono or TS connector that grounds the “ring” portion of the connector. + + +CTRL +**** + +DB9 connector is used to control external equipment. +PTT OUT relay is connected between pins 6 and 7. + +.. note:: + + Other pins are at the moment not in use and should be left unconnected. + + +DATA +**** + +LAN +This is network connection to the HAMlab. It is an auto-sensing 100 megabit or 1 gigabit Ethernet port that enables you to connect HAMlab to your local network or directly to PC. + + +USB +This USB port is used to connect WIFI dongle when user would like to connect to HAMlab wirelessly. + +.. note:: + + Recommended WIFI USB dongle is Edimax EW7811Un. In general all WIFI USB dongles that use RTL8188CUS chipset should work. + + +SD card +HAMlab software is running from SD card. + +.. note:: + + HAMlab comes with pre installed SD card HAMlab OS. Upgrade can be done using OS upgrade application from the HAMlab application menu and there is no need to remove the SD card. Therefore user should remove the SD card and reinstall SD card software only if system gets corrupted or stops working due to SD card failure reason. In this case only official HAMlab OS should be installed on the SD card for proper operation. + + +SDR Specifications +################## + +Highlights +********** + ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Architecture: | direct sampling / internal high performance 14-bit A/D and D/A 125 Msps converters (no sound card required) | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Band coverage: | All band receiver and 160-6m transmitter | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Transmit power: | up to 10 W | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Wideband Frequency Coverage: | 25 kHz - 62.25 MHz | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Connection to PC: | 1 Gbit ethernet or WIFI connection | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Software: | Power SDR HAMlab edition | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Phones and MIC connection: | available on the front panel | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| Secondary Rx and Tx channel: | available through back panel BNC connectors (RX2 IN, XVTX) | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ +| CW key and paddle input: | available through front panel jack connector | ++-------------------------------+-------------------------------------------------------------------------------------------------------------+ diff --git a/doc/developerGuide/ecosystem/ecosystem.rst b/doc/developerGuide/ecosystem/ecosystem.rst index 85aaf4673..1778be9a2 100644 --- a/doc/developerGuide/ecosystem/ecosystem.rst +++ b/doc/developerGuide/ecosystem/ecosystem.rst @@ -266,8 +266,8 @@ FPGA and device tree sources $ make -f Makefile.x86 fpga -Detailed instructions are provided for `building the FPGA `_ -including some `device tree details `_. +Detailed instructions are provided for :ref:`building the FPGA ` +including some :ref:`device tree details `. -------------------------------------- Device Tree compiler + overlay patches diff --git a/fpga/fpga.rst b/doc/developerGuide/fpga.rst similarity index 99% rename from fpga/fpga.rst rename to doc/developerGuide/fpga.rst index 69f1c5a09..e97c13e82 100644 --- a/fpga/fpga.rst +++ b/doc/developerGuide/fpga.rst @@ -99,6 +99,8 @@ on the first Red Pitaya release. +-------------------+------------------------------------------------------------------+ +.. _buildprocess: + **************** Building process **************** @@ -178,6 +180,9 @@ which will prepare an organized waveform window. $ make top_tb WAV=1 + +.. _devicetree: + *********** Device tree *********** diff --git a/fpga/regset.rst b/doc/developerGuide/regset.rst similarity index 100% rename from fpga/regset.rst rename to doc/developerGuide/regset.rst diff --git a/doc/developerGuide/software.rst b/doc/developerGuide/software.rst index 8e5e2728f..66c436734 100644 --- a/doc/developerGuide/software.rst +++ b/doc/developerGuide/software.rst @@ -13,7 +13,7 @@ Software os/ssh/ssh os/console/console os/network - ../../fpga/fpga + fpga comC scpi/scpi gpio/gpio