ir_inject
==========

Presentation
------------
**ir_inject** allows to inject IR signals using an `IRMA device <devices.html#irma-device>`_. It allows to choose the frequency of the transmitter (*FREQUENCY* parameter, set to 38 kHz by default).
You can inject a signal as raw data using the *DATA* parameter (you have to provide a list of integers), or you can select a specific protocol using the *PROTOCOL* parameter and provide the *CODE* and *CODE_SIZE* parameter, describing the IR code to transmit.

Compatible devices
------------------

 * `IRMA Device <devices.html#irma-device>`_

Input parameters
-----------------

+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+
| Name                                   | Default value                         | Possible values                                                         | Description                                                          |
+========================================+=======================================+=========================================================================+======================================================================+
| INTERFACE                              | irma0                                 | irmaX                                                                   | Interface to display                                                 |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+
| FREQUENCY                              | 38                                    | <integer>                                                               | Frequency to use                                                     |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+
| DATA                                   |                                       | <integers list>                                                         | Raw data to inject                                                   |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+
| PROTOCOL                               |                                       | NEC\|Sony\|RC5\|RC6\|Dish\|Sharp\|JVC\|Sanyo\|Mitsubishi\|Samsung\.\.\. | Protocol to use                                                      |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+
| CODE                                   |                                       | <hexadecimal>                                                           | Code to inject                                                       |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+
| CODE_SIZE                              |                                       | <integer>                                                               | Size of the code to inject (bits)                                    |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------------------+----------------------------------------------------------------------+

Output parameters
------------------

Output parameters
------------------

This module doesn't provide any output parameters. 

Usage
------
Basic Usage
^^^^^^^^^^^^

If you want to transmit a raw signal, use the following command :
::

	$ mirage ir_inject DATA=1200,500,5800,1000,500
	[INFO] Module ir_inject loaded !
	[INFO] Injecting ...
	[SUCCESS] Injection done !
	[INFO] Mirage process terminated !


If you want to inject a specific code, you have to provide the parameters *PROTOCOL*, *CODE* and *CODE_SIZE*:
::

	$ mirage ir_inject PROTOCOL=NEC CODE=76044FF0 CODE_SIZE=32
	[INFO] Module ir_inject loaded !
	[INFO] Injecting ...
	[SUCCESS] Injection done !
	[INFO] Mirage process terminated !

Performing a replay attack
^^^^^^^^^^^^^^^^^^^^^^^^^^^

This module can be combined with `ir_sniff <modules.ir_sniff.html>`_ in order to perform replay attacks. You can launch this kind of attack by using the following command:

::

	$ mirage "ir_sniff|ir_inject"
	[INFO] Module ir_sniff loaded !
	[INFO] Module ir_inject loaded !
	[PACKET] << IR - NEC Packet | code (32 bits) =76044fc0 >>
	[INFO] Injecting ...
	[SUCCESS] Injection done !
	[INFO] Mirage process terminated !