initial
[Netio230B.git] / README.md
1 # Netio230B - Control your NETIO-230B PDU with perl
2
3 ## INSTALLATION
4
5 To install this module, run the following commands:
6
7         perl Makefile.PL
8         make
9         make install
10
11
12 ## SYNOPSIS
13
14     use Netio230B;
15     use Data::Dumper;
16
17     my $foo = Netio230B->new(device => "192.168.1.22",
18                              username => "admin",
19                              password => "admin");
20     # get port states
21     my @allports = $foo->get_device_configuration();
22     print Dumper(@allports);
23
24 ## DESCRIPTION
25
26 The Netio230B is a power distribution unit which can be controled via LAN
27 see http://www.koukaam.se/showproduct.php?article_id=1502
28
29 ### REMARKS
30
31 This module was build and tested against the firmware version 3.12 of the
32 Netio230B device. This firmware seems to contain some bugs which manifest in
33 hanging requests and sometimes requests which do not hang but return an empty
34 result. Those issues are "handled" using a timeout for the requests
35 and sending the request again and again (max 10 times).
36
37 Since I upgraded to version 4.1 (which in it self was a PITA, you have to to
38 it with Internet Explorer or it will fail...) I have not seen this behavior 
39 again. 
40
41 ### AUTHENTICATION
42
43 At the moment only open authentication method supported.