Hello,
I'm going to post this a bit earlier than I thought, but I was
pretty sure of how well it worked so I decided that it would be
released a bit sooner (and also at Paul Guyot's request =)
<start README>
-----
README for newton_connection_library
-----
To build this on a little endian machine, type:
make "ENDIANNESS=-DLITTLE_ENDIAN -UBIG_ENDIAN" all
(Little endian is x86)
To build this on a big endian machine, type:
make all
(Big endian is ppc, m68k) (yeah, I have macs...)
It should compile on Linux. It *might* compile on Mac OS X.
I'll be damned if it compiles on Windows.
I ought to automate this. Can anyone tell me how the f*** to use
the auto* tools!?
To try it out:
cd test
make
./test
will build a test program that uses the library and listens on
port 49252 for a connection from a newton (you did load
DockTrnspTCPIP.pkg onto your newton, right?) The test
program does nothing more than try to load a package
to your newton, but it doesn't work (Connection error -4).
Any ideas on that would be appreciated! It does, however,
print out the exchange of packets.
-----
ABOUT
-----
This library is useful for encoding/decoding newton dock packets.
It does NOT implement MNP, so it won't work as a serial connection
tool. It *might* work over IrDA, but I haven't tried. It does
work over TCP/IP, i.e. the Internet.
This library is implemented as a static C library; however, the
hooks are in place for C++ so I think it will work there too.
Another closely related library I am working on is a Newton Streamed
Object Decoder/Encoder. It it about half done (decoding is almost
complete, and encoding is ~25% done).
Send mail to <anrp_at_irulethe.net> to encourage further development!
Also send bug reports, feature requests, flames, etc... I just
would like to know how many people would use it.
-----
USAGE
-----
Basic Rules:
free_newton_packet(thePacket) after read_newton_packet_* or create_newton_packet*
*and* you're done with the packet (same for below)
free_newton_binary_packet(theBPacket) after read_newton_binary_packet_* or
create_newton_binary_packet*
...unless you want a 'leaky' program.
Read the headers. They're pretty helpful. It's really quite simple. But I would
appreciate anyone using the library to contribute some documentation!
-----
AUTHORS
-----
Andrew Patrikalakis <anrp_at_irulethe.net>
(hopefully more people will be added to this list)
-----
THANKS
-----
SONiC RANGE for hours of listening enjoyment
-----
VERSION HISTORY
-----
12:02 AM EST Sunday April 21, 2002
- Initial release.
<end README>
Ultimately, it might turn into a Newton Connection Utilities
replacement that works over TCP/IP! (forget about network
devices that drop AppleTalk packets! nobody drops TCP/IP!)
It's at http://anrp.irulethe.net/newt/ - and it's FREE (i.e. GPL free).
Enjoy,
Andrew Patrikalakis
-- Read the List FAQ/Etiquette: http://www.newtontalk.net/faq.html Read the Newton FAQ: http://www.guns-media.com/mirrors/newton/faq/ This is the NewtonTalk mailing list - http://www.newtontalk.net
This archive was generated by hypermail 2.1.2 : Sun May 05 2002 - 14:04:35 EDT