NABU How-To & Repair Guide

[tastypies]

I've started putting together an 'unofficial' NABU How-To guide that aims to capture some of the information shared on this forum in the hope that it's useful to new (and perhaps also experienced) users.

Feel free to contribute/point out errors/make suggestions/etc - the document sources are in github (https://github.com/dimitrit/nabu-howto), but for your convenience and delectation, the latest version of the document is also attached to this post.

Enjoy!
D.

[Edited to include latest version of the guide]

[DJ Sures]

Noice - can you adjust the cable instructions to specify that it is RS422 standard to use Twisted Pair (i.e., repurpose a network cable)? If no twisted pair is available, the RS422 portion should be as short as possible and shielded on only one side (PC or NABU, not both) to avoid a ground loop.

[productiondave]

Only other suggestion I have is to pin the latest version to the front post in the topic. Which is my post. So that won't work.

Maybe this gets moved to a more appropriate topic where the latest version can be tracked easily.

[tastypies]

Updated version, which emphasises the need for twisted-pair RS-422 cable, attached.

Not sure how to make a forum post 'sticky' - perhaps the document could be included in the 'quiver' on the website instead?

D.


[Latest version of the guide attached to first post]

[productiondave]

An even better idea!

[DJ Sures]

the thread has been sticky since u created it That's something leo and I can do. I would happily put it on the quiver! Let me know when you're good to go. Get some more feedback and ideas of what can be added

maybe how to wire the keyboard emulator? Since it looks like several nabus are being sold without keyboards

[productiondave]

I was confused with the other topic over in forum suggestions and project ideas. Maybe that one can be sent on a trip to Belize?

[superbenk]

What's the plan to keep this up to date, though? Wouldn't having this in a wiki or something make more sense than a PDF?

[tastypies]

What's the plan to keep this up to date, though? Wouldn't having this in a wiki or something make more sense than a PDF?

The LaTeX sources for the document are in github. Because LaTeX is essentially 'plain-text' it is simple to work with and easy to version, etc. And depending on your toolchain you could generate output in pretty much any format, but I personally like PDF - easy to read, easy to search, easy to share, etc., etc.

Anyways, a new version of the document with keyboard cable instructions is attached - note I haven't actually made one of these, so perhaps someone could double check the instructions and let me know if anything needs correcting or clarification.

Enjoy,
D.


[Latest version of the guide attached to first post]

[superbenk]

What's the plan to keep this up to date, though? Wouldn't having this in a wiki or something make more sense than a PDF?

The LaTeX sources for the document are in github. Because LaTeX is essentially 'plain-text' it is simple to work with and easy to version, etc. And depending on your toolchain you could generate output in pretty much any format, but I personally like PDF - easy to read, easy to search, easy to share, etc., etc.

Anyways, a new version of the document with keyboard cable instructions is attached - note I haven't actually made one of these, so perhaps someone could double check the instructions and let me know if anything needs correcting or clarification.

Enjoy,
D.

Ah! I didn't realize it was in LaTeX. I must have missed that. Carry on!