MX5 guides - images added

docs/11-Vehicle-Specific/Mazda-MX5-Miata/11-Miata-MX5-Quick-Start.md

@@ -70,7 +70,7 @@ Using the MAP line combined with an intake air temperature (IAT) sensor, the BMM
 
 ## Additional Steps for NA6 Vehicles
 
-The NA6 1.6L vehicles which use an AFM instead of a MAF require a few additional modifications to run with a BMM ECU. A manual NA6 do not have a variable throttle position sensor (TPS) like the automatic NA6, later model NAs and all NBs. An NA6 also needs an external intake air temperature (IAT) sensor wired in as the AFM which has one inside is typically removed. They also require a jumper for the ECU to control the fuel pump which was previously the job of the air flow meter.
+The NA6 1.6L vehicles which use an AFM instead of a MAF require a few additional modifications to run with a BMM ECU. A manual NA6 do not have a variable throttle position sensor (TPS) like the automatic NA6, later model NAs and all NBs. An NA6 also needs an external intake air temperature (IAT) sensor wired in as the AFM which has one inside is typically removed. They also require a jumper for the ECU to control the fuel pump which was previously the job of the air flow meter. Additionally, it is recommended to ground the sensors to the ECU rather than the chassis as detailed in the [NA6 ECU Grounding Guide](docs\11-Vehicle-Specific\Mazda-MX5-Miata\NA6-Grounding.md). 
 
 The first step is to disconnect the factory TPS sensor. **This is very important or it will cause a short circuit later.**. The TPS sensor location is shown in the image below.
 
@@ -110,7 +110,7 @@ In the final dialog box, select the default gauge layout (you can change this la
 
 ### Additional Tuner Studio Steps for an External Wideband Controller
 
-To set up the external wideband controller there are several additional steps in Tuner Studio. First, your display units should be set to AFR for this as already stated. If you forgot to do this earlier, press _CTRL + P_ to open the vehicle properties. Now, open the _Aux Sensors_ dialog under _Sensors_ and the _Full Pinout 3/3_ dialog under _Controllers_. As per the diagram below, set the _AFR ADC Input_ and _ADC Input_ to the pin corresponding with _O2S_ (pin 2C for the example). for the values in the _Aux Linear Sensor #1_ box you need to reference the manual of your wideband controller for what voltages correspond to its AFR outputs. In the example below, 0V corresponds to an AFR of 10.0 and 4.99V corresponds to an AFR of 19.98. Once these are set, click _Burn_.
+To set up the external wideband controller there are several additional steps in Tuner Studio. First, your display units should be set to AFR for this as already stated. If you forgot to do this earlier, press _CTRL + P_ to open the vehicle properties. Now, open the _Aux Sensors_ dialog under _Sensors_ and the _Full Pinout 3/3_ dialog under _Controllers_. As per the diagram below, set the _AFR ADC Input_ and _ADC Input_ to the pin corresponding with _O2S_ (pin 2C for the example). for the values in the _Aux Linear Sensor #1_ box you need to reference the manual of your wideband controller for what voltages correspond to its AFR outputs. In the example below, 0V corresponds to an AFR of 10.0 and 4.99V corresponds to an AFR of 19.98. Once these are set, click _Burn_. If TS does not exactly correspond to the readings on your wideband, you can adjust with the correction value.
 
 ![image](Miata-MX5-Quick-Start-Images/extwideband.png)
 

docs/11-Vehicle-Specific/Mazda-MX5-Miata/Miata-36T-Trigger.md

@@ -6,6 +6,8 @@ For Miatas, there are a range of upgraded trigger wheels available, most with 35
 
 The trigger wheel recommended for BMM ECUs is the 1999-2001 Mazda Protege 36-1 Trigger Wheel (part # ZM0111408). This trigger wheel is compatible with the stock crankshaft pulley and a Fluiddampr crankshaft pulley. If using an ATI damper, you must purchase a compatible trigger wheel.
 
+![image](36T-trigger\trig1.jpg)
+
 ## Installation
 
 Before completing this installation it is recommended to have the car running on a BMM ECU with the stock trigger wheel. This way, only a few parameters in the tune need to be changed to get the car working with this part.
@@ -16,25 +18,31 @@ Ensure the engine is off and disconnect the battery for safety.
 
 ### Remove Engine Belts
 
-Remove the engine belts obstructing access to the crankshaft pulley. Typically, there are two belts: the accessory belt which drives the power steering and A/C and the alternator belt which also drives the water pump. The belt tensioners are respectively located on the power steering pump (top right on the engine from the front) and the alternater (bottom left). With the belts removed, you should have clear access to the crankshaft pulley.
+Remove the engine belts obstructing access to the crankshaft pulley. Typically, there are two belts: the accessory belt which drives the power steering and A/C and the alternator belt which also drives the water pump. The belt tensioners are respectively located on the power steering pump (top right on the engine from the front) and the alternator (bottom left). With the belts removed, you should have clear access to the crankshaft pulley.
 
 ### Rotate Engine to Top Dead Center (TDC)
 
-Using a 21mm socket on the bolt in the centre of the crank pully, rotate the engine clockwise until the marks on the crank pulley line up with the timing marks on the timing belt cover.
+Using a 21mm socket on the bolt in the centre of the crank pulley, rotate the engine clockwise until the marks on the crank pulley line up with the timing marks on the timing belt cover.
+
+![image](36T-trigger/timing_marks_480x480.webp)
 
 ### Remove the Crankshaft Pulley
 
-Remove the crankshaft pulley by undoing the four 10mm bolts on the front. The large centre bolt doesn't need to be removed if using the stock or a Fluiddampr pulley. An ATI damper will require removal of the cranshaft bolt to install so consult their installation manual if required. Behind the pulley should be the OEM trigger wheel. Go ahead and remove it, put it in the bin or use it as a beer coaster.
+Remove the crankshaft pulley by undoing the four 10mm bolts on the front. The large centre bolt doesn't need to be removed if using the stock or a Fluiddampr pulley. An ATI damper will require removal of the crankshaft bolt to install so consult their installation manual if required. Behind the pulley should be the OEM trigger wheel. Go ahead and remove it, put it in the bin or use it as a beer coaster.
 
 ### Install the New Trigger Wheel
 
-The new trigger wheel can go on to the engine in two orientations, correctly and backwards. To radially allign the trigger wheel, there is a dowel pin on the crank which slots into a hole in the trigger wheel. At TDC, the dowel pin should be vertical or at the 12 o'clock position. The correct orientation is to put the trigger wheel on, as per the diagrams below, with the centre recessed part of the trigger pointing towards the crank, the white dot facing outwards and the missing tooth at approximately the 7 o'clock position when the engine is at TDC and the dowel pin is vertical. The trigger wheel is the wrong way around if the teeth are further fowards of the engine than the centre reccess, the white dot is facing towards the engine, or the missing tooth is at the 5 o'clock position at engine TDC.
+The new trigger wheel can go on to the engine in two orientations, correctly and backwards. To radially align the trigger wheel, there is a dowel pin on the crank which slots into a hole in the trigger wheel. At TDC, the dowel pin should be vertical or at the 12 o'clock position. The correct orientation is to put the trigger wheel on, as per the diagrams below, with the centre recessed part of the trigger pointing towards the crank, the white dot facing outwards and the missing tooth at approximately the 7 o'clock position when the engine is at TDC and the dowel pin is vertical. The trigger wheel is the wrong way around if the teeth are further forwards of the engine than the centre recces, the white dot is facing towards the engine, or the missing tooth is at the 5 o'clock position at engine TDC.
 
-If installing an ATI damper and trigger wheel or a Fluiddampr, consult the manual as the installation has several additional steps which include bolting the trigger wheel to the aftermarket crankshaft pulley damper. In the case of a Fluiddampr, the orientation of the Mazda 323 trigger wheel will be identical to installaton onto a stock pulley.
+![image](36T-trigger/trig4.png)
+
+![image](36T-trigger/trig5.png)
+
+If installing an ATI damper and trigger wheel or a Fluiddampr, consult the manual as the installation has several additional steps which include bolting the trigger wheel to the aftermarket crankshaft pulley damper. In the case of a Fluiddampr, the orientation of the Mazda 323 trigger wheel will be identical to installation onto a stock pulley.
 
 ### Re-Install Crank Pulley and Adjust Crank Sensor
 
-Re-install the crank pulley and the four 10mm bolts (109-151 inch/lbs 13-17 Nm). Check the clearance betweek the crank sensor and the tip of a tooth on the timing wheel, there should be a 0.5-1.5 mm or 0.020-0.059 inch gap between the tooth and the sensor. If you later come up with trigger errors, this gap may need to be reduced. To reduce the gap, loosen the 10mm bolt holding the crank sensor and wiggle it to the desired position.
+Re-install the crank pulley and the four 10mm bolts (109-151 inch/lbs 13-17 Nm). Check the clearance between the crank sensor and the tip of a tooth on the timing wheel, there should be a 0.5-1.5 mm or 0.020-0.059 inch gap between the tooth and the sensor. If you later come up with trigger errors, this gap may need to be reduced. To reduce the gap, loosen the 10mm bolt holding the crank sensor and wiggle it to the desired position.
 
 ### Re-Install Belts and Connect Battery
 
@@ -44,8 +52,10 @@ Re-install the accessory and alternator belts checking they are suitably tight.
 
 In the "Trigger" menu under the Base Engine tab, change the trigger type to 36/1 and the trigger angle advance to 75 degrees.
 
-If using a 36-2 trigger wheel instead, the first setting would be 36/2 and the advance will likely be different so check with the manufacutrer. In the case of a 36-2T trigger wheel for an ATI damper, the advance angle should be around 148 degrees.
+If using a 36-2 trigger wheel instead, the first setting would be 36/2 and the advance will likely be different so check with the manufacturer. In the case of a 36-2T trigger wheel for an ATI damper, the advance angle should be around 148 degrees.
 
-These settings will likely get the car started with the Mazda 323 timing wheel however the trigger angle advance may need to be iterated to perfectly match the timing on your car. To check or set the base timing, set the timing to fixed in TunerStudio and use a timing light on the crank to measure the timing. If the timing is not 10 degrees BTDC, iterate the trigger angle advance in TS until it is spot on. This is covered in "Set Base Timing" within the Miata Quick Start Guide.
+These settings will likely get the car started with the Mazda 323 timing wheel however the trigger angle advance may need to be iterated to perfectly match the timing on your car. To check or set the base timing, set the timing to fixed in TunerStudio and use a timing light on the crank to measure the timing. If the timing is not 10 degrees BTDC, iterate the trigger angle advance in TS until it is spot on. This is covered in "Set Base Timing" within the [Miata Quick Start Guide](docs\11-Vehicle-Specific\Mazda-MX5-Miata\11-Miata-MX5-Quick-Start.md).
 
-Now after ensuring your timing is reverted back to dynamic in TS, the installation should now be complete!
+![image](36T-trigger/trig6.png)
+
+Now after ensuring your timing is reverted back to dynamic in TS, the installation should now be complete!

docs/11-Vehicle-Specific/Mazda-MX5-Miata/Miata-COP-Conversion.md

@@ -35,19 +35,29 @@ For the other NA and NB Miatas utilizing a coil pack on the back of the valve co
 
 #### NA6 (1.6L)
 
+![image](<COP/COP wiring NA6.drawio.png>)
+
 #### NA8 94-95 (1.8L)
 
+![image](<COP/COP wiring NA8.drawio.png>)
+
 #### NA8 95+ /NB1 (1.8L)
 
-## Toyota Coil Pinout
+![image](<COP/COP wiring NB1.drawio.png>)
+
+### Toyota Coil Pinout
 
 From left to right on the coil is the ground, ECU signal, tachometer signal, and 12V. For later NA8 and NB1 Miatas, the tachometer signal does not need to be wired up.
 
-## R8 Coil Pinout
+![image](COP/Toyota_COP.drawio_480x480.webp)
+
+### R8 Coil Pinout
 
 From left to right on the coil is the ground, ECU signal, ground, and 12V. The two grounds can be connected together. Note that the R8 coils have no tachometer signal meaning that on NA6 and early NA8 cars, the tachometer will need to get its signal from the ECU. Later NA8s and NB1s do not have this issue.
 
-## COP Harness
+![image](COP/R8_COP.drawio_480x480.webp)
+
+### COP Harness
 
 To make the neatest harness, cut the wires to length with the coils installed in the car in their desired orientations. Leave a small amount of excess so there is no tension on the wiring harness and room in case a wire needs to be re-stripped. Make sure to cover each exposed solder joint with electrical tape or heat shrink then go over the entire harness with tape to protect it. It is recommended to check your harness wiring several times for shorts or mistakes before powering on the car.
 
@@ -58,3 +68,5 @@ For both coils, there are a range of third-party suppliers selling mounting brac
 ## ECU Dwell Time Setup
 
 The dwell times need to be modified in TunerStudio before starting the car with the new COPs. Recommended safe dwell settings are shown below for both Toyota and R8 COPs. Note that dwell times can vary significantly between different ignition coils and it is recommended to do some additional research on your specific coil. The longer the dwell time, the longer the coil charges for and the stronger the spark. Too little dwell will result in a weak spark and too much dwell can draw an excessive amount of current, possibly melting the coil.
+
+![image](COP/Dwell.png)

docs/11-Vehicle-Specific/Mazda-MX5-Miata/Miata-VVT.md

@@ -4,43 +4,55 @@ Tuning the NB2 BP-Z3/BP-VE VVT motor can be a daunting task. This guide will det
 
 ## Required Equipment
 
-Vehicle running an NB2 VVT motor
-Access to a dyno or a safe location to tune the vehicle using Virtual Dyno. An actual dyno is preferable to virtual dyno due to the accuracy of readings and ability to safely vary the operating point of the engine.
-Laptop with TunerStudio, MegaLog Viewer and optionally Virtual Dyno installed.
-Initial TunerStudio Configuration
+- Vehicle running an NB2 VVT motor.
+- Access to a dyno or a safe location to tune the vehicle using Virtual Dyno. An actual dyno is preferable to virtual dyno due to the accuracy of readings and ability to safely vary the operating point of the engine.
+- Laptop with TunerStudio, MegaLog Viewer and optionally Virtual Dyno installed.
+
+## Initial TunerStudio Configuration
+
 Open TunerStudio and open the "VVT Configuration and PID" menu under the advanced tab. Going down the settings in this menu first is the activation delay. This is the initial delay when the car is started before the VVT is enabled. A setting of 1000-5000ms (1-5s) should be suitable here to give the engine enough time to build oil pressure before enabling the VVT.
 
 The "Do not control below RPM" setting or activation RPM disables VVT until the engine RPM exceeds this value. Ideally set it about at 100-200 RPM or so above your idle RPM to keep it disabled during idle. This will simplify the idle tuning as the engine torque from the VVT changing can lead to a fluctuating idle.
 
 For the VVT solenoid banks, an NB2 motor only has VVT on the intake so select the pin labelled as "VVT" for the "VVT solenoid bank 1 intake" setting.
 
-On the right side of the menu are the PID control options. If you are new to PID tuning, plenty of guides exist detailing how it works. This video by RCModelReviews details how PIDs work on a basic level.
+On the right side of the menu are the PID control options. If you are new to PID tuning, plenty of guides exist detailing how it works. [This video by RCModelReviews](https://youtu.be/0vqWyramGy8?si=oALUmrArWDNi7Scp) details how PIDs work on a basic level.
 
 Pictured below are some reasonable default settings however it is still recommended to configure the settings yourself as settings can vary from car to car.
 
+![image](VVT/VVTconfig.png)
+
 ## VVT Offset Setting
 
-Before configuring the VVT PID, the basic VVT angle offset needs to be configured. This is to calibrate what the ECU thinks is 0 degrees VVT angle to the actual VVT angle on the car, similar to setting the base timing. This is different to the offset in the PID control menu.  Open the "Trigger" menu under the "Base Engine" tab and locate the "VVT offset bank 1 intake(value)" setting. In the engine bay, unplug the VVT solenoid highlighted in the image below:
+Before configuring the VVT PID, the basic VVT angle offset needs to be configured. This is to calibrate what the ECU thinks is 0 degrees VVT angle to the actual VVT angle on the car, similar to setting the base timing. **This is different to the offset in the PID control menu**.  Open the "Trigger" menu under the "Base Engine" tab and locate the "VVT offset bank 1 intake(value)" setting. In the engine bay, unplug the VVT solenoid highlighted in the image below:
+
+![image](VVT/VVTsolenoid.png)
 
  Right click one of the gauges on the background of TunerStudio and under VVT, change it to "VVT bank 1 intake vvtPositionB1IGauge". This will show a live reading of the detected VVT position on the car. 
 
 Start the car with the solenoid unplugged and read the VVT position on the gauge. Change the "VVT offset bank 1 intake(value)" setting until the VVT position reads 0. The VVT angle is now calibrated and you can shut off the car and plug the solenoid back in. Your offset should be similar to that shown below:
 
+![image](VVT/VVTtrigger.png)
+
 ## PID Tuning VVT Settings
 
 Under the PID settings the offset is the VVT solenoid duty cycle offset. Basically, the solenoid will only activate if it is pulsed above a threshold duty cycle and the PID controller needs to know what duty cycle this occurs. PID tuning can be a tedious process and it is recommended to outsource it to a professional if you are not confident.
 
 To tune the offset, open the "VVT Closed Loop Target" table and set every cell to a constant value such as 10 degrees. Set the P gain to 1. Right click one of the gauges on the background of TS and under VVT, change it to "VVT bank 1 intake - vvtPositionB1IGauge". This will show a live reading of the detected VVT position on the car.
 
+![image](VVT/VVTgauge.png)
+
 Start with an offset value of e.g. 10. Start the car and hold the engine RPM at a constant value above the threshold RPM and observe the VVT position gauge. If the gauge does not change, increase the offset by 5-10 and repeat until you find the minimum offset required for the gauge to change VVT position. Note that the actual VVT position won't be correct yet as the PID controller still needs to be set up. A value in the range of 30-40 is expected.
 
-Next is the PID tuning. This step can take a while and is important to do thoroughly to ensure that the VVT can reach its target angles quickly and without overshooting significantly. The PID tuning is best done on a dyno or with a mate to drive the car whilst you tune it. Alternatively you can take a driving datalog, analyse it in MegaLogViewer, revise the PID settings and take another driving log. This method would be very time consuming and the first two are recommended.
+Next is the PID tuning. This step can take a while and is important to do thoroughly to ensure that the VVT can reach its target angles quickly and without overshooting significantly. The PID tuning is best done on a dyno or with a mate to drive the car whilst you tune it. Alternatively you can take a driving datalog, analyze it in MegaLogViewer, revise the PID settings and take another driving log. This method would be very time consuming and the first two are recommended.
 
 To tune the P, I, and D settings you can either start from scratch or work from other users values to refine them. Below are some PID values you can work from if you wish. The process of tuning the PIDs is to put various angle targets in the VVT intake target table at different engine loads and RPM and to move the engine around between them. As the VVT target changes, the PID loop will activate to attempt to reach the new target. By watching the response of how quickly and with how much overshoot the controller reaches the target, the PID controller can be tuned. 
 
 An example on the dyno this might look like having all VVT target cells below 1500 RPM at 0 and above that at 20 degrees. In the "diagnostics and high speed loggers" tab you can set one graph to be the VVT position and the other as the VVT target as shown below:
 
-Next, rev and hold the engine up to e.g. 2000 RPM and watch how quickly the VVT position rises to match the VVT target. If the position overshoots, decrease P or increase D, vice versa if it undershoots. If the position slowly drifts from 20 degrees, you would increase the I gain. The PID settings would be varied until the VVT position quickly rises or falls to and VVT target changes without much over or undershoot. To properly optimise the PID tune, it is recommended to repeat a similar tuning process with lots of VVT angles.
+![image](VVT/VVTlogger.png)
+
+Next, rev and hold the engine up to e.g. 2000 RPM and watch how quickly the VVT position rises to match the VVT target. If the position overshoots, decrease P or increase D, vice versa if it undershoots. If the position slowly drifts from 20 degrees, you would increase the I gain. The PID settings would be varied until the VVT position quickly rises or falls to and VVT target changes without much over or undershoot. To properly optimize the PID tune, it is recommended to repeat a similar tuning process with lots of VVT angles.
 
 Once the VVT is PID tuned, the VVT target table can be tuned.
 
@@ -48,11 +60,15 @@ Once the VVT is PID tuned, the VVT target table can be tuned.
 
 Tuning the VVT angle is where the power gains are made. At this point the VVT should be fully set up and PID tuned to quickly reach the target position. If you cannot be bothered tuning the VVT angle, copying another users settings may yield decent results provided they have done the proper tuning however there will always be slight variances from car to car. A reasonable target table example is shown below:
 
+![image](VVT/VVTangle.png)
+
 The target angle is tuned in two sections, ramp run tuning and steady state tuning. Ramp runs are used to tune the VVT at maximum throttle and steady state tuning is used to tune the angles for partial throttle applications when the engine isn't fully loaded. This tuning is best done on a dyno for the best accuracy.
 
 To tune the ramp run, set the entire VVT target table to 0 and perform a run. Save this run and do another, this time incrementing the whole VVT target table angle by 5-10 degrees depending how many dyno pulls you want to do. Repeat this process until the maximum VVT angle of 44 degrees is reached. Now load up all of the dyno runs and overlay them on top of each other. There will be points across these graphs where the torque from one VVT angle rises above the others. Power can be used as well but it is easier to do the tuning using the torque plots. For a given RPM range, take the VVT angle with the highest torque and put that into the maximum load section of the VVT target table. Repeat this for every RPM range where a different VVT angle yields a higher engine torque until the maximum load row of the table is populated. An example ramp run dyno graph is shown below where there are several "dyno runs" at different VVT angles. The yellow lines indicate the crossover points where a certain VVT angle has the most torque. Simply set the highest torque producing VVT angle in the chart for a given RPM range to that in the target table.
 
-If you have some way of maintaining a constant throttle position below 100% such as a chock under the pedal (on the dyno only!!!) or limiting the maximum throttle body travel, ramp runs can be used to efficiently populate the whole VVT table for conditions where the engine isn't fully loaded.
+![image](VVT/VVTtuning.png)
+
+If you have some way of maintaining a constant throttle position below 100% such as a chock under the pedal (**on the dyno only!!!**) or limiting the maximum throttle body travel, ramp runs can be used to efficiently populate the whole VVT table for conditions where the engine isn't fully loaded.
 
 To steady state tune on a dyno, the dyno will hold the engine at a specific RPM and load so you can vary the VVT angle in real time to see which angle has the highest torque. You then move to another cell and repeat this to tune the lower engine load sections of the VVT target table. To save time, it is possible go along a row tuning every second cell then interpolating between them. The downsides to steady state tuning is the higher load and RPM will quickly heat up the engine so it is crucial to monitor the temperature. This method also takes quite a lot of time but will yield precise results as the angle can be varied in small increments as the torque is measured instantaneously. 
 

docs/11-Vehicle-Specific/Mazda-MX5-Miata/NA6-Grounding.md

@@ -8,6 +8,12 @@ Grounding sensors directly to the ECU rather than the chassis provides numerous
 
 There is a stud coming off the intake manifold below the fuel rail, holding a P clamp for the wire harness with a connector to the Cam Angle Sensor. This is where a pair of grounds meet on a round ring terminal: one being a chassis ground (black), the other being an ECU ground (black and green). The black and green wire must be cut from this ring terminal and isolated. The location of this wire is shown in the images below:
 
+![image](<NA6 ECU Gnding/Picture1.png>)
+
+![image](<NA6 ECU Gnding/Picture2.png>)
+
+![image](<NA6 ECU Gnding/Picture3.png>)
+
 Note: If your car's ground is different due to modifications, follow the harness from the passenger side firewall to the cam angle sensor, and the pair of grounds may have been relocated to another location. See the NA6 wiring diagram at the end of this guide for further information.
 
 ## Benefits
@@ -23,3 +29,7 @@ Maintaining Factory ECU Grounding: Factory ECU ground connections to the chassis
 ## NA6 Wiring
 
 If you are having difficulties tracing the correct wires to isolate, the wiring diagram below highlights the black and green ground wire and where it connects to on the car. By cutting the black and green wire from the engine block, you can see that the crank angle sensor is only wired to the ground on the ECU.
+
+![image](<NA6 ECU Gnding/Picture4.png>)
+
+![image](<NA6 ECU Gnding/Picture5.png>)