improve readme

This commit is contained in:
dekunukem
2017-12-19 14:25:21 +00:00
parent 632aa357c4
commit b4a3df82b6
2 changed files with 21 additions and 3 deletions

View File

@@ -6,6 +6,24 @@ Since I have already sold a few exixe modules, here is a short introduction on h
You should first wire it up and test to see if the board is working before soldering on the nixie tubes.
First take a look at the pinout above, connect the GND to GND, and 3.3V power to 3V3. If you turn it on at this stage the LED should be faintly on, and nothing else should happen.
First take a look at the pinout in [technical_details.md](/technical_details.md), connect the GND to GND, and 3.3V power to 3V3. If you turn it on at this stage the LED should be faintly on, and nothing else should happen.
Then let's connect the SPI lines. Connect MO to MOSI line, SCK to SCK line, and CS to CS line. MISO is not used so you can leave it off. Leave HV pin unconnected for now as well. If you are unfamiliar with SPI, or need a refresher, [sparkfun's introduction](https://learn.sparkfun.com/tutorials/serial-peripheral-interface-spi) is really helpful, and [the wikipedia page has more details](https://en.wikipedia.org/wiki/Serial_Peripheral_Interface_Bus).
Then let's connect the SPI lines. Connect MO on the to MOSI line, SCK to SCK line, and CS to CS line. For Arduino Uno, MOSI is pin 11, SCK is pin 13, CS is pin 10. Consult the pinout page if you're using other boards.
MISO is not used so you can leave it off. Leave HV pin unconnected for now as well.
If you are unfamiliar with SPI, or need a refresher, [sparkfun's introduction](https://learn.sparkfun.com/tutorials/serial-peripheral-interface-spi) is really helpful, and [the wikipedia page](https://en.wikipedia.org/wiki/Serial_Peripheral_Interface_Bus) has more details.
Now you can go through the [provided Arduino examples](/arduino_examples). Try the [LED test](/arduino_examples/0_LED_test) first. Compile and upload the sketch, the LED on the exixe module should turn purple. You can play around with the RGB values in the sketch to change it to other colors.
Once you're happy with the LED, you can try hooking up a Nixie tube to the module. Always test your tubes first before soldering them to the module. You can do that by connecting the anode to +180V through a 68K resistor and touch each cathode with GND and see if the corresponding digit lights up.
I suggest buying a premade miniature high voltage power supply to Nixie tubes like [this one](https://www.ebay.com/itm/DC-5V-12V-to-170V-DC-High-Voltage-NIXIE-Power-Supply-Module-PSU-NIXIE-TUBE-ERA-/322511957768?hash=item4b1735ef08:g:ftQAAOSwYTVZmjZb), they are not that expensive, pretty efficient, runs on 5V, and saves tons of trouble of designing one yourself. Just search "5V nixie power supply" on ebay.
Needless to say the high voltage needed to drive Nixie tubes is dangerous. Those high voltage modules above probably won't generate enough current to kill you, but you do feel a tingle if your finger is dry, and a rather nasty shock if it's damp, so do watch out where you put your fingers.
After you're sure the tube is good, you can solder it to the module. Look at the pinout in [technical_details.md](/technical_details.md), and double check the pins are in the right hole, the anode pin should be in the anode hole, and the rest of them lined up properly.
Once after that's done, connect the 180V output of the supply to the HV pin of exixe module, make sure your Arduino, high voltage supply, and exixe module all share the same GND, and try the [show_digit4](/arduino_examples/1_show_digit4) and [show_all_digits](/arduino_examples/2_show_all_digits) example next. The first one just shows the digit 4, and the second one loops through all the digits from 0 to 9.
That's pretty much it! You can let your imagination run free now. You can probably adapt the functions in [show_all_digits](/arduino_examples/2_show_all_digits) for more complex display routines, or write some fancy crossfade transitions, whatever you want to.

View File

@@ -48,7 +48,7 @@ Detailed timing for the first byte:
* Pinout and dimension are the same for exixe-12 and exixe-14.
* Officially, exixe modules are NOT 5V compatible, all signals are 3.3V level.
* However it does seem to work with 5V Arduinos with no short term damage. Anyway, I suggest using 3.3V Arduinos, or put a 4.7K resistor in series to limit current.
* However it does seem to work with 5V Arduinos without short term damage. Anyway, I suggest using 3.3V Arduinos, or putting a 4.7K resistor in series to limit current.
* Still, the module itself must be powered at 3.3V.
* When assembling insert the Nixie tube so its anode lead is in the anode hole, and TEST THE TUBE BEFORE SOLDERING it in place.