Title: mcHF deutsche Dokumentation/eigene mcHF
Post by: dl2kuh on 30. October 2015, 20:27:11
Hallo mcHF Freunde,
hat jemand eine deutsche Dokumentation oder angefangen eignen Benutzungs-Notizen in deutsch aufzuschreiben, die er gern teilen möchte.
Ich suche sie für OM´s (prima HW-Bauer) des nicht unbedingt englisch super-mächtigen Semesters.
Von Yahoo die KA7OEI Manuals haben wir.
73 Hagen DL2KUH |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 31. October 2015, 07:18:36
Bis auf dass ich gerade ein Buch schreibe, in dem diese Infos auch drin sind, denke ich nicht. Aber das Buch umfasst auch Messtabellen, Fehlersuchbäume etc. und erscheint erst zweite Novemberhälfte. Das dürfte für die meisten aber rechtzeitig genug sein, da sich die Lage auf dem "Teilemarkt" wohl erst dann entspannt haben wird...
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DG8WM on 04. November 2015, 11:45:38
Hallo Andreas,
ich bin schon gespannt auf das Buch. Wo wird es denn erhältlich sein?
|
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 04. November 2015, 12:49:04
Überall wo es Bücher gibt. Es wird eine ISBN-Nummer haben und damit sowohl im örtlichen Handel als auch im Internet zu bekommen sein. Im örtlichen Handel mit Sicherheit nicht am Lager - nur auf Bestellung. Geht aber kurzfristig (wenige Tage), da es in "book-on-demand" aufgelegt wird.
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: dk9he on 05. November 2015, 19:36:42
Hallo Andreas,
das Buch ist schon auf meiner "must have Liste", ich bin gespannt.
Da ich zurzeit noch bei der "Beschaffung" bin und vermutlich Ende des
Monats mit dem bauen starten werde, passt der voraussichtliche Veröffentlichungstermin für mich perfekt :)
73
Andreas DK9HE
(2. Projektgruppe) |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DO7JCM on 26. November 2015, 17:36:09
Hallo Andreas,
wie weit ist Dein Buch zum mcHF gediegen und sind darin evtl. auch deutschsprachige Hinweise zu den einzelnen Menüpunkten .
Gruß
Christian
DO7JCM
Übrigens habe ich gerade ein Gehäuse im Bau, auf der Grundlage von TARGET-Entwürfen. Falls Interesse besteht werde ich mal ein paar Fotos hier einspielen. |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 26. November 2015, 18:11:16
Natürlich wird auch das gesamte Menü incl. den Abgleichanweisungen darin enthalten sein - auf DEUTSCH.
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: dl2kuh on 27. November 2015, 16:21:12
Hallo Christian DO7JCM
Übrigens habe ich gerade ein Gehäuse im Bau, auf der Grundlage von TARGET-Entwürfen. Falls Interesse besteht werde ich mal ein paar Fotos hier einspielen.
|
|
Ja bitte Fotos .....am besten unter dem Topic Gehäuse veröffentlichen.
73 DL2KUH Hagen |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: dl2kuh on 02. December 2015, 21:06:37
Hallo Andreas,
wie stehts um die Veröffentlichung Deines Buches?
73 Hagen DL2KUH |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 03. December 2015, 07:34:09
Bin immer noch dran :) Aber hier wird es als erstes angekündigt, wenn es verfügbar ist!
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DJ9SN on 22. December 2015, 19:57:12
Hallo Andreas,
nach ich mit dem Bau dem mcHF fertig bin, fehlen die Einstellungen der vielen Parameter.
Das englische Handbuch ..... hm , dessen bin ich in meinem Alter nicht mächtig.
Erscheint Dein Buch noch dieses Jahr oder wann kann ich damit rechnen ?
73 Bernd DJ9SN |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 23. December 2015, 08:40:14
Dieses Jahr leider nicht mehr. Ich mache auch keine Terminzusagen mehr - nur soviel: SO SCHNELL WIE ICH KANN...
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DM5AF on 18. February 2016, 23:13:22
Hallo,
ich frag einfach mal: Ist Dein Buch noch ein Thema oder R.I.P. ?
73 Andreas ;D 8) |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 19. February 2016, 07:22:01
st noch ein Thema. Rund 250 Seiten sind schon fertig.
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: HB9ocq on 19. February 2016, 09:27:48
ich freue mich wie ein kleines Kind an Weihnachten, dass solch ein Buch in Arbeit ist!
Wenn ich etwas anmerken darf: betrachtet man allerlei Publikationen zu uC/MCU basierten (DIY-)Hardwaren, so stoesst mir ganz fest auf dass jeweils die FW/SW sehr -nein, ich meine WIRKLICH SEHR!!! stiefmütterlich abgehandelt wird.
Was fuer HW selbstverstaendlich ist: da werden (hierarchische)Blockschaltbilder, Konzeptdiagramme, Gesamtschaltbilder und Teilschaltbilder auch mit Hilfsschaltungen, BOMs, Layouts jeder Ebene, Bestueckungsdrucke, Modifikationsfotos, Abgleichtabellen u.v.m. plus Prosabeschreibungen dargereicht.
Bei der zugehoerigen FW/SW heisst es dann in wenigen Absaetzen lapidar "...Quellcode von URL runterladen. Punkt."
Ich wuensche mir dass endlich der Dokumentationsumfang fuer die FW/SW solcher uC/MCU basierten "Bausaetze" groesser wird.
Ich meine damit nicht dass blind alles was Doxygen unqualifiziert ausspukt einfach zu PDF/Papier gebracht wird.
Aber Konzeptskizzen + Uebersichtsdiagramme von Paketabhaengigkeiten (nicht nur externe Pakete!), interne API-Referenzdoku, Ablauf- u. Sequenzdiagramme, Diagramme/Tabellen von Zustandsautomaten, Auszuege von (essentiellen, kritischen) Quellcode u.v.m. auch dazukommen.
In meinem AFU-Verein sage ich jeweils den Kollegen: "vergisst das Loeten, das geht dann einfach. Lernt das Programmieren: immer mehr ist SW Matchentscheidend!"
Wie will man Leute auch in den SW Bereich nachziehen, wenn da laufend alles "versteckt" rumgereicht wird?
- - -
OT, gehoert aber dazu:
Ich selbst bin Beruflich "schizophren": Berufslehre als Elektroniker, Fachhochsulabschluss auf Software, mittlerweile ueber 2 1/2 Jahrzehnte Berufserfahrung wobei ich auch gut 3 Handvoll Mitarbeiter eingearbeitet habe.
Ich kann auf beiden Seiten unagenehme Fragen stellen UND beantworten.
Leider muss ich der SW Branche schlechte Noten erteilen: kaum ein Chef stuetzt systematisch gute SW-Dokumentation (solange das Word-"Dokument" mehr Seiten hat als er zw. 2 Meetings blaettern kann ist er zufrieden, egal ob was drin steht Dokumentarischen -somit nutzbringenden- Wert hat)
Auch was die Standarisierung angeht hat die SW ggue. HW (El. u. Mech.) noch ganz viel aufzuholen. Mein Vergleichsbeispiel: ich komme mir vor als wuerde SW immer noch wie vor H. Maudslay[1] gemacht. Vor ihm kaufte man Schraube und Mutter immer paarweise einzeln aufeinander abgestimmt weil wg. Handfertigung eine Normierung der Gewinde noch gar nicht moeglich war. Erst durch Maudslays Fortschritte konnten Muttern und Schrauben unabhaengig in Massen nach Norm gefertigt werden und jede Mutter passte auf jede Schraube derselben Nenngroesse.
Toent lustig, ist aber traurigster SW-Alltag.
Und nein: Standards in SW werden nicht durch ellenbogelig draengelnden Closed-Source-Patenthortende-Konzerne gesetzt. Standards kommen aus unabhaengigen Normungsgremien und Quelloffenen Implementationen werden als Beispiel gereicht. POSIX, W3C usw. lassen Gruessen.
[1] https://de.wikipedia.org/wiki/Henry_Maudslay (https://de.wikipedia.org/wiki/Henry_Maudslay) |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 19. February 2016, 09:40:02
Hallo Stephan,
in Dokumentationen der Art, wie Du sie Dir vorstellst, steckt eine gewaltige Manpower. Da diese Dinge nirgendwo dokumentiert sind (und jeder FW-Coder den Teil den er für sich und seine Programmierarbeit braucht, selbst erforscht) müsste man das praktisch von NULL an aufarbeiten.
Das ist sicher möglich. Was spricht dagegen?
- solch eine Dokumentation interessiert nach meiner Vermutung nur wenige Leser
- der Umfang des Buches dürfte sich dadurch mehr als verdoppeln
- der Preis des Buches würde sich mindestens verfünffachen
- der Erscheinungstermin wäre frühestens Ende 2016
- es ist rechtliche Grauzone, da jedwede kommerzielle Nutzung des Projektes gemäß der CC verboten ist (ist das schon kommerzielle Nutzung?)
In einem gewissen (aber sehr kleinen Umfang) wird auch auf die Firmware und den Bootloader eingegangen. Aber aus Sicht eines Funkamateurs - nicht aus Sicht eines Mikrokontroller-Programmierers.
Der derzeitig anvisierte Erscheinungstermin ist ASAP, und der Preis soll unter 40,-- Euro incl. Versand liegen. Eine Möglichkeit der Updates (kostenlos) online soll/wird es auch geben.
Über eine Diskussion, ob ich mit meinen Vermutungen richtig liege, würde ich mich sehr freuen, denn das Buch wird für EUCH geschrieben...
vy 73
Andreas
|
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: HB9ocq on 19. February 2016, 11:41:40
in Dokumentationen der Art, wie Du sie Dir vorstellst, steckt eine gewaltige Manpower.
|
|
Sicher, in der HW-Doku auch.
Da diese Dinge nirgendwo dokumentiert sind (und jeder FW-Coder den Teil den er für sich und seine Programmierarbeit braucht, selbst erforscht) müsste man das praktisch von NULL an aufarbeiten.
|
|
Fuer Schema (pdf) und Layout(-) ditto.
Ich bin nicht CAE erfahren, aber das Schema PDF liest ja wohl kaum eine SW ein -> von Hand nachzeichnen.
Das ist sicher möglich. Was spricht dagegen?
|
|
Ich moechte nicht provozieren, aber mir liegt der Spruch auf den lippen dass dies aehnlich den in der mcHF-Yahoo-Gruppe formulierten "Unmoeglichkeiten" toent. (ich bin bei Yahoo nicht angemeldet: nach mehreren Fehlversuche komme ich zum Schluss dass ich zu Dumm bin jene Website zu bedienen - sorry)
Der derzeitig anvisierte Erscheinungstermin ist ASAP, und der Preis soll unter 40,-- Euro incl. Versand liegen. Eine Möglichkeit der Updates (kostenlos) online soll/wird es auch geben.
Über eine Diskussion, ob ich mit meinen Vermutungen richtig liege, würde ich mich sehr freuen, denn das Buch wird für EUCH geschrieben...
|
|
- - -
<reset RantMode=civilian; addon=friendliness,smileys>
Ich habe meinem Wunsch bewusst abstrakt formuliert, ich freue mich auf die Diskussion und will sie nicht zwingend auf DIESES Buch fokussiert fuehren/verstanden haben.
DIESES Buch wird Dein Werk und ich wage mich nicht es zu kritisieren bevor ich es nicht selbst zu sehen bekomme.
Danke fuer's Eintreten in die Diskussion.
Zur Sache:
Wenn Titel/Einleitung/Klappentext die Erwartungen genau umreissen und nicht beim Leser vor dem Kaufentscheid Fantasien triggern dann stimmt alles.
Terminlich kann man auch 2/beliebig weitere Buecher machen.
Zielpublikum (Mengenmaessig) und CC-Lizenzmaessig kann man das Dokument auch nur in PDF (ohne DRM) o.Ae. ausgeben. Beliebige Musterloesung f. technische Umsetzung z.B.: FreeBSD Handbook[1] u.v.A. (nein, ich nutze im Moment kein BSD)
Wegen dem Finanziellen Aspekt "CC <-> (ist das schon kommerzielle Nutzung?)" ist meine Meinung -but IANAL- dass wenn vom Erloes ein wesentlicher Teil an Freizeitvereine O.F.I. und/oder auch an den/die Urspr. Autoren geht, so sollte dies sich per Vereinbarung regeln lassen.
Chris M0nka duerfte in bester UK-Tradition fuer ein Gentlemen Agreement offen sein - nicht wie das US-angehauchte Arduino Debakel.
Der kostenguenstige Druck in einer Druckerei ggue. dem Heimischen langsamdrucker ist vergleichbar wie die PCB-Fertigung resp. seit neuem die Teilbestueckung die M0nka auch professionell=kommerziell machen laesst.
Fuer diese Arbeit bezahlt man halt.
Die Zugaenglichkeit der Grundinfomation ist essentiell.
Wie Chris M0nka selbst vor ~2 Jahre zum Schema schrieb[2], "re-hashing of common knowledge, so no license".
Dies trifft doch ebenso auf Quellcodemuster (Design Patterns) zu.
Der geneigte Leser wird in Schaltungsbeschreibungen auch durch die Funktionsbloecke gefuehrt, wo mit passenden Diagrammen die Prosa verbildlicht wird.
Meine allgemeine Kritik ist einfach dass obwohl die SW in uc/MCU basierten Projekten "ueberwichtig" ist, dies kaum je in der Doku in angemessenem Umfang zum Ausdruck kommt, insbesondere nicht im direkten Vergleich mit der HW-Seite.
Mit anderen Worten: dem HW-Neuling wird staendig alte und neue grundlagenartige Information unter die Nase gerieben sodass er in den Genuss eines Lehrneffektes oder zumindest einer Wissensvermehrung kommt.
SW-seitig hinkt dies eben schlicht hintennach, Mengen- wie Qualitaetsmaessig.
"Man" wundert sich dann warum soviel schlechte SW geschrieben wird oder gewisse Vorhaben als "unmoeglich/Ende der Fahnenstange" abgetan werden. *wink mit dem Yahoo-Gruppen-Zaunpfahl*
Ich finde daran krankt zumindest ein Teil der Nachwuchsrekrutierung (hier altersunabhaengig gemeint).
Wenn solch ein Buch gedacht ist fuer eine gut qualifizierte und ambitionierte Leserschaft -das sind OMs, die haben fuer eine Pruefung gebueffelt- dann soll es doch tiefer gehen als ein Fotobildband des Aufbauvorgang, mehr bieten als ein "Quick Start Guide" (wo muss ich was einstoepseln) und mehr als eine Bildschimfotosammlung mit roten Kreise wo zu clicken ist. Die eben aufgezaehlten Aspekte will ich nicht kleinreden weil es die auch braucht (egal ob im selben Dokument oder nicht).
Aber eben eine sinn-/massvoll Strukturierte/Detaillierte Einfuehrung in Funktions und Bedienkonzepte, die Darlegung der zugrundeliegenden Entwurfs-/Implementationsprinzipien und solches wird auch von Profis (ich nenne da mal Elektor, da kommt immerhin der Quellcode daher, ander als z.B. bei ELV) leider im Ungleichgewicht HW<->SW ausgefuehrt.
Die echten Blaupausen bis ins letzte Detail liegen ohnehin (hoffentlich vollstaendig) auf GitHub, in ein Buch gehoeren die ziemlich sicher nicht.
Abkupferer ist der bestehende heutige Zustand eh kein Hindernis: die Rev.Eng-en ohnehin was das Zeugs haelt; darum muessen wir weder zanken noch gross Kraefte verlieren.
Nicht zuletzt werden nur Gute Vorgaben gerne kopiert :)
Andreas: bremse mich ruhig, bevor ich Dir den Kopf schwurbelig "betippe" :)
erstmal "en Guete!" (HB9-Sprech fuer "Mahlzeit!") und bis zur naechsten Runde.
[1] https://www.freebsd.org/doc/handbook/ (https://www.freebsd.org/doc/handbook/)
[2] http://www.m0nka.co.uk/?page_id=16 (http://www.m0nka.co.uk/?page_id=16)
|
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DF8OE on 19. February 2016, 17:24:38
Hallo Stephan,
ich rede jetzt mal nur "vom Buch" und von der Intention, wofür und für wen es sein soll:
es soll ein Nachschlagewerk sein, das man eben den mcHF ins Bücherregal stellen kann. Wo man leicht verständlich nachvollziehen kann, wie das Gerät funktioniert, wie die Signalwege sind, wo man suchen soll, wenn irgendwas nicht funktioniert. Mit Tipps und Kniffen zum Aufbau, zur Diagnose. Mit Aussichten für eine eigene Verbesserung.
Ich sage ganz klar. Mein Hintergedanke ist es hier, mit diesem Buch einen Teil meines Lebensunterhaltes zu verdienen - genau wie ich es mit (fast) allen anderen elektronischen auch tue. Ich bin selbständig und MUSS mir damit meinen Lebensunterhalt verdienen. Und da lege ich andere Maßstäbe an,als wenn ich ein Open-Source-Projekt bebildere.
Wer/was ist meine Zielgruppe?
Wie lange brauche ich, um bestimmte Dinge zu dokumentieren?
Wieviele Bücher verkaufe ich und wie teuer/preiswert dürfen sie sein?
Wenn ich im Lotto gewinne und nicht mehr für meinen täglichen Unterhalt arbeiten müsste, würde ich ganz andere Entscheidungsgrundlagen haben und definitiv anders handeln.
Mit Chris besteht ezüglich des Buches ein Agreement - sonst hätte ich das gar nicht gestartet.
Übrigens habe ich niemals gesagt dass es UNMÖGLICH ist,sowas zu machen (im Gegensatz zu vielen Äußerungen über technische Dinge in der Yahoo-Group). Ich sehe zur Zeit einfach nicht, dass ich die Zeit, die ich in eine Dokumentation der Software stecke, auch nur ansatzweise reell bezahlt bekomme. Erschwerend kommt dazu, dass sich die Firmware im Moment in einer großen Umbruchphase befindet. Was ich jetzt anfange zu dokumentieren, ist bis zum Erscheinen eines Buches definitiv "Schnee von vorgestern". Die Software ist kürzer geworden als zu Cĺints Zeiten, und das, obwohl sie wesentlich mehr Features hat. Das liegt nicht nur an der Compileroptimierung, die jetzt möglich ist, sondern auch an einer "Entwirrung" und Umstrukturierung.
Der Bereich "Software" ist diffiziler zu dokumentieren als der Bereich "Hardware"...
Und jetzt gehe ich mal von mir aus:
Ich würde mir vermutlich keine Dokumentation der Firmware durchlesen, bevor ich anfange, daran herumzuschrauben. Dazu bin ich viel zu tatenhungrig. In der Zeit, die ich brauche, um die Doku zu lesen und zu verstehen, habe ich zahlreiche Funktionen schon eingebaut - weil es nicht nötig ist, den Bauplan des ganzen Gebäudes zu verstehen wenn man nur neue Türen einsetzen will. Verstehe mich aber nicht falsch: Ich finde eine Doku der Firmware auch sehr sinnvoll. Nur sehe ich für die Sichtrichtung, aus der ich das ganze Projekt "Buch" sehe, dafür zur Zeit keinen ausreichenden Platz. Ob sich das durch ein zweites Buch ändern kann / wird, vermag ich nicht zu sagen - noch nicht...
vy 73
Andreas |
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: HB9ocq on 20. February 2016, 21:28:59
Andreas, danke fuer die offene Beschreibung/Klärung der Randbedingungen zum Buch.
|
Title: Re:mcHF deutsche Dokumentation/eigene mcHF
Post by: DO9AH on 22. February 2016, 17:37:32
Hallo Andreas,
ich bin Verlagshersteller im Hauptberuf. Also Organisator bei der Produktion von Büchern und Zeitschriften. Falls du noch keinen Verlag für dein Buch gefunden hast, könnte ich versuchen zu helfen.
Meine E-Mail übermittle ich dir gleich.
73
Andreas |
Diskussions- und Newsboard des DARC-Ortsverbandes I40 | Powered by YaBB SE
© 2001-2003, YaBB SE Dev Team. All Rights Reserved.
|